Graphisoft®

Basic Library Version: 16

New GDL Features in ArchiCAD 13

Index

  1. Purpose of the document
  2. List of new features
    1. New checking option against uninitialized variables
    2. New/changed global variables
    3. Library based Model View Options
    4. Fill enhancements
    5. Length units in model and layout
    6. Modelling enhancements
    7. New User Interface controls
    8. New ways of door/window dimensioning

1. Purpose of the document

This document informs you about the new GDL features in ArchiCAD 13. You can find the definition of the new and changed commands in the GDL Reference Guide. Some of these topics are described in the Basic Library Documentation, too. The links in this document refer to the latter one, if available.

2. List of new features

New checking option against uninitialized variables

ArchiCAD 13 introduced a new warning in GDL script checking. It can warn you about uninitialized variables.

Since GDL is derived from the Basic programming languages, you don't have to define or initialize your variables. They will be considered to be zero when first used. In many cases this is the desired function but it hides lots of problems where you misspell the name of a variable or just forget to initialize it in one branch of a difficult 'if' clause.

For a warning-free script you will have to initialize all variables in all cases. In the vast majority of the cases it will eliminate a bug and for the rest of the cases it makes your scripts more straightforward.

New/changed global variables

Wall elements listing

The following global variables are available for listing and labels only.

Slab elements listing

The following global variables are available for listing and labels only.

Roof elements listing

The following global variables are available for listing and labels only.

Beam elements listing

The following global variables are available for listing and labels only.

Curtain Wall elements listing

The following global variables are available for listing and labels only.

Door/Window elements

Library based Model View Options

The possiblility of defining library based Model View Options has been created.

To insert a tab page into the MVO dialog, you have to make a library part which is derived from the Library Global Settings (GUID: {709CC5CC-6817-4C56-A74B-BED99DDB5FFA}) subtype. This object must contain the desired global options as paramameters and it must have a user interface definition for the tab page. It may have a parameter script for connecting parameters or user interface elements.

You can use the new LIBRARYGLOBAL command in your placable elements to query values of your own library global settings object depending on the current view settings.

See Library Global View Options section of the Technical Standards for details.

Fill enhancements

poly2_b{5}
Advanced version of poly2_b{4}, where fill distortion can be controlled in an enhanced way.
wallhole2{2}, wallblock2{2}
Advanced version of wallhole2 and wallblock2, where fill distortion can be controlled in an enhanced way.

Length units in model and layout

request ("Model_length_unit", "", format_string), request ("Layout_length_unit", "", format_string)
Request for getting the length unit format specially for the model or the layout. It can return the same formats Working_length_unit returns.
request ("Model_text_size_unit", "", format_string), request ("Layout_text_size_unit", "", format_string)
Request for getting the text size unit format specially for the model or the layout. It returns the used format which can use points or millimeters in ArchiCAD.
str()
str() function supports points (pt), too.

Modelling enhancements

tube - mask 128
tube got a new option for making cross-section edges sharp
cprism_{2}
Advanced version of cprism_ with the possibility of defining different angles and materials for each side of the prism.
croof_{2}
Advanced version of croof_ with the possibility of defining different materials for the sides.

New User Interface controls

ui_radiobutton
Gives the possibility to define radio controls for selecting from options.
ui_infield method 8
Gives the possibility to define a standard drop-down control for selecting from options.

New ways of door/window dimensioning

Automatic dimensioning and Interactive Schedules of doors and windows consider all current sizing methods: wallhole, reveal, unit, egress, leaf & nominal. The new method uses dedicated parameters and accordingly positioned hotspots.

This is not exactly a GDL feature but it affects GDL programming.

See Preparing for automatic dimensions section of the Door-Window documentation for technical details.