Object Selection and Colour Setting
- Last UpdatedFeb 19, 2025
- 2 minute read
Elements that are to be copied to the model file are held in a draw list. Elements may be specified explicitly or by using a PML expression to define selection criteria. Refer to Software Customization Reference for further information about PML.
Only significant elements, such as BRAN, EQUI, SUBS, HANG, STRU, PTRA, etc., may be added to or removed from the draw list. If the user tries to add or remove an element below a significant element (that is, a primitive), the whole of its owning significant element is added to or removed from the draw list.
Colours to be used to display the different element types can be specified explicitly or by using the Autocolour selection rules - refer to AUTOCOLOUR command in Selecting Graphics Colours Automatically.
Examples |
|
|---|---|
|
EXPORT /VESS1 COLOUR 2 |
|
|
Specifies colour of exported element directly. |
|
|
EXPORT AUTOCOLOUR ALL BOXES WITH (XLEN GT 100) COLOUR 10 |
|
|
Specifies using AUTOCOLOUR rules. |
|
|
EXPORT AUTOCOLOUR ALL BRAN MEMBERS COLOUR (:ICOLOR OF SPREF) |
|
|
Specifies using AUTOCOLOUR rules. |
|
The colour number, whether given as an integer or as an expression, refers to the colour number to be used in Review.
The order in which rules are given is important, because they are evaluated in this order until a rule is encountered for which the selection criteria are satisfied. This is the rule from which the colour is taken. If no rule is satisfied, or if no colour rules have been given, or if the selection is invalid for some reason, then colour 0 is used. Rules may be reordered, removed and controlled by the following commands:
EXPORT AUTOCOLOUR ON
Turns the use of Autocolour in EXPORT mode on. The rules will be ignored until turned on.
EXPORT AUTOCOLOUR OFF
Turns the use of Autocolour in EXPORT mode off.
EXPORT AUTOCOLOUR RESET
Clears the current selection by removing all rules.
EXPORT AUTOCOLOUR REMOVE 4
Removes rule 4.
EXPORT AUTOCOLOUR REORDER 4 TO 99
Reorders rule 4 to position 99.
EXPORT AUTOCOLOUR DISPLAYEXPORT ON/OFF
if set uses the Design AUTOCOLOUR rules to colour elements exported to Review.
Querying
A maximum of 200 Autocolour rules are allowed at present. The following queries are also available:
Q EXPORT AUTOCOLOUR NUM
Returns the number of rules.
Q EXPORT AUTOCOLOUR MODE
Returns the mode state (on or off).
Q EXPORT AUTOCOLOUR integer
Returns the selection criteria for rule integer.
Q EXPORT AUTOCOLOUR FOR identifier
Returns colour to be selected for identified element.