Graphisoft®

Basic Library Version: 16

New GDL Features in ArchiCAD 10

Index

  1. Purpose of the document
  2. List of new features
    1. Macro call enhancments
    2. Text label for GOTO and GOSUB
    3. Getting the lisft of font names
    4. User Interface enhancments
    5. New fix named optional parameters
    6. New global variables
    7. Requests for Door/Window unique display options
    8. Request for Database identification
    9. Legal commas before PARAMETERS and ADDITIONAL_DATA keywords
    10. New poly2_b version
    11. New project2 and drawing3 version
    12. New command for defining the section attributes
    13. Cut polygon status control for cutplane and cutshape
    14. New version of sprism_
    15. Skylight Add-on improovements

1. Purpose of the document

This document informs you about the new GDL features in ArchiCAD 10. 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

Macro call enhancments

Text label for GOTO and GOSUB

Text labels are available for GOTO and GOSUB commands making the scripting more transparent.

Use it as suggested in Section 5 of GDL Style Guide 1.0.

Getting the lisft of font names

request ("FONTNAMES_LIST", "", fontnames)

See Section 4.4 of Technical Standards.

User Interface enhancments

The User Interface scripting capabilities of Library Parts were enhanced.

New fix named optional parameters

Fix named optional parameters are described in the Appendix A of this documentation. The newly added parameter groups are listed below.

New global variables

Requests for Door/Window unique display options

These commands allow one to query the display options of the particular Door/Window object.

REQUEST ("wido_show_dim", "", show)
REQUEST ("window_show_dim", "", show)
REQUEST ("door_show_dim", "", show)

Request for Database identification

This command returns database information about a placed object. The information is the id and the name of the container database. Together with GLOB_INTID the collected data can be used to identify elements uniquely in different ArchiCAD databases of a plan file.

REQUEST ("HomeDB_info", "", homeDBIntId, homeDBUserId, homeDBName, homeContext)

Legal commas before PARAMETERS and ADDITIONAL_DATA keywords

With the possibility to add commas in the following context types you can do the linewrapping in your scripts in a more natural way.

New poly2_b version

poly2_b{3} n,
        frame_fill, fill_pen, fill_background_pen,
        fillOrigoX, fillOrigoY, fillAngle, slopeDirAngle, slopeAngle,
        x1, y1, s1, ..., xn, yn, sn

Advanced version of the poly2_b{2} command, where the slope of the fill can be defined.

New project2 and drawing3 version

PROJECT2{3} projection_code, angle, method, parts
        [, backgroundColor, fillOrigoX, fillOrigoY, filldirection][[,]
        PARAMETERS name1=value1 , ... namen=valuen]
DRAWING3{3}  projection_code, angle, method , parts
        [, backgroundColor, fillOrigoX, fillOrigoY, filldirection][[,]
        PARAMETERS name1=value1 , ... namen=valuen]

The new version, project2{3}, adds the possibility to define which parts of the projected model are required and to control the attributes of the cut and view part separately, including the line type. You can also generate the projection with actual parameters set in the command.

New command for defining the section attributes

SECT_ATTRS fill, fill_background_pen, fill_pen, contour_pen [, line_type]

The command is an extension of sect_fill.

Cut polygon status control for cutplane and cutshape

CUTPLANE [x, y, z [, side [, status]]]
        [statement1 ... statementn]
CUTEND

CUTPLANE{2} angle [, status]
        [statement1 ... statementn]
CUTEND

CUTSHAPE d [, status]
        [statement1 statement2 ... statementn]
CUTEND

The status parameter controls the treatment of the generated cut polygons

New version of sprism_

sprism_{2} allows to define an inclination angle for the bottom side of the prism, in addition it makes it possible to set the material for each face independently.

Skylight Add-on improovements

When placing a Skylight object into a roof, it has an opportunity to control the upper and lower edges of the hole. For more information see the Skylight Elements documentation.