Name
SWEEPGROUP

Syntax
SWEEPGROUP (gruppenname, x, y, z)

Aufklappen Wertebereiche
gruppenname, Typ string oder einer SEO-Gruppe zugewiesene Variable
x,y,z Typ real

Aufklappen Erläuterung
Setzt eine zuvor definierte Gruppe oder ein Ergebnis voriger SEO-Befehle voraus (gruppenname). Verschiebt die 3D-Elemente der Gruppe um den Richtungsvektor (x/y/z) und fügt den dabei überstrichenen Raum der resultierenden Gruppe hinzu.

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

Siehe auch die undokumentierte Version: SWEEPGROUP{2}.

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

differenz=SUBGROUP("Kugel","Kiste")
ausgezogen=SWEEPGROUP(differenz,0,halb/4,0)

PLACEGROUP ausgezogen

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 Kontext
3D-Skript

Aufklappen ArchiCAD
ab 8.0