Directives for Creating Training Files and Trainer Text Files

Breakpoint	Marker Name	Text
Cont At	Menu Options	Textwindow Hints
Display Menu	Nostop Typefile	Unset Window Output
File	Pause	User Input
Graphics Resume	Prompt	User Menu Pick
Graphics Stop	Set Window Output	User Pick
Ignore	Stop Typefile

You must include the open single quote ( ` ) preceding the directive.

Syntax	`breakpoint
Description	Stops the rapid execution of the training file and returns the trainee to single-stepping. Add this directive after the menu selection at which you want to break.

Syntax	`cont_at<label_name>
Description	Causes the training file to skip all commands and statements until the specified label is found. Execution continues from that point on. The argument label_name can point to a label further ahead in the training file, but cannot point back.
Example	`cont_at get_out Transfers training file execution to the label get_out.
See Also	Marker Name

Syntax	`display_menu menu_name
Description	Displays a menu that has already been defined with a `menu_options command. For the item selected, the action specified in the `menu_options command is performed.
Example	`display_menuchoices Displays the menu named choices. It is assumed that the menu has already been defined with the `menu_options command.
See Also	Menu Options

Syntax	`filename
Description	Specifies the trainer's text file to be used with the training file. Only one such file can be specified; subsequent `file commands have no effect. You must enter the full path name only if the text file is not in the same directory (path names can contain up to 260 characters). If there is no path specified with the name, the system searches for the file in the following directories, in order: • The current directory • The directory in which the training file resides • The training directory, if defined in the config.pro file with the TRAIN_PATH_FILE configuration option
Example	`file text.txt The file text.txt is associated with the training file. `file /usr/users/train/text.txt The file text.txt, located in the directory /usr/users/train, is associated with the training file.

Syntax	`graphics_resume
Description	Restores the graphics mode after a `graphics_stop command. If the system does not encounter a previous `graphics_stop command, nothing happens.
See Also	Graphics Stop

Syntax	`graphics_stop
Description	Stops putting new graphics on the screen. This command can be used to conceal a particular sequence of operations from the trainee. You can execute all the commands in the trail file between this directive and `graphics_resume, but they are not displayed on the screen. The geometry that is displayed in the main window is frozen at the point before the command preceding the `graphics_stop directive. The menus are not displayed. When the trail file reaches the directive `graphics_resume, the system resumes normal geometry and menus are displayed.
Example
See Also	Graphics Resume

Syntax	`ignore
Description	Can be used in other commands to replace an action or argument. If an action is replaced, the system does nothing. If an argument is replaced, the system uses a default value.
Example	`menu_options choices continue `ignore `ignore skip `cont_at dome_feature

Syntax	`marker label_name
Description	Defines a label in the training file, which can then be referenced as a target for a jump.
Example	`marker get_out Defines a label called get_out in the training file.
See Also	Cont At

Syntax	`menu_options menu_nameitem 1_name action1 {arg1} {item2_name action2 {arg2}...}
Description	Allows you to define a menu to be displayed to the trainee when running the training file. The argument menu_name is the name by which the menu is identified. The menu can have any number of items. Each item definition must have an action command and an argument, if necessary. You can use `ignore for both actions and arguments. The number of characters in menu_name and any of its items cannot exceed 20.
Example	`menu_options choices quit `cont_at get_out continue `ignore `ignore skip `cont_at dome_feature.
See Also	Marker Name

Syntax	`nostop_typefile
Description	Returns the control of the INFORMATION WINDOW display to Creo Parametric after the ``stop_typefile command. If no previous `stop_typefile command has been encountered, nothing happens.
Example	`nostop_typefile The INFORMATION WINDOW (other than the window with the trainer's text) scrolls quickly.
See Also	Stop Typefile

Syntax	`pause line number
Description	Stops the execution of the training file until you click Resume to continue the execution of the training file again.
Example	`pause 74

Syntax	`prompt number
Description	Displays a prompt message in the Message Window. The number argument is the number of blocks in the trainer's text file.
Example	`prompt 77 Displays the first line of text block number 77 in the associated text file in the Message Window.
See Also	File Text

Syntax	`set_window_output
Description	Restores regular training file operations for message output.
See Also	Unset Window Output

Syntax	`stop_typfile
Description	Passes the control of the INFORMATION WINDOW display to the trainee, providing the ability to page back and forth, and so on. When the training file runs, Creo Parametric information (such as the feature's information and mass properties calculations) is displayed in the INFORMATION WINDOW. If there are multiple pages in the messages in the INFORMATION WINDOW, they scroll by quickly, and there is no time to view them. This directive allows the trainee to control the display. This command does not affect the display of trainer's text. To switch this command off, use the `nostop_typefile command.
See Also	Nostop Typefile

Syntax	`text<number>
Description	Specifies which block of the text file is to be displayed in the INFORMATION WINDOW at a specified interval when running the training file. Add this directive after the menu pick at which you want to break. Any text block can be displayed at any time, in any order. Repetitive block displays are also allowed.
Example	`text 44 Displays text block number 44.

Syntax	`textwindow_hints {px py} {rows cols}
Description	Allows you to change the size and position of the INFORMATION WINDOW with the trainer's text. In the syntax, px and py represent horizontal and vertical positioning of the text window (its lower-left corner), with respect to the main window. The argument rows specifies the number of rows in the text window, and cols specifies the number of columns in the text window. You can omit any pair of parameters, in which case the system defaults are used. (To omit the first pair, replace it with two `ignore commands.) If any parameter is out of range, the system uses the default values. The table Command Parameters lists the system defaults and valid ranges for the parameters.
Example	`textwindow_hints 0.1 0.1 8 80 The INFORMATION WINDOW size will be 8 rows by 80 columns. Its origin will be offset at 0.1, 0.1 with respect to the main window. `textwindow_hints `ignore `ignore 30 70 In this example, only the window size is specified (30 rows by 70 columns). The INFORMATION WINDOW origin will be at the default location.
See Also	Ignore

Syntax	`unset_window_output
Description	Removes the Text INFORMATION WINDOW and diverts all message output to the Message window.
See Also	Set Window Output

Syntax	`user_input keyboard_data {fail} {succ} {giveup} {retries}
Description	Forces the trainee to enter some keyboard data at some point while running the training file. The arguments are as follows: • keyboard_data—The keyboard data line duplicated from the training file. • fail—The message to be displayed if the user fails to enter the expected data. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed. • succ—The message to be displayed if the user succeeds in entering the expected data. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed. • giveup—The message to be displayed if the user fails the maximum allowed number of retries, which is specified by the argument retries. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed. • retries—The maximum number of attempts allowed. If you do not specify this argument, or replace it with ignore, the system uses the default value (5). The `user_input command line is a duplicate, not a replacement, of an existing line with keyboard data in the training file. To compose this command, copy a keyboard data line, and add the `user_input command prefix. Place the command above the actual keyboard data line.
Example	`user_input 0.5 0.5 This example shows the basic `user_input command that uses the default message specifiers. The second line is the actual trail file line. ``user_input 0.5 'text 67 `ignore `ignore 20.5 This example defines the failure message (as the first line of block number 67 in the associated text file), and allows two tries. The second line is the actual trail file line.
See Also	Ignore User Menu Pick User Pick

Syntax

`user_menu_pick command {fail} {succ} {giveup} {retries}

Description

Forces the trainee to perform a menu pick at some point while running the training file.

The arguments are as follows:

• command—The menu command line duplicated from the training file. The # character is retained.

• fail—The message to be displayed if the user fails to make the expected menu pick. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed.

• succ—The message to be displayed if the user succeeds in making the expected menu pick. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed.

• giveup—The message to be displayed if the user fails the maximum allowed number of retries, which is specified by the next argument. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed.

• retries—The maximum number of attempts allowed. If you do not specify this argument, or replace it with ignore, the system uses the default value (5).

The `user_menu_pick command line is a duplicate, not a replacement, of an existing menu pick line in the training file. To compose this command, copy a menu pick line and add the command prefix `user_menu_pick. Place the command above the actual menu pick line.

This function is available for standard Creo Parametric options only, not user-defined options (which are defined using the functions Menu Options and Display Menu).

Example

`user_menu_pick #DIMENSION

#DIMENSION

This example shows the basic `user_menu_pick command that uses all the default message specifiers. The second line is the actual trail file line.

`user_menu_pick #REGENERATE `ignore `text 78`ignore 3 #REGENERATE

This example defines the success message (as the first line of block number 78 in the associated text file), and allows three retries. The second line is the actual trail file line.

Syntax	`user_pick x y b {fail} {succ} {giveup} {retries}
Description	Forces the trainee to perform a graphics pick at some point while running the training file. The arguments are as follows: • x, y, b—The XY coordinates and button code of a pick duplicated from the training file. • fail—The message to be displayed if the user fails to make the expected pick. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed. • succ—The message to be displayed if the user succeeds in making the expected pick. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed. • giveup—The message to be displayed if the user fails the maximum allowed number of retries, which is specified by the next argument. The format is that of a `text command. Only the first line of the specified text block is displayed. If you replace this argument with `ignore, the default message is displayed. • retries—The maximum number of attempts allowed. If you do not specify this argument, or replace it with `ignore, the system uses the default value (5). The `user_pick command line is a duplicate, not a replacement, of an existing pick in the training file. To compose this command, copy a pick line, and add the `user_pick command prefix. Place the command above the actual pick line.
Example	`user_pick 0.427022 0.495110 L 0.427022 0.495110 L This example shows the basic `user_pick command, with all the default message specifiers. The second line is the actual trail file line. `user_pick 0.427022 0.495110 L `text 43 `ignore `ignore 15 0.427022 0.495110 L This example defines the failure message (as the first line of block number 43 in the associated text file), and allows fifteen retries. The second line is the actual trail file line.
See Also	Ignore User Menu Pick