Plot Set Attributes

Land Desktop Development ARX CPP SDK

Up a level
Plot Set Attributes
 
 

This table shows plot set attribute names, descriptions, examples, and default values.

AttributeDescriptionDefault
name Query name (string), e.g., "plotset2" ""
desc Description (string), e.g., "Complete Plot Set" ""
pnam Plotter name (string), e.g., "HP LaserJet III on LPT1" ""
pscr Plot script (string), e.g., "e, n, y" ""
block Name of plot layout, a block name (string), e.g., "TBLOCK" ""
atts List of attributes for the block (string list), e.g., "TITLE" nil
vlayer Main viewport layer (string), e.g., "VPORT2" ""
vdispl Layers to disable for the main viewport (string list), e.g., "0" nil
kflg Enables the reference viewport: T or nil
T Enabled
nil Disabled
Note that there are two dependent attributes, "klayer" and "kdispl"
T
klayer Key viewport layer (string), e.g., "VPORT1", the layer of the reference viewport, which must be a different layer from the layer used for the main viewport (attribute "vlayer"); if the function map_pltblkvps returns only one viewport layer, it should be used for the main viewport ""
kdispl Key display layers (string list), e.g., "BOUNDARY", a list of layers to be displayed in the referenced viewport. This should not be nil if "kflg" is enabled. Valid layers are all the layers returned by ade_dsproplist using the option "layer" nil
kscl Key viewport scale factor (real) 0.25
dwgs List of source drawings (string list), e.g., "DRAWING1.DWG" "DRAWING2.DWG" nil
dact Force drawing active at plot time: T or nil T
qcat List of query catalogs (string list), paired with qnam list entries, e.g., "Queries" nil
qnam List of query names (string list), paired with qcat list entries, e.g., "Query_One" nil
bdwg Boundary drawing (string), e.g., "BOUNDARY.DWG" ""
bnds Boundaries (string list), the boundary or boundaries to use by providing the value for the field assigned in "bnamf", e.g., "Boundary #3" nil
blyr Boundary layer (string), the name of the layer the boundary is placed on. It can be any layer of the boundary drawing. For example, "BOUNDARY" ""
bnamt Boundary name table (string), the name of the object data table attached to the boundary object, e.g., "BOUNDARIES" ""
bnamf Boundary name field (string), the name of the field to use (from the table assigned in "bnamt") for the "bnds" attribute, e.g., "name" ""
bodfs Boundary fields (string list), the list of field names to be mapped to attributes in the title block, e.g., "name" (see details and example following this table); the title block is assigned using the attributes from the block assigned in "block" nil
sflg Plot to specified scale: T or nil nil
scale Plot scale (string), e.g., "1:2000" 1:1
clip Clip objects against boundary (flag):
T or nil
nil
pbnd Plot boundary (flag): T or nil
T Plot boundary polylines are plotted
nil Plot boundary polylines are erased
before plotting
nil
bbuf Buffer boundary: T or nil nil
btyp Buffer type: "true" or "rect"
"true" Offsets the minimum bounding
rectangle for a map boundary
polyline
"rect" Specifies an offset of an existing
plot boundary line
true
bdist Buffer distance (real) 0.10

Mapping of object data fields to block attributes is managed by the two plot attributes "bodfs" and "atts". The mapping is best explained by example. Suppose the following conditions:

  • The boundary object data table, defined by the "bnamf" attribute, has the following fields: Field1, Field2, Field3, and Field4.
  • The layout block, defined by the "block" attribute, has the following attributes: Attr1, Attr2, Attr3, Attr4, and Attr5.
  • You want the value of Field1 to appear in place of Attr2, the value of Field2 in place of Attr3, and value of Field4 in place of Attr1.

To define the desired mapping, set the "bodfs" attribute to ("field1" "field2" "field4") and the "atts" attribute to ("attr2" "attr3" "attr1"). When plotting is done, values of the fields from the object data table attached to the boundary's closed polyline will be assigned to the specified block attributes. The number of elements in each list for "bodfs" and "atts" must be the same.