Name
DEL

Syntax
DEL anzahl [, beginn]

Aufklappen Wertebereiche
Bis AC 5.x bzw. ohne Verwendung von beginn:
0 ≤ anzahl ≤ n, Typ Integer

Ab AC 6.0:
-beginnanzahl ≤ n+1-beginn, Typ Integer
1 ≤ beginn ≤ n, Typ Integer

mit n=NTR(), die Anzahl der bisherigen Transformationen auf dem Stack

Aufklappen Erläuterung
Dieser Befehl macht die Transformationen des Koordinatensystems rückgängig. Wieviele, wird durch den Parameter anzahl festgelegt.

Fehlt der Parameter beginn werden die anzahl letzten Transformationen widerrufen.

Ab ArchiCAD® 6.0 kann auch nur ein Teil der Transformationen innerhalb des Stacks widerrufen werden. Mit Angabe eines Wertes für beginn werden die Transformationen beginn bis einschl. beginn+anzahl-1 entfernt. Das Koordinatensystem wird dann nach den auf dem Stack verbleibenden Transformationen positioniert.

Sollen alle Transformationen widerrufen werden kann dies mit DEL TOP ohne Angabe der Gesamtanzahl erreicht werden.

Aufklappen Beispiel
Gehen wir von folgenden Transformationen in Folge des Skripts aus:

MULX 2.0 ! 1. Transformation
ADDY 2.5 ! 2. Transformation
ADDZ 1.5 ! 3. Transformation
ROTX -60 ! 4. Transformation
ADDX 1.5 ! 5. Transformation


Beispiel A:
DEL 2 ! löscht Transformation 4 und 5

Beispiel B:
DEL 3,2 ! löscht Transformation 2, 3 und 4

Beispiel C:
DEL -2,3 ! löscht Transformation 2 und 3

Die verbleibende Transformation des Koordinatensystems im Beispiel C nach dem DEL-Befehl entspricht:
MULX 2.0 ! 1. Transformation
ROTX -60 ! 4. Transformation
ADDX 1.5 ! 5. Transformation


Zu den Auswirkungen siehe auch Abbildung rechts.

Aufklappen Besonderheiten
Wird nur der Parameter anzahl verwendet, werden die Parameter von "oben", also von den zuletzt ausgeführten, vom Stapel genommen.

Der Parameter beginn wird jedoch von "unten", also den zuerst ausgeführten, gezählt. Die Richtung, in die der Parameter anzahl dann wirkt hängt von seinem Vorzeichen ab:
anzahl>0 nach oben, zu den jüngeren,
anzahl<0 nach unten zu den zu Beginn des Skripts vorgenommenen Transformationen.

Aufklappen Kontext
2D-Skript, 3D-Skript