Create and Manipulate Labels

DRAW Reference Manual

Labels : Create and Manipulate Labels

The example Label display can be created by typing (starting at LAYE level):

NEW GLAB

create new General Label (or NEW SLAB to create a Special Label)

DDNM ID @

position Label attachment point using cursor

The two commands are all that is needed to create a Label with the features that display in the example; the text which displays in the Label frame is by default the name of the Design element at the Label attachment point, all other attributes having default settings cascaded down from the owning Layer.

The Label attachment point is at the origin of the element specified by the Label’s Design Data Name (DDNM) attribute.

For elements that have p-points or p-lines the attachment point can be varied by setting the NPPT or PKEY attributes to the specified p-point number/p-line name respectively.


Example:
NPPT 2 - set NPPT to (p-point) 2 PKEY TOS - set PKEY to p-line TOS (top of steel) PKEY MEML - set PKEY to member line

For elements with p-lines the attachment can be further varied by setting the PKDI p-line distance) attribute. Refer to P-line Attributes for further information.

The ON command allows the DDNM and NPPT or PKEY/PKDI attributes to be set simultaneously.


Example:
ON ID@ ON /PUMP1-1/NOZZ1 ON IDP @ ON P2 OF NOZZ4 OF EQUI /1101 ON PHEAD OF /BRAN2-1 ON PLEAVE OF /VALVE3 ON IDPLINE @ ON PPLINE BOS OF /SCTN.PN1_PN5 ON IDPDISTANCE @ ON PPLIN TOS OF /SCTN5 PROP 0.8

With the ON command it is also possible to specify an absolute distance along a p-line, although the value given is converted to a proportional value for storage in the database:

ON PPLIN TOS OF /SCTN4 2500 FROM START
ON PPLIN BOS OF /SCTN5 1000 FROM END

If the FROM keyword is omitted then FROM START is assumed.

When using the ON command if values for NPPT, PKEY and PKDI are not specified then the defaults are used - any existing values can be overwritten.

Note that If an explicit POS attribute is set, it is not overwritten by the ON command, meaning that the position of the label in the canvas does not change.

The Label attachment point can be offset from the DDNM using the APOF (Attachment Point Offset) attribute. An offset position is then defined (in VIEW coordinates) measured from the p-point/p-line distance referenced by the Label. The leader line is attached to this point (although if the clearance attribute (LLCL) is set the leader line overshoots or stops short of it). The leader line and its terminator can be moved away from the p-point to any desired position. By default APOF is (0,0), for example, no offset. APOF can be set directly, for example:

APOF 15 0

or in terms of Sheet coordinates by:

LEAD ATTA X455 Y677
LEAD ATTA @

The offset can be removed by:

LEAD ATTA DELETE (or APOF 0 0 or APOF UNSET)

The Body Text (BTEX) attribute is by default set to the ‘intelligent text’ string #NAME, which translates to the name of the Design element at the attachment point when the Label is created. If the Design element at the attachment point is unnamed, an ‘error-text’ string displays in the Label frame. The string is customisable and defined by the LAYE’s NTEXT attribute. Refer to Customise Error Text for further information.

BTEX ’NOZZLE 2’

or can be set using a combination of explicit and intelligent text. For example, the command

BTEX ’NOZZLE 2#/#NAME’

produces the Label display in the example. Note how the size of the Label frame automatically adjusts to accommodate the specified text.

Note the special hash-code ‘#/’ that generates a new line. The DRAW Intelligent Text System is described. Refer to Intelligent Text for further information.

The extent of the text defined by the BTEX setting can be queried by

Q EXTENT BTEX

Refer to Text Strings for further information.

Label text can be modified through use of the EDTEXT command. For example, if the target string is ‘NOZZLE 2’:

EDTEXT ’NOZZLE 2’ ’NOZZ 1-2’ -change Label text to ‘NOZZ 1-2’

Note:

When modifying intelligent text the intelligent text code itself must be specified, not the resultant text. The EDTEXT command is described. Refer to ModifyText for further information.