Befehlsmakros und Scripting

Wo befinden sich diese Befehle?

Werkzeugleisten

Menüs

Tastenkürzel

Befehlsmakros und Scripting

Alle Rhino-Befehle können in Befehlsmakros verwendet werden. Befehlsmakros können aufgerufen werden, indem der Befehl in der Eingabeaufforderung eingegeben wird, von Schaltflächen in der Werkzeugleiste, Tastenkürzeln, Befehlsverweisen aus, anhand des Befehls BefehlsdateiLesen oder des Befehls Einfügen in Rhinos Befehlsstrom.

Schreiben von Befehlsmakros

Schreiben Sie Befehlsmakros genau so, als würden Sie die Befehlsfolge in der Befehlszeile eingeben. Ein Leerzeichen zwischen Zeichen oder eine neue Linie verhalten sich so, als würden Sie die Eingabetaste in der Befehlszeile verwenden.

Sonderzeichen

Zeichen	Bedeutung in Makro
* (Sternchen)	Der Befehl wird automatisch wiederholt, ohne dass die Eingabetaste zum Neustarten gedrückt wird.
! (Ausrufezeichen)	Löscht den vorherigen Befehl. Durch ein Ausrufezeichen (!) und ein Leerzeichen am Anfang eines Makros werden alle vorherigen Befehle gelöscht. An anderen Stellen wird das Makro abgebrochen. Das Ausrufezeichen kann wenn nötig am Ende des Makros verwendet werden.
_ (Unterstrich)	Ruft den Befehl als englischen Befehlsnamen auf. Rhino kann für verschiedene Sprachen lokalisiert werden. Die übersetzten Versionen werden Befehle, Eingabeaufforderungen, Befehlsoptionen, Dialogfenster, Menüs, etc., in den entsprechenden Sprachen übersetzt haben. Englische Befehle werden in diesen Versionen nicht funktionieren. Damit alle auf Englisch geschriebenen Skripte auf allen Computern funktionieren (ungeachtet der Sprache), müssen die Skripte Rhino zwingen, alle Befehle als englische Befehlsnamen zu interpretieren. Zum Beispiel: In der englischen Version von Rhino funktionieren die folgenden Makros: Circle 3Point 0,0,0 1,1,0 0,3,0 Aber in der französischen Version von Rhino zum Beispiel funktioniert es nicht. Sie benötigen stattdessen eines von folgenden Makros: Cercle 3Point 0,0,0 1,1,0 0,3,0 _Circle _3Point 0,0,0 1,1,0 0,3,0 Um sicherzugehen, dass die Makros weltweit funktionieren, schreiben Sie sie auf Englisch und setzen Sie einen Unterstrich (_) vor alle Befehlsnamen und Optionen.
- (Bindestrich)	Dialogfenster unterdrücken. Alle Befehle können in der Befehlszeile zu Makros werden (sogar Befehle, die standardmäßig mit Dialogfenstern kommen). Um das Dialogfenster oder Fenster zeitweilig zu unterdrücken und Optionen in der Befehlszeile zu verwenden, stellen Sie dem Befehl einen Bindestrich (-) voran.
' (Apostroph)	Der nächste Befehl ist ein verschachtelbarer Befehl. Ansichts- und Konstruktionsebenenänderungen und Objektfänge sind verschachtelbar. Befehle zur Geometrieerzeugung sind nicht verschachtelbar. Einmalige Objektfänge und Filter zum Auswählen von Teilobjekten sind automatisch verschachtelbar und benötigen kein Apostroph.
\ (Umgekehrter Schrägstrich)	Wenn das erste Zeichen in einem Werkzeugleistenmakro kein "!" ist und das letzte Zeichen "\" ist, läuft das Skript in der Befehlszeile ohne Eingabetaste, also kann mehr Information hinzugefügt werden. Diese Eigenschaft ist hilfreich, um eine Befehlszeichenfolge aus Teilen wie Ziffern, Dezimalpunkten, Winkeln (wie "<45"), die sich auf Schaltflächen befinden, zu erzeugen, wobei ein "numerischer Tastenblock" auf dem Bildschirm erzeugt wird.
~ (Tilde)	Unterdrückt Befehlsoptionen, um eine übersichtliche Befehlsrückmeldung zu erhalten. Die Optionen funktionieren wie üblich.
; (Semikolon)	Kommentar. Linien, die mit einem Semikolon (;) beginnen, sind nicht Teil des Makros aber erlauben Ihnen, das Makro zu dokumentieren oder eine Alternative zu verwenden. Zum Beispiel: ; Das ist ein Testmakro _Circle 0,0,0 15 _Line 0,0,0 _pause ;15,0,0 ; _Line 0,0,0 0,15,0 _Line 0,0,0 -15,0,0

Beispiele

Einen Kreis zeichnen

Dieses Makro erzeugt einen Kreis zentriert am Punkt 5,5 mit Radius 10:

! _-Circle 5,5 10

Die Leerzeichen zwischen den Eingaben entsprechen der Eingabetaste, wenn Sie den Befehl von Hand eingeben würden.

Objekte aus der Auswahl nehmen und den Befehl Verschieben starten

Dieses Makro startet den Befehl Verschieben, aber stellt sicher, dass keine Objekte ausgewählt sind, bevor Sie zur Auswahl von Objekten zum Verschieben aufgefordert werden:

! _SelNone _Move

Erzeugt eine Kurve durch Punkte

Dieses Makro erzeugt einen Satz von drei Punkten, wählt alle Punkte aus und erstellt eine Polylinie durch die Punkte:

! _SelAll _Points _Pause _Pause _Pause _Enter _Invert _CurveThroughPt _EnterEnd

So funktioniert dieses Skript:

! _SelAll	Löscht alle vorherigen Befehle und wählt alle Objekte im Modell aus.
_Points	Führt den Befehl Punkte aus.
_Pause _Pause _Pause	Erlaubt die Auswahl von drei Punktstandorten.
_Enter	Simuliert die Eingabetaste, was die Erzeugung von Punktobjekten stoppt.
_Invert	Kehrt die Auswahl um. Alle sichtbaren Objekte in der Szene wurden am Anfang des Skriptes ausgewählt. Nach dem Invertieren werden also nur die neu erzeugten Punktobjekte ausgewählt.
_CurveThroughPt	Erzeugt eine Polylinie durch die Punktobjekte.
_EnterEnd	Vervollständigt den Befehl.

Ein Dialogfenster umgehen

! -_Rebuild _Pause _Points=10 _Degree=3 _Enter

Wählen Sie eine Kurve aus, dann führen Sie dieses Makro aus. Alle Optionen werden durch das Makro definiert.

Diese Skripts ausprobieren

Wählen Sie das Makro aus diesem Hilfethema aus.

Drücken Sie Strg + C, um es in die Zwischenablage zu kopieren.

Klicken Sie in die Befehlseingabeaufforderung von Rhino und drücken Sie Strg + V, um das Makro einzufügen.

Besondere Scripting-Befehle

Pause	Benutzereingabe in einem Makro stoppen. Beispiel ! _Circle _Pause 50 Dieses Makro fragt nach einem Punkt und zeichnet dann einen Kreis mit einem Radius von 50 Einheiten an diesem Punkt zentriert.
_Enter	Simuliert die Eingabetaste in einem Makro. Der Befehl Eingabe wiederholt den vorherigen Befehl nicht, wie es das Drücken der Eingabetaste tut.
EndeEingeben	Vervollständigt den Befehl.
BildaufbauDeaktivieren	Bildaufbau, Konstruktionsebenen- und Kameraänderungen verhindern, während ein Makro ausgeführt wird.
BildaufbauAktivieren	Aktiviert Bildaufbau nach dem Befehl BildaufbauDeaktivieren.
EchoAus	Deaktiviert Kopieren von Skriptbefehlen in das Befehlsverlauffenster.
Echo	Aktiviert Kopieren von Skriptbefehlen in das Befehlsverlauffenster.

Anmerkung: Wenn Sie nicht wissen, was Sie in einem Makro schreiben sollen, rufen Sie die Version mit Bindestrich des Befehls auf. Heben Sie die Befehlsfolge hervor, kopieren Sie sie und fügen Sie sie in Ihren Makrotext als Anfangspunkt ein.

MakroEditor