- value
- Tipo di valore restituito: Numero, Matrice o Stringa.
Restituisce il valore di una proprietà nel tempo corrente.
- valueAtTime(t)
- Tipo di valore restituito: Numero o Matrice.
Tipo di argomento: t è un Numero.
Restituisce il valore di una proprietà nel tempo specificato, in secondi.
Ad esempio, per avere un valore di proprietà per ciascun fotogramma da scegliere casualmente da un insieme di quattro valori, impostate i quattro valori come fotogrammi chiave a 0, 1, 2 e 3 secondi, quindi applicate la seguente espressione alla proprietà:
valueAtTime(random(4))
- velocity
- Tipo di valore restituito: Numero o Matrice.
Restituisce il valore della velocità temporale al tempo corrente. Per le proprietà spaziali, ad esempio la Posizione, restituisce il valore del vettore tangente. Il risultato è la stessa dimensione della proprietà.
- velocityAtTime(t)
- Tipo di valore restituito: Numero o Matrice.
Tipo di argomento: t è un Numero.
Restituisce il valore della velocità temporale al tempo specificato.
- speed
- Tipo di valore restituito: Numero.
Restituisce un 1D, un valore di velocità positiva uguale alla velocità alla quale la proprietà sta cambiando al tempo predefinito. Questo elemento può essere usato solo per le proprietà spaziali.
- speedAtTime(t)
- Tipo di valore restituito: Numero.
Tipo di argomento: t è un numero.
Restituisce il valore della velocità spaziale al tempo specificato.
- wiggle(freq, amp, octaves=1, amp_mult=.5, t=time)
- Tipo di valore restituito: Numero o Matrice.
Tipo di argomento: freq, amp, octaves, amp_mult e t sono Numeri.
Scuote (deforma) casualmente il valore della proprietà.
Il valore freq è la frequenza espressa in deformazioni al secondo.
Il valore amp è l’ampiezza espressa in unità della proprietà alla quale viene applicato.
octaves è il numero di ottave di rumore da aggiungere insieme. Questo valore controlla quanti dettagli sono presenti nella deformazione. Potete elevare questo valore rispetto al valore predefinito 1 in modo da includere le frequenze più alte, oppure potete abbassarlo per includere l’armonica di ampiezza nella deformazione.
amp_mult è il valore per il quale amp viene moltiplicato per ciascuna ottava. Questo valore controlla la rapidità con la quale le armoniche vengono rilasciate. Il valore predefinito è pari a 0,5. Avvicinandolo a 1, l’armonica viene aggiunta alla stessa ampiezza della frequenza di base, mentre avvicinandolo a 0 viene aggiunto un numero minore di dettagli.
t è il tempo di inizio base. Questo valore passa automaticamente al tempo corrente. Usate questo parametro se desiderate che l’output sia una deformazione del valore della proprietà campionato in un tempo diverso.
Esempio: position.wiggle(5, 20, 3, .5) genera circa 5 deformazioni al secondo con dimensioni medie pari a circa 20 pixel. Oltre alla deformazione principale, si verificano altri due livelli di deformazioni dettagliate, con una frequenza di 10 e 20 deformazioni al secondo e dimensioni pari a 10 e 5 pixel, rispettivamente.
In questo esempio, su una proprietà bidimensionale come Scala, entrambe le dimensioni vengono deformate in base alla stesso valore:
v = wiggle(5, 10);
[v[0], v[0]]
Questo esempio, su una proprietà bidimensionale, deforma solo lungo l’asse y:
freq = 3;
amp = 50;
w = wiggle(freq,amp);
[value[0],w[1]];
- temporalWiggle(freq, amp, octaves=1, amp_mult=.5, t=time)
- Tipo di valore restituito: Numero o Matrice.
Tipo di argomento: freq, amp, octaves, amp_mult e t sono Numeri.
Esegue il campionamento della proprietà a un tempo deformato. Il valore freq rappresenta la frequenza di deformazioni al secondo, ampè l’ampiezza in unità della proprietà alla quale è applicato, octaves rappresenta il numero di ottave di disturbo da aggiungere, amp_mult è la quantità per la quale moltiplicare amp per ogni ottava e t è il momento iniziale di base. Perché questa funzione abbia significato, la proprietà campionata deve essere animata, dal momento che la funzione altera solo il tempo di campionamento, non il valore. Esempio: scale.temporalWiggle(5, .2)
- smooth(width=.2, samples=5, t=time)
- Tipo di valore restituito: Numero o Matrice.
Tipo di argomento: width, samples e t sono numeri.
Uniforma i valori della proprietà nel tempo, convertendo deviazioni grandi e brevi del valore in deviazioni più piccole e distribuite più uniformemente. Questa operazione di uniformazione viene eseguita applicando un filtro casella al valore della proprietà al tempo specificato. Il valore width è l’intervallo di tempo (in secondi) durante il quale il filtro ha un valore medio. Il valore samples è il numero di campioni discreti distanziati in modo uniforme nel tempo; utilizzate un valore maggiore per ottenere una maggiore uniformità (ma prestazioni inferiori). In genere samples deve essere un numero dispari in modo tale che il valore al tempo corrente sia incluso nella media. Esempio: position.smooth(.1, 5)
- loopIn(type="cycle", numKeyframes=0)
- Tipo di valore restituito: Numero o Matrice.
Esegue il ciclo continuo di un segmento di tempo misurato dal primo fotogramma chiave sul livello in avanti verso il punto di stacco del livello. Il ciclo continuo viene eseguito dal punto di attacco del livello Il valore numKeyframe determina il segmento del quale viene eseguito il ciclo. Questo segmento è la parte del livello dal primo fotogramma chiave al numKeyframes+ 1 fotogramma chiave. Ad esempio, loopIn("cycle", 3) esegue il ciclo continuo del segmento limitato dal primo e dal quarto fotogramma chiave. Il valore predefinito di 0 significa che su tutti i fotogrammi chiave sarà eseguito il ciclo continuo.
Potete utilizzare i metodi di ripetizione a ciclo continuo dei fotogrammi chiave per ripetere una serie di fotogrammi chiave. Questi metodi possono essere utilizzati sulla maggior parte delle proprietà. Le eccezioni includono le proprietà che non possono essere espresse mediante semplici valori numerici nel pannello Timeline, come ad esempio la proprietà Testo sorgente, le proprietà della forma del tracciato e la proprietà Istogramma per l’effetto Livelli. I fotogrammi chiave o i valori di durata troppo ampi sono ritagliati al valore massimo consentito. I valori troppo piccoli produrranno un ciclo continuo.
Tipo di ciclo
|
Risultato
|
|---|
cycle
|
(impostazione predefinita) Ripete il segmento specificato.
|
pingpong
|
Ripete il segmento specificato, alternandolo avanti e indietro.
|
offset
|
Ripete il segmento specificato, ma esegue uno scostamento di ogni ciclo pari alla differenza del valore della proprietà all’inizio e alla fine del segmento, moltiplicato per il numero di volte che il segmento ha eseguito il ciclo continuo.
|
continue
|
Non ripete il segmento specifico, ma continua a animare una proprietà in base alla velocità in prossimità del primo o dell’ultimo fotogramma. Ad esempio, se l’ultimo fotogramma della proprietà Scala di un livello è pari a 100%, il livello continua a scalare da 100% fino al punto di stacco, invece di eseguire un ciclo continuo direttamente indietro fino al punto di stacco. Questo tipo non accetta un argomento keyframes o duration.
|
- loopOut(type="cycle", numKeyframes=0)
- Tipo di valore restituito: Numero o matrice.
Esegue il ciclo continuo di un segmento di tempo misurato dall’ultimo fotogramma chiave sul livello indietro verso il punto di stacco del livello. Il ciclo continuo viene eseguito fino al punto di stacco del livello Il segmento del quale eseguire il ciclo è determinato dal numero di fotogrammi chiave specificato. Il valore numKeyframes imposta il numero di segmenti del fotogramma chiave dei quali eseguire il ciclo continuo; la misurazione dell’intervallo specificato viene effettuata all’indietro partendo dall’ultimo fotogramma chiave. Ad esempio, loopOut("cycle", 1) esegue il ciclo continuo del segmento limitato dall’ultimo e dal penultimo fotogramma chiave. Il valore predefinito di 0 significa che su tutti i fotogrammi chiave sarà eseguito il ciclo continuo. Per ulteriori informazioni consultate la voce loopIn.
Nel blog omino pixel di David Van Brink potete trovare un articolo di istruzioni e un progetto di esempio che mostrano come utilizzare l’effetto Eco, l’effetto Ambiente particelle e il metodo loopOut per animare uno sciame di batteri stilizzati che nuotano.
- loopInDuration(type="cycle", duration=0)
- Tipo di valore restituito: Numero o Matrice.
Esegue il ciclo continuo di un segmento di tempo misurato dal primo fotogramma chiave sul livello in avanti verso il punto di stacco del livello. Il ciclo continuo viene eseguito dal punto di attacco del livello Il segmento del quale eseguire il ciclo è determinato dalla durata specificata. Il valore duration imposta il numero di secondi della composizione in un segmento del quale eseguire il ciclo continuo; l’intervallo specificato viene misurato dal primo fotogramma chiave. Ad esempio, loopInDuration("cycle", 1) esegue il ciclo continuo del primo secondo dell’intera animazione. Il valore predefinito di 0 significa che il segmento del quale eseguire il ciclo continuo inizia al punto di stacco del livello. Per ulteriori informazioni consultate la voce loopIn.
- loopOutDuration(type="cycle", duration=0)
- Tipo di valore restituito: Numero o matrice.
Esegue il ciclo continuo di un segmento di tempo misurato dall’ultimo fotogramma chiave sul livello indietro verso il punto di stacco del livello. Il ciclo continuo viene eseguito fino al punto di stacco del livello Il segmento del quale eseguire il ciclo è determinato dalla durata specificata. Il valore duration imposta il numero di secondi della composizione in un segmento del quale eseguire il ciclo continuo; la misurazione dell’intervallo specificato viene effettuata indietro dall’ultimo fotogramma chiave. Ad esempio, loopOutDuration("cycle", 1) esegue il ciclo continuo dell’ultimo secondo dell’intera animazione. Il valore predefinito di 0 significa che il segmento del quale eseguire il ciclo continuo inizia nel punto di attacco del livello. Per ulteriori informazioni consultate la voce loopIn.
- key(index)
- Tipo di valore restituito: Key o MarkerKey.
Tipo di argomento: index è un Numero.
Restituisce l’oggetto Key o MarkerKey in base al numero. Ad esempio, key(1) restituisce il primo fotogramma chiave.
- key(markerName)
- Tipo di valore restituito: MarkerKey.
Tipo di argomento: markerName è una stringa.
Restituisce l’oggetto MarkerKey con questo nome. Da utilizzare solo sulle proprietà marcatore.
- nearestKey(t)
- Tipo di valore restituito: Key o MarkerKey.
Restituisce l’oggetto Key o MarkerKey più vicino al tempo indicato.
- numKeys
- Tipo di valore restituito: Numero.
Restituisce il numero di fotogrammi chiave in una proprietà. Restituisce il numero di marcatori in una proprietà marcatore.
Nota: se usate il comando Dimensioni separate per separare le dimensioni della proprietà Posizione in singoli componenti, il numero di fotogrammi chiave cambia, quindi cambia anche il valore restituito da questo metodo.
- propertyGroup(countUp = 1)
- Tipo di valore restituito: Gruppo.
Restituisce un gruppo di proprietà relative alla proprietà sulla quale è scritta l’espressione. Ad esempio, aggiungendo l’espressione propertyGroup(1) alla proprietà Rotazione di un tratto pennello, l’espressione è destinata al gruppo di proprietà Trasformazione, che contiene la proprietà Rotazione. Aggiungendo invece propertyGroup(2), l’espressione è destinata al gruppo di proprietà Pennello. Questo metodo vi consente di stabilire relazioni indipendenti dal nome nella gerarchia della proprietà. Questo metodo particolarmente utile durante la duplicazione delle proprietà che contengono le espressioni.
Il metodo numProperties per propertyGroup restituisce il numero di proprietà presenti nel gruppo di proprietà.
Questo esempio restituisce il numero di proprietà nel gruppo che contiene la proprietà sulla quale è scritta l’espressione:
thisProperty.propertyGroup(1).numProperties
- propertyIndex
- Tipo di valore restituito: Numero.
Restituisce l’indice di una proprietà relativa ad altre proprietà nel suo gruppo di proprietà, inclusi i gruppi di proprietà all’interno di maschere, effetti, animatori di testo, selettori, forme, tracciatori e punti traccia.
- name
- Tipo di valore restituito: Stringa.
Restituisce il nome della proprietà o del gruppo di proprietà.
