ArchiCAD 11 GDL Reference Guide

324 Pages·2007·3.17 MB·English

ArchiCAD 11 GDL Reference Guide
Graphisoft
Visit the Graphisoft website at http://www.graphisoft.com for local distributor and product availability information.
ArchiCAD 11 GDL Reference Guide
Copyright © 2007 by Graphisoft, all rights reserved. Reproduction, paraphrasing or translation without express prior written permission is
strictly prohibited.
Trademarks
ArchiCAD and ArchiFM are registered trademarks and PlotMaker, Virtual Building, StairMaker and GDL are trademarks of Graphisoft.
All other trademarks are the property of their respective holders.
Introduction
This manual is a complete reference for Graphisoft’s proprietary scripting language, GDL (Geometric Description Language). The manual is recommended for those users
who wish to expand on the possibilities presented by the construction tools and object libraries available in Graphisoft software. It gives a detailed description of GDL,
including syntax definition, commands, variables, etc.
3
ArchiCAD 11 GDL Reference Guide
4
ArchiCAD 11 GDL Reference Guide
C
ONTENTS
General Overview ____________________________________11 SPHERE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Starting Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 ELLIPS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 CONE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Library Part Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 PRISM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Analyze, Deconstruct and Simplify. . . . . . . . . . . . . . . . . . . . . . . . . .12 PRISM_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Elaboration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 CPRISM_ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Entry Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 BPRISM_ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Intermediate Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 FPRISM_ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Advanced Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 HPRISM_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Expert Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 SPRISM_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
3D Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 SLAB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
The 3D Space. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 SLAB_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Coordinate Transformations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 CSLAB_ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
The GDL Interpreter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 CWALL_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
The GDL Script Analysis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 BWALL_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
XWALL_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
GDL Syntax_________________________________________21
XWALL_{2} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
BEAM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Label. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 CROOF_ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Characters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 MESH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Strings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22 ARMC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22 ARME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22 ELBOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 Planar Shapes in 3D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
Simple Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 HOTSPOT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Derived Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 LIN_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
RECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Coordinate Transformations __________________________ 25
POLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
2D Transformations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
POLY_ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
3D Transformations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
PLANE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Managing the Transformation Stack . . . . . . . . . . . . . . . . . . . .29
PLANE_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
3D Shapes __________________________________________31 CIRCLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Basic Shapes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 ARC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
BLOCK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 Shapes Generated from Polylines . . . . . . . . . . . . . . . . . . . . . . .62
BRICK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 EXTRUDE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
CYLIND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 PYRAMID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
5
ArchiCAD 11 GDL Reference Guide
Contents
REVOLVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 SWEEPGROUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114
RULED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Binary 3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114
RULED{2} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
2D Shapes__________________________________________117
SWEEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Drawing Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
TUBE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
HOTSPOT2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
TUBEA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
LINE2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
COONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
RECT2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
MASS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
POLY2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
Elements for Visualization. . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
POLY2_. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
LIGHT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
POLY2_A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
PICTURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
POLY2_B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
3D Text Elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
POLY2_B{2} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
TEXT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
POLY2_B{3} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
RICHTEXT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
ARC2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
Primitive Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
CIRCLE2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
VERT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
SPLINE2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
TEVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
SPLINE2A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
VECT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
PICTURE2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
EDGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
PICTURE2{2} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
PGON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Text Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
PIPG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
TEXT2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
COOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
RICHTEXT2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
BODY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Binary 2D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
BASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
FRAGMENT2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
Cutting in 3D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
FRAGMENT2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
CUTPLANE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
3D Projections in 2D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
CUTPOLY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
PROJECT2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
CUTPOLYA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
PROJECT2{2} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
CUTSHAPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
PROJECT2{3} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
CUTFORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Drawings in the List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
Solid Geometry Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 108
DRAWING2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
GROUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
DRAWING3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
ENDGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
DRAWING3{2}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
ADDGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
DRAWING3{3}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
SUBGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
ISECTGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Graphical Editing __________________________________ 133
ISECTLINES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Hotspot-based Editing Commands. . . . . . . . . . . . . . . . . . . . .133
PLACEGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 HOTSPOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133
KILLGROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 HOTLINE2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
6
ArchiCAD 11 GDL Reference Guide
Contents
HOTARC2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138 [SET] LINE_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
Inline Attribute Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
Status Codes_______________________________________ 139
Materials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
Status Code Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
DEFINE MATERIAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
Additional Status Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141
DEFINE MATERIAL BASED_ON. . . . . . . . . . . . . . . . . . . . .163
Previous part of the polyline: current position and tangent is defined.
DEFINE TEXTURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
141
Fills. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
Segment by absolute endpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141
DEFINE FILL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
Segment by relative endpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142
DEFINE FILLA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
Segment by length and direction . . . . . . . . . . . . . . . . . . . . . . . . . . .142
DEFINE SYMBOL_FILL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
Tangential segment by length. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
DEFINE SOLID_FILL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172
Set start point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
DEFINE EMPTY_FILL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172
Close polyline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144
Line Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172
Set tangent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144
DEFINE LINE_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172
Set centerpoint. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145
DEFINE SYMBOL_LINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
Tangential arc to endpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145
Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
Tangential arc by radius and angle . . . . . . . . . . . . . . . . . . . . . . . . . .146
DEFINE STYLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
Arc using centerpoint and point on the final radius . . . . . . . . . . . .146
DEFINE STYLE {2}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
Arc using centerpoint and angle. . . . . . . . . . . . . . . . . . . . . . . . . . . .147
Paragraph. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175
Full circle using centerpoint and radius . . . . . . . . . . . . . . . . . . . . . .147
Textblock. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176
Attributes _________________________________________ 151 Additional Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
Directives. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151 External file dependence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178
Directives for 3D and 2D Scripts. . . . . . . . . . . . . . . . . . . . . . . . . . .151 Non-Geometric Scripts______________________________ 179
[LET]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151 The Properties Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179
RADIUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152 DATABASE_SET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179
RESOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153 DESCRIPTOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
TOLER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154 REF DESCRIPTOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
PEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154 COMPONENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
LINE_PROPERTY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155 REF COMPONENT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
[SET] STYLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155 BINARYPROP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
SET STYLE 0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155 SURFACE3D ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
Directives Used in 3D Scripts Only. . . . . . . . . . . . . . . . . . . . . . . . .155 VOLUME3D ( ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
MODEL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155 POSITION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
[SET] MATERIAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156 DRAWING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
SECT_FILL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157 The Parameter Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
SHADOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158 VALUES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
Directives Used in 2D Scripts Only. . . . . . . . . . . . . . . . . . . . . . . . .159 PARAMETERS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .184
DRAWINDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159 LOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
[SET] FILL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159 HIDEPARAMETER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
7
ArchiCAD 11 GDL Reference Guide
Contents
The User Interface Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 PI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
UI_DIALOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 Transcendental Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
UI_PAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 EXP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
UI_CURRENT_PAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 LGT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
UI_BUTTON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 LOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_SEPARATOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 Boolean Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_GROUPBOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 NOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_PICT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 Statistical Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_STYLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 MIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_OUTFIELD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 MAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_INFIELD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 RND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_INFIELD {2}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 Bit functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_INFIELD{3} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 BITTEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
UI_TOOLTIP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 BITSET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
Special Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202
Expressions and Functions___________________________ 195
String Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202
Expressions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
STR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202
DIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
STR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202
VARDIM1(expr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
STR{2}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202
VARDIM2(expr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
SPLIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
Operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
STW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206
Arithmetical Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
STRLEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206
Relational Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
STRSTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206
Boolean Operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
STRSUB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Arithmetical Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 Control Statements _________________________________ 209
ABS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 Flow Control Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
CEIL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 FOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
INT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 NEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
FRA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 DO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
ROUND_INT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
SGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 GOTO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
SQR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 GOSUB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
Circular Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 RETURN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
ACS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 END / EXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
ASN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 Parameter Buffer Manipulation. . . . . . . . . . . . . . . . . . . . . . . .214
ATN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 Macro Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218
COS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 The Output Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
SIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 File Operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
TAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 OPEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220
8
ArchiCAD 11 GDL Reference Guide
Contents
INPUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220 WALLNICHE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260
VARTYPE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221 Rectangular Doors/Windows in Curved Walls. . . . . . . . . . . . . . . .261
OUTPUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221 Non-Rectangular Doors/Windows in Curved Walls. . . . . . . . . . . .263
CLOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221 2D Related Challanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .264
Cutting custom wall opening . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .264
Miscellaneous______________________________________223
WALLHOLE2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .264
Global Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
WALLBLOCK2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
General environment information. . . . . . . . . . . . . . . . . . . . . . . . . .223
WALLLINE2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
Story information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
WALLARC2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .266
Fly-through information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
GDL Created from the Floor Plan . . . . . . . . . . . . . . . . . . . . . 266
General element parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
Keywords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Object, Lamp, Door, Window parameters. . . . . . . . . . . . . . . . . . . .225
Common Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .267
Object, Lamp parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226
Reserved Keywords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .267
Object, Lamp, Door, Window parameters - available for listing and la-
3D Use Only. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .268
bels only. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226
2D Use Only. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .270
Object, Lamp parameters - available for listing and labels only . . .226
Window, Door and Wall End parameters . . . . . . . . . . . . . . . . . . . .227 2D and 3D Use. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
Window, Door parameters - available for listing and labels only . .228 Non-Geometric Scripts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
Lamp parameters - available for listing and labels only. . . . . . . . . .228 Property Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
Label parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229 Parameter Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .272
Wall parameters - available for Doors/Windows. . . . . . . . . . . . . . .230 Interface Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273
Wall parameters - available for listing and labels only. . . . . . . . . . .231 Alphabetical List of Current GDL Keywords. . . . . . . . . . . . . . . . .274
Column parameters - available for listing and labels only. . . . . . . .233 A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274
Beam parameters - available for listing and labels only. . . . . . . . . .235 B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274
Slab parameters - available for listing and labels only . . . . . . . . . . .236 C. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .275
Roof parameters - available for listing and labels only . . . . . . . . . .237 D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .278
Fill parameters - available for listing and labels only. . . . . . . . . . . .238 E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280
Mesh parameters - available for listing and labels only . . . . . . . . . .238 F. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280
Free users’ globals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239 G. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281
Old Global Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .240 H. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281
Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281
REQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .242 K. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .282
REQUEST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243 L. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .282
Doors and Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .282
General Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253 N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283
Creation of Door/Window Library Parts . . . . . . . . . . . . . . . . . . . .254 O. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283
3D related challanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254 P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284
Rectangular Doors/Windows in Straight Walls. . . . . . . . . . . . . . . .254 R. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .286
Non-Rectangular Doors/Windows in Straight Walls . . . . . . . . . . .256 S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289
WALLHOLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256 T. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .290
9
ArchiCAD 11 GDL Reference Guide
Contents
U. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 Finishing Folder Scanning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302
V. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 GDL Text I/O Add-On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
W. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 Opening File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303
X. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Reading Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304
Parameter Naming Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Writing Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305
GDL Data I/O Add-On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Closing File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306
Description of Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Property GDL Add-On. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Opening a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
OPEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
Reading Values from Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Writing Values into Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 CLOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
Closing Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 INPUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .308
GDL DateTime Add-On. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 OUTPUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
Opening Channel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 GDL XML Extension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
Reading Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 Opening XML Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312
Closing Channel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Reading XML Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313
GDL File Manager I/O Add-On . . . . . . . . . . . . . . . . . . . . . . 301
Modifying XML Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316
Specifying Folder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Getting File/Folder Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 Index_____________________________________________ 321
10
ArchiCAD 11 GDL Reference Guide