General Libpart Parameters

General element parameters

GLOB_LAYER layer of the element
name of the layer the element is assigned to
GLOB_ID user ID of the element
ID as set in the settings dialog box
GLOB_INTGUID internal GUID of the element
the internal GUID generated by the program (cannot be controlled by the user)
GLOB_ELEVATION base elevation of the element
  • door/window objects: sill height, according to current settings
  • slab: the elevation of the chosen reference plane of the slab, according to settings
  • other elements/objects: the base elevation, according to settings
GLOB_ELEM_TYPE element type, for labels and property objects contains the type of the parent element
  • 0 – none (individual label)
  • 1 – object
  • 2 – lamp
  • 3 – window
  • 4 – door
  • 5 – wall
  • 6 – column
  • 7 – slab
  • 8 – roof
  • 9 – fill
  • 10 – mesh
  • 11 – zone
  • 12 – beam
  • 13 – curtain wall
  • 14 – curtain wall frame
  • 15 – curtain wall panel
  • 16 – curtain wall junction
  • 17 – curtain wall accessory
  • 18 – shell
  • 19 – skylight
  • 20 – morph

General environment information

GLOB_SCRIPT_TYPE type of current script
  • 1 – properties script
  • 2 – 2D script
  • 3 – 3D script
  • 4 – user interface script
  • 5 – parameter script
  • 6 – master script
  • 7 – forward migration script
  • 8 – backward migration script
GLOB_VIEW_TYPE type of current view (view dependent, do not use in parameter script).
  • 2 – 2D (Floor Plan)
  • 3 – 3D
  • 4 – Section
  • 5 – Elevation
  • 6 – 3D Document
  • 7 – Detail
  • 8 – Layout
  • 9 – Calculation

Use the exact needed values. Using ranges are not recommended due to possible future value extensions.

GLOB_PREVIEW_MODE type of current preview (view dependent, do not use in parameter script)
  • 0 – None
  • 1 – Dialog
  • 2 – Listing

Use the exact needed values. Using ranges are not recommended due to possible future value extensions.

GLOB_FEEDBACK_MODE indicates editing in progress (view dependent, do not use in parameter script)
0 – off, 1 – editing feedback mode
GLOB_SEO_TOOL_MODE indicates solid element operations in progress (view dependent, do not use in parameter script)
0 – off, 1 – solid element operations mode
GLOB_SCALE drawing scale (view dependent, do not use in parameter script)
according to the current window
GLOB_DRAWING_BGD_PEN pen of the drawing background color (view dependent, do not use in parameter script)
the best matching (printable) pen from the current palette to the background color of the current window
GLOB_NORTH_DIR project North direction (project dependent, do not use in parameter script)
relative to the default project coordinate system according to the settings made in the Project Location dialog
GLOB_PROJECT_LONGITUDE project longitude (project dependent, do not use in parameter script)
GLOB_PROJECT_LATITUDE project latitude (project dependent, do not use in parameter script)
GLOB_PROJECT_ALTITUDE project altitude (project dependent, do not use in parameter script)
the geographical coordinates of the project origin according to the settings specified in the Project Location dialog
GLOB_PROJECT_DATE project date (project dependent, do not use in parameter script)
array of the following six values: 1 – year, 2 – month, 3 – day, 4 – hour, 5 – minute, 6 – second.
This variable contains the project’s current date and is only set in the EcoDesigner STAR add-on (in other cases all values are set to 0). The value of this variable is modified by the add-on when running the solar analysis routines to allow certain GDL objects (for example deciduous trees) to be represented differently at different times of the year.
GLOB_WORLD_ORIGO_OFFSET_X
GLOB_WORLD_ORIGO_OFFSET_Y
Position of the project origin relative to the world origin. See Illustrating the usage of the GLOB_WORLD_ORIGO_… globals.
(project dependent, do not use in parameter script)
GLOB_MODPAR_NAME name of the last modified parameter
in the settings dialog or library part editor, including parameters modified through editable hotspots.
GLOB_UI_BUTTON_ID id of the button pushed on the UI page
or 0, if the last action was not the push of a button with id.
GLOB_CUTPLANES_INFO (project dependent, do not use in parameter script)
array of 4 length values: 1 – cutplane height, 2 – cutplane top level, 3 – cutplane bottom level, 4 – absolute display limit,
in the library part’s local coordinate system. See details in Set Floor Plan Cutplane dialog.
(project dependent, do not use in parameter script)
GLOB_STRUCTURE_DISPLAY structure display detail (project dependent, do not use in parameter script)
informs about the partial structure display option settings (integer):
0 – entire structure, 1 – core only, 2 – without finishes

Story information

GLOB_HSTORY_ELEV elevation of the home story (project dependent, do not use in parameter script)
home story is the one the object is placed on
GLOB_HSTORY_HEIGHT height of the home story (project dependent, do not use in parameter script)
home story is the one the object is placed on
GLOB_CSTORY_ELEV elevation of the current story (project dependent, do not use in parameter script)
current story is the one currently shown in the Floor Plan window
GLOB_CSTORY_HEIGHT height of the current story (project dependent, do not use in parameter script)
current story is the one currently shown in the Floor Plan window
GLOB_CH_STORY_DIST relative position of the current story to the home story (project dependent, do not use in parameter script)
current story is the one currently shown in the Floor Plan window

Migration parameters – available for migration scripts only

FROM_GUID Main GUID of the library part which was placed originally
TO_GUID Main GUID of the library part to which the migration is performed

Object, Lamp, Door, Window, Wall End, Skylight parameters

SYMB_LINETYPE line type of the library part
applied as the default line type of the 2D symbol
SYMB_FILL fill type of the library part
applied on cut surfaces of library parts in section/elevation windows
SYMB_FILL_PEN pen of the fill of the library part
applied on cut surfaces of library parts in section/elevation windows
SYMB_FBGD_PEN pen of the background of the fill of the library part
applied on cut surfaces of library parts in section/elevation windows
SYMB_SECT_PEN pen of the library part in section
applied on contours of cut surfaces of library parts in section/elevation windows
SYMB_VIEW_PEN default pen of the library part
applied on all edges in 3D window and on edges on view in section/elevation windows
SYMB_MAT default surface attribute index of the library part
SYMB_POS_X position of the library part (x)
relative to the project origin (excluding door, window and wall end: relative to the startpoint of the including wall)
SYMB_POS_Y position of the library part (y)
relative to the project origin (excluding door, window and wall end: relative to the startpoint of the including wall)
Note: see the section called “Doors and Windows” for orientation of Y and Z axes
SYMB_POS_Z position of the library part (z)
relative to the project origin (excluding door, window and wall end: relative to the startpoint of the including wall)
Note: see the section called “Doors and Windows” for orientation of Y and Z axes
SYMB_ROTANGLE rotation angle of the library part
numeric rotation from within the settings dialog is performed around the current anchor point
SYMB_MIRRORED library part mirrored
0-no, 1-yes (mirroring is performed around the current anchor point.)
Always 0 for wall ends,
except when the origin of the local coordinate system is in a non-rectangular vertex of a trapezoidal wall’s polygon.

Object, Lamp, Door, Window, Wall End, Skylight, Curtain Wall Accessory parameters – available for listing and labels only

SYMB_A_SIZE nominal length/width of library part
length of object/lamp, width of window/door (fixed parameter), width of accessory
SYMB_B_SIZE nominal width/height of library parts
width of object/lamp, height of window/door (fixed parameter), height of accessory

Object, Lamp, Curtain Wall Accessory parameters – available for listing and labels only

SYMB_Z_SIZE nominal height/length of the library part
length of accessory or if a user parameter is named in zzyzx format then it will be used for nominal height, otherwise 0

Fill parameters – available for listing and labels only

FILL_LINETYPE line type of the fill
FILL_FILL fill type of the fill
FILL_BMAT_NAME building material name of the fill
FILL_FILL_PEN pen of the fill pattern of the fill
FILL_PEN pen of the fill
FILL_FBGD_PEN pen of the background of the fill
FILL_SURF area of the fill
FILL_PERIMETER perimeter of the fill
FILL_SEGMENT_NR number of segments of the fill
FILL_HOLES_NR number of holes in the fill
FILL_HOLES_PRM perimeter of holes in the fill
FILL_HOLES_AREA area of holes in the fill
FILL_FILL_CATEGORY fill category of the fill
0 – Draft, 1 – Cut, 2 – Cover

Lamp parameters – available for listing and labels only

LIGHT_ON light is on
0-light is off, 1-light is on
LIGHT_RED red component of the light color
LIGHT_GREEN green component of the light color
LIGHT_BLUE blue component of the light color
LIGHT_INTENSITY light intensity