# [name]

Un KeyframeTrack è una sequenza temporizzata di [link:https://en.wikipedia.org/wiki/Key_frame keyframe], composti da una lista di tempi e valori correlati, utilizzati per animare una proprietà specifica di un oggetto.

Per una paronamica dei diversi elementi del sistema di animazione di three.js consultare l'articolo "Sistema di animazione" nella sezione "Prossimi Passi" del manuale.

A differenza della gerarchia di animazione del [link:https://github.com/mrdoob/three.js/wiki/JSON-Model-format-3 modello JSON], `KeyframeTrack` non memorizza i suoi singoli keyframe come oggetti in un array "keys" (che contiene i tempi e i valori di ciascun frame in un unico posto).

Invece ci sono sempre due array in un `KeyframeTrack`: l'array [page:.times times] memorizza i valori temporali per tutti i keyframe di questa traccia in ordine sequenziale e l'array [page:.values values] contiene i corrispondenti valori di modifica della proprietà animata.

Un singolo valore, appartenente ad un determinato momento, non può essere solo un semplice numero, ma (per esempio) un vettore (se una posizione è animata) o un quaternione (se una rotazione è animata). Per questo motivo l'array values (che è anche un array flat) potrebbe essere tre o quattro volte più lungo dell'array times.

In corrispondenza dei diversi tipi possibili di valori animati esistono diverse sottoclassi di `KeyframeTrack`, che ereditano la maggior parte delle proprietà e dei metodi:

- [page:BooleanKeyframeTrack]
- [page:ColorKeyframeTrack]
- [page:NumberKeyframeTrack]
- [page:QuaternionKeyframeTrack]
- [page:StringKeyframeTrack]
- [page:VectorKeyframeTrack]

Alcuni esempi di come creare manualmente [page:AnimationClip AnimationClip] con diversi tipi di KeyframeTrack possono essere trovati nel file [link:https://threejs.org/examples/jsm/animation/AnimationClipCreator.js AnimationClipCreator].

Poiché i valori espliciti sono solo specifici per i punti temporali discreti memorizzati nell'array times tutti i valori itermedi devono essere interpolati.

Il nome della track è importante per il collegamento di questa track con una proprietà specifica del nodo animato (creato da [page:PropertyBinding]).

## Costruttore

### [name]( [param:String name], [param:Array times], [param:Array values], [param:Constant interpolation] )

[page:String name] - l'identificativo per `KeyframeTrack`.
[page:Array times] - un array di times di keyframe, convertito internamente a [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array].
[page:Array values] - un array con i valori relativi all'array times, convertito internamente a [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array].
[page:Constant interpolation] - il tipo di interpolazione da usare. Vedi [page:Animation Animation Constants] per i possibili valori. L'impostazione predefinita è [page:Animation InterpolateLinear].

## Proprietà

### [property:String name]

Il nome della track può riferirsi a morph targets o [page:SkinnedMesh bones] o possibilmente ad altri valori all'interno dell'oggetto animato. Vedi [page:PropertyBinding.parseTrackName] per le forme di stringhe che possono essere parsate per il property binding:

Il nome può specificare il nodo utilizzando il suo nome o il suo uuid (anche se deve trovarsi nel sottoalbero del nodo del grafo della scena passato al mixer). Oppure, se il nome della track inizia con un punto, la track si applica al nodo root che è stato passato nel mixer.

Solitamente dopo il nodo una proprietà viene specificata direttamente. Ma si può anche specificare una sottoproprietà, come .rotation[x], se si vuole guidare il componente X della rotazione tramite una traccia float.

Si possono anche specificare ossa (bones) o multimateriali usando il nome di un oggetto, per esempio: .bones[R_hand].scale; il canale rosso del colore diffuso del quarto materiale in un array di materiali - come ulteriore esempio - è accessibile con .materials[3].diffuse[r].

Il PropertyBinding risolverà anche i nomi dei morph target, per esempio: .morphTargetInfluences[run].

Nota: Il nome della traccia non deve essere per forza univoco. Più tracce possono guidare la stessa proprietà. Il risultato deve essere basato su una miscela ponderata tra le tracce multiple in base ai pesi delle rispettive azioni.

### [property:Float32Array times]

Un [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array], convertito dall'array times passato nel costruttore.

### [property:Float32Array values]

Un [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array], convertito dall'array values passato nel costruttore.

### [property:Constant DefaultInterpolation]

Il tipo predefinito di interpolazione: [page:Animation InterpolateLinear].

### [property:Constant TimeBufferType ]

[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array], il tipo di buffer internamente utilizzato per i tempi.

### [property:Constant ValueBufferType ]

[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array], il tipo di buffer internamente utilizzato per i valori.

## Metodi

### [method:KeyframeTrack clone]()

Restituisce una copia di questa traccia.

### [method:Interpolant createInterpolant]()

Crea una [page:LinearInterpolant LinearInterpolant], [page:CubicInterpolant CubicInterpolant] o [page:DiscreteInterpolant DiscreteInterpolant], a seconda del valore del parametro di interpolazione passato nel costruttore.

### [method:Interpolant getInterpolation]()

Restituisce il tipo di interpolazione.

### [method:Number getValueSize]()

Restituisce la dimensione di ongi value (ovvero la lunghezza dell'array [page:.values values] diviso la lunghezza dell'array [page:.times times]).

### [method:DiscreteInterpolant InterpolantFactoryMethodDiscrete]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )

Crea un nuovo [page:DiscreteInterpolant DiscreteInterpolant] dai [page:KeyframeTrack.times tempi] e dai [page:KeyframeTrack.times valori]. È possibile passare un Float32Array che riceverà i risultati. Altrimenti, verrà creato automaticamente un nuovo array di dimensioni appropriate.

### [method:LinearInterpolant InterpolantFactoryMethodLinear]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )

Crea un nuovo [page:LinearInterpolant LinearInterpolant] dai [page:KeyframeTrack.times tempi] e dai [page:KeyframeTrack.times valori].È possibile passare un Float32Array che riceverà i risultati. Altrimenti, verrà creato automaticamente un nuovo array di dimensioni appropriate.

### [method:CubicInterpolant InterpolantFactoryMethodSmooth]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )

Crea un nuovo [page:CubicInterpolant CubicInterpolant] dai [page:KeyframeTrack.times tempi] e dai [page:KeyframeTrack.times valori].È possibile passare un Float32Array che riceverà i risultati. Altrimenti, verrà creato automaticamente un nuovo array di dimensioni appropriate.

### [method:this optimize]()

Rimuove le chiavi sequenziali equivalenti, che sono comuni nelle sequenze morph target.

### [method:this scale]()

Scala tutti i tempi del keyframe di un fattore.
Nota: Questo metodo è utile, per esempio, per le conversioni ad un determinato rate di frame per secondo (come avviene internamente da [page:AnimationClip.CreateFromMorphTargetSequence animationClip.CreateFromMorphTargetSequence]).

### [method:this setInterpolation]( [param:Constant interpolationType] )

Imposta il tipo di interpolazione. Vedi [page:Animation Animation Constants] per le opzioni.

### [method:this shift]( [param:Number timeOffsetInSeconds] )

Sposta tutti i keyframe avanti o indietro nel tempo.

### [method:this trim]( [param:Number startTimeInSeconds], [param:Number endTimeInSeconds] )

Rimuove tutti i keyframe prima di `startTime` e dopo `endTime`, senza modificare alcun valore nell'intervallo [`startTime`, `endTime`].

### [method:Boolean validate]()

Esegue una convalida minima delle tracce. Restituisce true se è valido.

Questo metodo registra gli errori nella console, se una traccia è vuota, se la dimensione del valore non è valida, se un elemento nell'array [page:.times times] o nell'array [page:.values values] non è un numero valido o se gli elementi nell'array times non sono ordinati.

## Metodi statici

### [method:JSON toJSON]( [param:KeyframeTrack track] )

Converte la traccia in JSON.

## Source

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]