Define VIEW Contents Using Id Lists
- Last UpdatedApr 27, 2023
- 2 minute read
You can add many elements to a VIEW by displaying the contents of an Id List (IDLI element). The Id List contains a list of the elements to display. Id Lists are contained within Drawing List Libraries (DLLB elements).
Starting at World level, the library part of the database is set up as:
NEW LIBY /LIB1
NEW DLLB /DLB1
NEW IDLI /ID1
Refer to Create a Drawing, a Sheet and a View for further information.
-
Library (LIBY) elements can display at four positions in the hierarchy. Refer to Draw Database Hierarchy for further information. They are administrative elements used to group together several types of sub-library. The type of sub-library of interest here is the Drawing List Library (DLLB) .
-
The DLLB is used to group together Id List (IDLI) elements.
The Id List is constructed by using DRAADD and DRAREMOVE commands:
DRAADD /ZONE.PIPES2-1
DRAADD /ZONE.EQUI2-1
DRAREMOVE /PIPE2-1-12
DRAREM /PUMP2-1-12
DRAADD and DRAREMOVE can be combined on a single line, for example:
DRAADD /ZONE1.EQUIP, /ZONE1.PIPES DRAREMOVE /VESS1, BRAN 2 OF /PIPE3
The DRAADD and DRAREMOVE commands automatically create the Add Entry (ADDE) and Remove Entry (REME) elements, refer to Create a Drawing, a Sheet and a View for further information, also setting those ADDE and REME attributes which refer to (in this example) appropriate elements in the Design database. Other Id Lists can be added or removed in the same way. For example:
NEW IDLI /LIST1
DRAADD /ZONE1
DRAADD /LIST2
DRAREM /LIST3
Note:
When evaluated individually both /LIST2 and /LIST3 must define a set of design elements
which are then added to/removed from /LIST1, respectively. In particular if /LIST3
is being used to remove a number of Branches (say) from /LIST1 then it must be defined
as:
DRAADD /BRAN1, /BRAN2, /BRAN3
and NOT as:
DRAREM /BRAN1, /BRAN2, /BRAN3
If an Id List has Remove entries then the member list order is important. For an entry to be removed it must have been (implicitly) added previously. Hence a Remove Entry must never be the first element in an Id List. Consider the command sequences:
|
Sequence 1 |
Sequence 2 |
|---|---|
|
DRAADD /ZONE.PIPES |
DRAADD /ZONE.PIPES |
|
DRAADD /PIPE1-1 |
DRAREM /PIPE1 |
|
DRAREM /PIPE1 |
DRAADD /PIPE1-1 |
In Sequence 1 the final command removes all branches owned by /PIPE1 - including /PIPE1-1 which has been added by the second command (and implicitly by the first). In Sequence 2 these commands have been reordered so that having removed all branches in /PIPE1 (second command) the required Branch (/PIPE1-1) is added by the final command.
Having created an Id List it can be used to define the contents of a VIEW by setting the VIEW's IDLN attribute directly:
IDLI /ID1
or indirectly:
AUTO /ID1
Refer to Define Views Using the AUTO Commands for further information.
Note:
GRIDSYstem and GRIDAXis elements can be added to IDLists but cannot be the sole member
of the IDList. When drawn their GRIDLNs are considered to be of infinite length and
are extended to the VIEW boundary. AUTO commands ignore these elements when calculating
the VSCA, THPOS, and SIZE attributes of a VIEW.