Inst Command
Places an instance of symbolname onto the current schematic. User must press left mouse key to fix the symbol to the schematic.
Inst [/centre] [/select] [/repeat] [/norepeat] [/repeatalways] [/loc <x> <y> <orient>] [/orient] [/comp] [/nolocal] [/useph] <symbolname> [propname] [propvalue]
Parameters
|
/centre |
If specified the cursor will be positioned in the centre of the selected schematic window. Otherwise the cursor will remain at whatever position it happens to occupy when the command is executed. |
|
/comp |
Places a component symbol whose path is specified by symbolname . |
|
/loc |
If specified, instance is placed directly on sheet without user interaction at the location specified by x and y and orientation specified by orient . These values are relative. The origin of the schematic is not fixed. Usually the values used would have been returned from a call to the function InstPoints . |
|
/nolocal |
Only effective if /comp also specified. Forces reloading of the component symbol from the original file instead of using a local cached copy. This may be different if the source file has changed. |
|
/norepeat |
If specified a single instance will be placed regardless of the value of the 'RepeatPlace' global option. |
|
/orient |
Specifies orientation of symbol. Value from 0 - 7 as illustrated below.
|
|
/repeat |
If specified the instantiation is repetitive. This means that once one instance has been placed, another will be presented. This continues until the user presses the right mouse key. This switch will be ignored if the RepeatPlace option is set to 'Never' (Placement options set to 'Never' in schematic sheet of options dialog). If RepeatPlace is set to 'Always', the repeat action will be enabled even if this switch is not present as long as /norepeat isn't present. If the /loc switch is present repeat action is disabled in all circumstances. |
|
/repeatalways |
If specified, instance is placed directly on sheet without user interaction at the location specified by x and y and orientation specified by orient . These values are relative. The origin of the schematic is not fixed. Usually the values used would have been returned from a call to the function InstPoints . |
|
/select |
If specified, the instance is selected after being placed on the schematic. |
|
/useph |
Only effective if /comp also specified. Will place a place holder symbol if the component symbol specified is not found. Without this switch an error message will be displayed if a component symbol is missing. |
|
symbolname |
Name of symbol. Symbol names "caption" and "free_text" are treated specially. See notes. |
|
propname |
If specified, property of this name is changed to propvalue . |
|
propvalue |
See above. |
Notes
The symbol name 'caption' will instantiate the built-in caption annotation object and not a symbol called 'caption'. Similarly the symbol name 'free_text' will instantiate the built-in free text annotation object. In both cases the text displayed will be the property value given. The property name will be ignored. If no property value is provided, the default values "Caption" and "Text" will be used respectively.
| ▲ Command Summary ▲ | ||
| ◄ ImportSymbol | KeepGroup ▶ | |