Macro di comando e scripting

Dove trovo questi comandi?

Barre degli strumenti

Scelta rapida

Macro di comando e scripting

Tutti i comandi di Rhino possono essere usati in macro di comando. Le macro di comando si possono eseguire digitando il comando al prompt dei comandi, premendo i pulsanti desiderati della barra degli strumenti, usando i tasti di scelta rapida, gli alias dei comandi, da un file testo oppure incollando uno script dalla clipboard al flusso dei comandi di Rhino.

Scrittura di una macro di comando

Si scrivano le macro dei comandi digitandole al prompt dei comandi seguendo la stessa convenzione utilizzata per i comandi impartiti dalla linea di comando. Uno spazio tra i caratteri o una nuova linea hanno la stessa funzione della pressione del tasto Invio nella linea di comando.

Caratteri speciali

Carattere	Significato nella macro
* (asterisco)	Fa sì che il comando si ripeta automaticamente senza premere Invio per riavviare.
! (punto esclamativo)	Annulla il comando precedente. Un punto esclamativo (!) ed uno spazio all'inizio di una macro cancellano qualsiasi comando precedente. In qualsiasi altra posizione, termina l'esecuzione della macro. Se necessario, il punto esclamativo può essere usato anche alla fine della macro.
_ (carattere di sottolineatura)	Esegue un comando in versione Inglese. Rhino può essere localizzato in varie lingue. Le versioni non inglesi hanno comandi, prompt, opzioni di comando, finestre di dialogo, menu, ecc., tradotti nelle rispettive lingue. I comandi in inglese non funzionano in queste versioni. Affinché gli script scritti in inglese funzionino su tutti i computer a prescindere dalla lingua di Rhino, occorre che essi forzino Rhino ad interpretare tutti i comandi come nomi in inglese. Per esempio: Nella versione inglese di Rhino, la macro seguente funziona: Circle 3Point 0,0,0 1,1,0 0,3,0 Tuttavia, nella versione italiana di Rhino, questo script non funziona. Occorre usare una delle seguenti macro: Cerchio 3Punti 0,0,0 1,1,0 0,3,0 _Circle _3Point 0,0,0 1,1,0 0,3,0 Per assicurarsi che le macro possano funzionare ovunque, si scrivano in inglese precedute dal simbolo _.
- (meno)	Sopprime la finestra di dialogo. Tutti i comandi possono essere trasformati in macro dalla linea di comando (anche i comandi che di default compaiono sotto forma di finestre di dialogo). Per sopprimere una finestra di dialogo ed usare le opzioni della linea di comando, apporre il prefisso - (meno) al nome del comando da eseguire (-).
' (apostrofo)	Il comando successivo è un comando annidabile. La manipolazione delle viste e dei piani e gli snap all'oggetto sono annidabili. I comandi per la creazione di geometrie non sono annidabili. Gli snap all'oggetto "one-shot" (per una singola operazione) ed i filtri per la selezione dei sotto-oggetti sono automaticamente annidabili e non richiedono un apostrofo.
\ (barra rovesciata)	Se il primo carattere della macro di una barra strumenti è diverso da "!" e l'ultimo carattere è " \", lo script viene eseguito nella linea di comando senza "Invio", per cui si possono inserire ulteriori parametri. Questa funzione è utile per costruire una stringa di comando dinamica a partire da parametri numerici quali cifre, punti decimali ed angoli (per esempio "<45"). Si può avere un "tastierino numerico" sullo schermo, con i tasti associati a tali parametri numerici.
~ (tilde)	Elimina le opzioni di comando per lasciare più spazio ai messaggi di feedback dei comandi. Le opzioni continuano a funzionare normalmente.
; (puntoevirgola)	Commento: Le linee che iniziano con un punto e virgola (;) non sono parte della macro ma permettono all'utente di documentare la macro o di inserire input alternativo. Per esempio: ; Questa è una macro di prova _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

Esempi

Disegnare un cerchio

La seguente macro crea un cerchio con centro nel punto 5,5 e raggio pari a 10:

! _-Circle 5,5 10

Gli spazi presenti tra le varie voci corrispondono alla pressione del tasto Invio quando si inserisce il comando manualmente.

Deselezione di oggetti ed esecuzione del comando Sposta

Questa macro esegue il comando Sposta, ma si assicura che nessun oggetto sia selezionato prima di selezionare l'oggetto da spostare:

! _SelNone _Move

Creare una curva facendola passare per una serie di punti

Questa macro crea un insieme di tre punti e, dopo averli selezionati, genera una polilinea passante attraverso questi punti:

! _SelAll _Points _Pause _Pause _Pause _Enter _Invert _CurveThroughPt _EnterEnd

Come funziona questo script:

! _SelezionaTutto	Cancella tutti i comandi precedenti e seleziona tutti gli oggetti attualmente presenti nel modello.
_Points	Esegue il comando Punti.
_Pause _Pause _Pause	Consente di specificare tre punti.
_Enter	Simula la pressione del tasto Invio, che termina la creazione di oggetti punto.
_Invert	Inverte la selezione. Tutti gli oggetti visibili nella scena sono stati selezionati all'inizio dello script, per cui, dopo l'esecuzione del comando Inverti, vengono selezionati solamente i nuovi oggetti punto creati.
_CurveThroughPt	Crea una polilinea attraverso gli oggetti punto.
_EnterEnd	Completa il comando.

Evitare la visualizzazione di una finestra di dialogo

! -_Rebuild _Pause _Points=10 _Degree=3 _Enter

Selezionare una curva, quindi eseguire questa macro. Tutte le opzioni verranno impostate dalla macro.

Per provare questi script

Selezionare la macro direttamente da questa pagina della guida.

Premere Ctrl+C per copiarlo negli appunti.

Fare clic sul prompt dei comandi di Rhino e premere Ctrl+V per incollare la macro.

Speciali script di comando

Pausa	Interrompe momentaneamente la macro in attesa dell'inserimento dell'input da parte dell'utente. Esempio ! _Circle _Pause 50 Questa macro richiede l'inserimento di un punto e quindi traccia un cerchio centrato su di esso, con raggio pari a 50.
Invio	Simula la pressione del tasto Invio all'interno di una macro. Questo comando non ripete il comando precedente come fa la pressione del tasto Invio.
InvioFine	Completa il comando.
AggiornamentoOff	Impedisce l'aggiornamento dello schermo, del piano di costruzione e della camera durante le macro.
AggiornamentoOn	Riattiva l'aggiornamento dello schermo dopo l'esecuzione del comando AggiornamentoOff.
NoEco	Disattiva l'eco dei comandi macro nella finestra dello storico dei comandi.
Eco	Attiva l'eco dei comandi macro nella finestra dello storico dei comandi.

Nota: Se non si è certi della sintassi esatta di un comando da scrivere nella macro, utilizzare la versione con segno meno del comando. Per familiarizzarsi con le macro, evidenziare e copiare la sequenza di comandi e quindi incollarla nel testo della macro.

EditorMacro