| Documentazione di Blender Volume II - Guida Utente: Ultima modifica 5 Settembre 2005 | ||
|---|---|---|
| Indietro | Capitolo 4. Riferimento dei Pulsanti | Avanti |
Gli script Python possono essere allegati ai DataBlock con la Pulsantiera Script, e si possono assegnare gli eventi che definiscono quando devono essere eseguiti. È presente solo un Pannello, Scriptlinks.
Gli ScriptLinks si possono aggiungere per i seguenti DataBlock:
Oggetti - Disponibile quando è attivo un Oggetto;
Telecamere - Disponibile quando l'Oggetto attivo è una Telecamera;
Luci - Disponibile quando l'Oggetto attivo è una Luce;
Materiali - Disponibile quando l'Oggetto attivo ha un Materiale;
Mondi - Disponibile quando la scena corrente contiene un Mondo [World];
Questi si possono selezionare con la fila di interruttori in alto nel Pannello. Da notare che solo i Pulsanti validi sono presenti.
Selezionando uno degli Interruttori si introduce il Gruppo di Pulsanti Selected Scriptlink in mezzo al Pannello.
I DataBlock possono avere un numero arbitrario di ScriptLink allegati ad essi - si possono aggiungere e cancellare collegamenti coi pulsanti New e Del, similmente agli Indici del Materiale. Gli scripts vengono eseguiti in ordine, iniziando dallo script collegato all'indice uno.
Quando si ha almeno un Scriptlink appare il Menù dei tipi di Eventi ed i pulsanti di collegamento. Il pulsante del link dovrebbe essere riempito col nome dell'Oggetto Testo contenente lo script da eseguire. Il tipo dell'Evento indica in quale punto si dovrà avviare lo script:
FrameChanged - Questo evento viene eseguito ogni volta che l'utente cambia fotogramma, e durante il rendering e la riproduzione dell'animazione. Per dare più interazione all'utente questo script viene eseguito continuamente durante la modifica degli Oggetti.
Redraw - Questo evento viene eseguito ogni volta che Blender ri-disegna le sue Finestre.
Gli script che vengono eseguito perché si è attivato un evento ricevono un input aggiuntivo dagli oggetti nel modulo Blender.
L'oggetto Blender.bylink viene impostato a True per indicare che lo script è stato chiamato da uno ScriptLink (in contrasto con la pressione del tasto ALT-P dell'utente nella finestra Testo).
L'oggetto Blender.link conterrà il DataBlock che ha referenziato lo script, questo può essere un Materiale, una Lampada, un Oggetto, ecc.
L'oggetto Blender.event conterrà il nome dell'oggetto dell'evento che ha attivato l'esecuzione dello ScriptLink. Questo consente ad uno script di essere usato per elaborare diversi tipi di eventi.
I Pulsanti ScriptLink per le Scene sono sempre disponibili nel Pannello Scriptlink in basso, e funzionano esattamente nel modo descritto sopra, ma nel contesto di una scena. Gli eventi disponibili per gli ScriptLinks della Scena sono:
FrameChanged - Questo evento viene eseguito ogni volta che l'utente cambia fotogramma, e durante il rendering e la riproduzione dell'animazione.
OnLoad - Questo evento viene eseguito al caricamento della Scena, cioè quando il file viene caricato inizialmente, o quando l'utente si sposta nella scena corrente.
Redraw - Questo evento viene eseguito ogni volta che Blender ri-disegna le sue Finestre.