Name
SUBGROUP

Syntax
SUBGROUP (minuend, subtrahend)

Aufklappen Wertebereiche
minuend,subtrahend, Typ string oder einer SEO-Gruppe zugewiesene Variable

Aufklappen Erläuterung
Setzt zwei zuvor definierten Gruppe oder Ergebnisse voriger SEO-Befehle voraus (minuend und subtrahend). Die Operation schneidet aus dem minuenden das Volumen des subtrahenden.

Die Material- und Oberflächenschraffurattribute der Schnittflächen erbt die resultierende Gruppe vom subtrahenden. Die Oberflächen des minuenden bleiben erhalten. Der Stift der Schnittlinie ist der aktuell eingestellte Stift.

Wie bei allen Operationen wird das Ergebnis einer (neuen) Gruppe zugewiesen. Diese wird ähnlich wie bei Funktionen als Variable vorangestellt. Siehe Beispiel.

Aufklappen Beispiel
halb= 0.5

GROUP "Kugel"
ADDZ halb/3
MULY 0.25
MATERIAL "Glas Normalglas"
SPHERE halb
ENDGROUP

GROUP "Kiste"
ADD -halb,-halb/4,-2*halb/3
MATERIAL "Natur Eis"
BLOCK 2*halb,halb/2,2*halb/3
ENDGROUP

differenz1=SUBGROUP("Kugel","Kiste")
differenz2=SUBGROUP("Kiste","Kugel")

PLACEGROUP differenz1
ADDY halb
PLACEGROUP differenz2

Aufklappen Besonderheiten
Das Ergebnis der Operation ist eine neue Gruppe, deren Name in der vorangestellten Variablen abgelegt wird. Dieser automatisch erzeugte, eindeutige Name besteht aus einem Zahlenwert (mit führendem und nachfolgendem Leerzeichen), der aber als String verwendet wird. VARTYPE liefert als Ergebnis 2, also Typ string zurück. Doch sind in der Folge keine Stringoperationen mit der Variablen möglich. Die Variable stellt also eine Art Sondertyp "string" dar.

Aufklappen Attribute
PEN

ArchiTalk:
Fehlerhafte Schnittflächendarstellung (EN)

Aufklappen Kontext
3D-Skript

Aufklappen ArchiCAD
ab 8.0