3D Shapes
BASE
BASE
Resets counters for low-level geometric elements (VERT, TEVE, VECT, EDGE, PGON and PIPG) statements. Implicitly issued after every compound element definition.
CUTTING IN 3D
CUTPLANE
CUTPLANE [x, y, z [, side [, status]]]
[statement1 ... statementn]
CUTEND
or
CUTPLANE{2} angle [, status] [statement1 ... statementn]
CUTEND
Creates a cutting plane and removes the cut parts of enclosed shapes. CUTPLANE may have a different number of parameters.
If CUTPLANE has the following number of parameters:
0:x-y plane;
1:cutting plane goes across x axis, angle is between cutting plane and x-y plane;
2:cutting plane is parallel to z axis, crosses x axis and y axis at the given values;
3:cutting plane crosses the x, y and z axes at the given values;
4:the first three parameters are as above, with the addition of the side value as follows:
side = 0: removes parts above cutting plane (default);
side = 1: removes parts below cutting plane; in case of x-y, x-z, y-z, removes the parts in the negative direction of the axis.
The cut (without the side parameter) removes parts above the cutting plane. If the first three parameters define the x-y, x-z or y-z plane (for example, 1.0, 1.0, 0.0 defines the x-y plane), the parts in the positive direction of the third axis are removed.
Any number of statements can be added between CUTPLANE and CUTEND. It is also possible to include CUTPLANEs in macros. CUTPLANE parameters refer to the current coordinate system.
Transformations between CUTPLANE and CUTEND have no effect on this very cutting plane, but any successive CUTPLANEs will be transformed. Therefore, it is recommended to use as many transformations to set up the CUTPLANE as necessary, then delete these transformations before you define the shapes to cut.
100 |
ArchiCAD 11 GDL Reference Guide |
3D Shapes
Pairs of CUTPLANE-CUTEND commands can be nested, even within loops. If the final CUTEND is missing, its corresponding CUTPLANE will be effective on all shapes until the end of the script.
CUTPLANEs in macros affect shapes in the macro only, even if CUTEND is missing.
If a macro is called between CUTPLANE and CUTEND, the shapes in the macro will be cut. Current material, pen and fill settings are effective on the cut surfaces.
Note: If CUTPLANE is not closed with CUTEND, all shapes may be entirely removed. That’s why you always get a warning message about missing CUTENDs.
If transformations used only to position the CUTPLANE are not removed, you may think that the CUTPLANE is at a wrong position when, in reality, it is the shapes that have moved away.
Examples:
CUTPLANE 2, 2, 4
CUTPLANE -2, 2, 4
CUTPLANE -2, -2, 4
CUTPLANE 2, -2, 4 ADD -1, -1, 0 BRICK 2, 2, 4 DEL 1
CUTEND
CUTEND
CUTEND
CUTEND
CUTPLANE |
CUTPLANE 1, |
1, 0, 1 |
SPHERE 2 |
SPHERE |
2 |
CUTEND |
CUTEND |
|
ArchiCAD 11 GDL Reference Guide |
101 |
3D Shapes
CUTPLANE |
1.8, 1.8, |
CUTPLANE 1.8, 1.8, |
|
SPHERE |
1.8 |
1.8, |
1 |
2 |
SPHERE 2 |
|
|
CUTEND |
|
CUTEND |
|
CUTPLANE 60 |
CUTPLANE |
-120 |
BRICK 2, 2, 2 |
BRICK |
2, 2, 2 |
CUTEND |
CUTEND |
|
CUTPOLY
CUTPOLY n,
x1, y1, ... xn, yn [, x, y, z] [statement1 statement2
...
statementn]
CUTEND
102 |
ArchiCAD 11 GDL Reference Guide |
3D Shapes
Similarly to the CUTPLANE command, parameters of CUTPOLY refer to the current coordinate system. The polygon cannot be self-intersecting. The direction of cutting is the Z axis or an optional (x, y, z) vector can be specified.
The parameters define an infinite “tube”: the polygon is the cross-section of the tube, the direction of cutting is the direction of the tube. Everything inside the tube is removed.
Examples:
ROTX 90
MULZ -1 CUTPOLY 3,
0.5, 1, 2, 2, 3.5, 1,
-1.8, 0, 1
DEL 1
BPRISM_ "Red brick", "Red brick", "Face brick", 4, 0.9, 7, 0.0, 0.0, 15, 6.0, 0.0, 15, 6.0, 3.0, 15, 0.0, 3.0, 15
CUTEND
A=1.0
D=0.1
CUTPOLY 4,
D, D,
A-D, D,
A-D, A-D,
D, A-D
ROTX 90
CUTPOLY 4,
D, D,
A-D, D,
A-D, A-D,
D, A-D
DEL 1
ROTY 90
CUTPOLY 4,
D, D,
A-D, D,
A-D, A-D,
D, A-D
DEL 1
BLOCK A, A, A
CUTEND
ArchiCAD 11 GDL Reference Guide |
103 |