123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363 |
- <!DOCTYPE html>
- <html lang="fr">
- <head>
- <meta charset="utf-8" />
- <base href="../../../" />
- <script src="page.js"></script>
- <link type="text/css" rel="stylesheet" href="page.css" />
- </head>
- <body>
- <h1>[name]</h1>
- <p class="desc">
- Les AnimationActions programment la performance des animations qui sont stockées dans
- [page:AnimationClip AnimationClips].<br /><br />
- Note: La plupart des méthodes d'AnimationAction peuvent être chainées.<br /><br />
- Pour avoir un aperçu des différents éléments du système d'animation de three.js, consultez
- l'article "Système d'Animation" dans la section "Étapes Suivantes" du manuel.
- </p>
- <h2>Constructeur</h2>
- <h3>[name]( [param:AnimationMixer mixer], [param:AnimationClip clip], [param:Object3D localRoot] )</h3>
- <p>
- [page:AnimationMixer mixer] - l'`AnimationMixer` contrôlé par cette action.<br />
- [page:AnimationClip clip] - l`AnimationClip` qui contient les données d'animation pour cette action.<br />
- [page:Object3D localRoot] - l'objet racine sur lequel est appliqué l'action.<br /><br />
- Note: Au lieu d'appeler ce constructeur directement, vous devriez instantier un AnimationAction avec
- [page:AnimationMixer.clipAction] étant donné que cette méthode applique une mise en cache pour obtenir de meilleures performances.
- </p>
- <h2>Propriétés</h2>
- <h3>[property:Boolean clampWhenFinished]</h3>
- <p>
- Si `clampWhenFinished` est mis à true l'animation sera automatiquement [page:.paused mise en pause]
- à son dernier frame.<br /><br />
- Si `clampWhenFinished` est mis à false, [page:.enabled enabled] sera automatiquement reglé sur
- false quand la dernière boucle de l'action sera terminée, afin que cette action n'ai pas plus
- d'impact.<br /><br />
- La valeur par défaut est false.<br /><br />
- Note: `clampWhenFinished` n'a pas d'impact si l'action est interrompue (il n'a d'impact que si
- la dernière boucle de l'action s'est réellement terminée).
- </p>
- <h3>[property:Boolean enabled]</h3>
- <p>
- Régler `enabled` sur `false` désactive cette action, afin qu'elle n'ai aucun impact. La valeur par défaut est `true`.<br /><br />
- Quand l'action est réactivée, l'animation continue depuis son [page:.time time] actuel
- (Régler `enabled` sur `false` ne relance pas l'action).<br /><br />
- Note: Régler `enabled` sur `true` ne redémarre pas automatiquement l'action. Régler `enabled`
- sur `true` ne redémarrera l'action immédiatement que si les conditions suivantes sont remplies:
- [page:.paused paused] est à `false`, l'action n'a pas été désactivée (en
- exécutant un [page:.stop stop] ou un [page:.reset reset]), et ni [page:.weight weight]
- ni [page:.timeScale timeScale] ne sont à `0`.
- </p>
- <h3>[property:Number loop]</h3>
- <p>
- Le mode répeter (peut-être changé avec [page:.setLoop setLoop]). Sa valeur par défaut est
- [page:Animation THREE.LoopRepeat] (avec un nombre infini de répétitions [page:.repetitions repetitions])<br /><br />
- Doit être une de ces constantes:<br /><br />
- [page:Animation THREE.LoopOnce] - joue le clip une fois,<br />
- [page:Animation THREE.LoopRepeat] - joue le clip le nombre choisi de `répetitions`,
- en sautant à chaque fois de la fin du clip à son début,<br />
- [page:Animation THREE.LoopPingPong] - joue le clip le nombre choisi de `répetitions`,
- alternant entre lecture du début vers la fin et lecture de la fin vers le début.
- </p>
- <h3>[property:Boolean paused]</h3>
- <p>
- Régler `paused` sur `true` met l'exécution de l'action en pause en mettant l'échelle temporelle effective
- à `0`. La valeur par défaut est `false`.<br /><br />
- </p>
- <h3>[property:Number repetitions]</h3>
- <p>
- Le nombre de répétitions de l'[page:AnimationClip] actuel réalisées durant cette action.
- Peut-être paramétré depuis [page:.setLoop setLoop]. La valeur par défaut est `Infinity`.<br /><br />
- Changer ce nombre n'a aucun effet, si le [page:.loop loop mode] est réglé sur
- [page:Animation THREE.LoopOnce].
- </p>
- <h3>[property:Number time]</h3>
- <p>
- Le temps local de cette action (en secondes, en commençant par `0`).<br /><br />
- La valeur peut-être restreinte à `0...clip.duration` (selon l'état de la boucle). Il peut être
- mis à l'échelle relativement à celui du mixer global en changeant [page:.timeScale timeScale] (en utilisant
- [page:.setEffectiveTimeScale setEffectiveTimeScale] ou [page:.setDuration setDuration]).<br />
- </p>
- <h3>[property:Number timeScale]</h3>
- <p>
- Facteur de mise à l'échelle pour le [page:.time time]. Une valeur de `0` cause la mise en pause de l'animation. Une valeur
- négative fera jouer l'animation à l'envers . La valeur par défaut est `1`.<br /><br />
- Les propriétés/méthodes concernant `timeScale` (respectivement `time`) sont:
- [page:.getEffectiveTimeScale getEffectiveTimeScale],
- [page:.halt halt],
- [page:.paused paused],
- [page:.setDuration setDuration],
- [page:.setEffectiveTimeScale setEffectiveTimeScale],
- [page:.stopWarping stopWarping],
- [page:.syncWith syncWith],
- [page:.warp warp].
- </p>
- <h3>[property:Number weight]</h3>
- <p>
- Le degré d'importance d'une action (compris dans l'intervalle `[0, 1]`). Les valeurs entre `0` (aucun impact)
- et 1 (impact total) peuvent être utilisées pour mélanger plusieurs actions. La valeur par défaut est `1`. <br /><br />
- Les propriétés/méthodes concernant `weight` sont:
- [page:.crossFadeFrom crossFadeFrom],
- [page:.crossFadeTo crossFadeTo],
- [page:.enabled enabled],
- [page:.fadeIn fadeIn],
- [page:.fadeOut fadeOut],
- [page:.getEffectiveWeight getEffectiveWeight],
- [page:.setEffectiveWeight setEffectiveWeight],
- [page:.stopFading stopFading].
- </p>
- <h3>[property:Boolean zeroSlopeAtEnd]</h3>
- <p>
- Permet une interpolation fluide sans avoir de clips séparés pour le début, les répétitions et la fin. La valeur par défaut est `true`.
- </p>
- <h3>[property:Boolean zeroSlopeAtStart]</h3>
- <p>
- Permet une interpolation fluide sans avoir de clips séparés pour le début, les répétitions et la fin. La valeur par défaut est `true`.
- </p>
- <h2>Méthodes</h2>
- <h3>[method:this crossFadeFrom]( [param:AnimationAction fadeOutAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3>
- <p>
- Provoque l'[page:.fadeIn apparition] de cette action, en faisant disparaître une autre action simultanément, durant
- l'intervalle de temps passée en paramètre. Cette méthode peut être chaînée.<br /><br />
- Si warpBoolean est à true, un [page:.warp warping] additionnel (changement graduel de l'échelle temporelle)
- sera appliqué.<br /><br />
- Note: Comme avec `fadeIn`/`fadeOut`, le fading commence/termine avec un weight à 1.
- </p>
- <h3>[method:this crossFadeTo]( [param:AnimationAction fadeInAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3>
- <p>
- Provoque la [page:.fadeIn disparition] de cette action, en faisant apparaître une autre action simultanément, durant
- l'intervalle de temps passée en paramètre. Cette méthode peut être chaînée.<br /><br />
- Si warpBoolean est à true, un [page:.warp warping] additionnel (changement graduel de l'échelle temporelle)
- sera appliqué.<br /><br />
- Note: Comme avec `fadeIn`/`fadeOut`, le fading commence/termine avec un weight à 1.
- </p>
- <h3>[method:this fadeIn]( [param:Number durationInSeconds] )</h3>
- <p>
- Augmente graduellement le [page:.weight weight] de cette action de `0` à `1`, durant
- l'intervalle de temps passée en paramètre. Cette méthode peut être chaînée.
- </p>
- <h3>[method:this fadeOut]( [param:Number durationInSeconds] )</h3>
- <p>
- Diminue graduellement le [page:.weight weight] de cette de `1` à `0`, durant
- l'intervalle de temps passée en paramètre. Cette méthode peut être chaînée.
- </p>
- <h3>[method:Number getEffectiveTimeScale]()</h3>
- <p>
- Renvoie l'échelle temporelle effective (en prenant en compte l'état actuel du warping et de
- [page:.paused paused]).
- </p>
- <h3>[method:Number getEffectiveWeight]()</h3>
- <p>
- Renvoie le weight effectif (en prenant en compte l'état actuel du fondu et de
- [page:.enabled enabled]).
- </p>
- <h3>[method:AnimationClip getClip]()</h3>
- <p>
- Renvoie le clip qui contient les données d'animation pour cette action.
- </p>
- <h3>[method:AnimationMixer getMixer]()</h3>
- <p>
- Renvoie le mixer qui est responsable de jouer cette action.
- </p>
- <h3>[method:Object3D getRoot]()</h3>
- <p>
- Renvoie l'objet racine sur lequel l'action est appliquée.
- </p>
- <h3>[method:this halt]( [param:Number durationInSeconds] )</h3>
- <p>
- Diminue la vitesse de l'animation jusqu'à `0` en diminuant le [page:.timeScale timeScale] graduellement
- (en commençant depuis sa valeur actuelle), durant l'intervalle de temps passée en paramètre. Cette méthode peut être chaînée.
- </p>
- <h3>[method:Boolean isRunning]()</h3>
- <p>
- Renvoie true si le [page:.time time] de l'action est en cours.<br /><br />
- En plus d'être activé dans le mixer (see [page:.isScheduled isScheduled]) les conditions suivantes doivent être remplies:
- [page:.paused paused] est à faux, [page:.enabled enabled] est à true,
- [page:.timeScale timeScale] est différent de `0`, et un départ différé n'est pas programmé
- ([page:.startAt startAt]).<br /><br />
- Note: le fait que `isRunning` soit à true n'indique pas nécessairement que l'action est visible.
- C'est seulement le cas si le [page:.weight weight] est reglé sur une valeur non-nulle.
- </p>
- <h3>[method:Boolean isScheduled]()</h3>
- <p>
- Renvoie true, si cette action est activée dans le mixer.<br /><br />
- Note: Cela n'indique pas nécessairement que l'action est en cours d'éxécution (voir les conditions additionnelles
- pour [page:.isRunning isRunning]).
- </p>
- <h3>[method:this play]()</h3>
- <p>
- Indique au mixer d'activer cette action. Cette méthode peut être chaînée.<br /><br />
- Note: Activer cette action ne signifie pas nécessairement que l'animation démarrera directement:
- Si l'action s'était déjà terminée avant (en atteignant la fin de sa dernière boucle), ou si une durée
- pour un départ différé a été renseignée (via [page:.startAt startAt]), un [page:.reset reset] doit être
- éxécuté avant. Quelques autres paramètres ([page:.paused paused]=true, [page:.enabled enabled]=false,
- [page:.weight weight]=0, [page:.timeScale timeScale]=0) peuvent empêcher cette animation d'être jouée,
- également.
- </p>
- <h3>[method:this reset]()</h3>
- <p>
- Réinitialise l'action. Cette méthode peut être chaînée.<br /><br />
- Cette méthode passe [page:.paused paused] à false, [page:.enabled enabled] à true,
- [page:.time time] à `0`, annule tous les fondus et warping programmés, retire le compteur
- de boucles interne et les départs différés programmés.<br /><br />
- Note: .`reset` est toujours appelé par [page:.stop stop], mais .`reset` n'appelle pas .`stop` de lui-même.
- Cela signifie que: Si vous voulez à la fois, réinitialiser et stopper, n'appellez pas .`reset`; mais .`stop`.
- </p>
- <h3>[method:this setDuration]( [param:Number durationInSeconds] )</h3>
- <p>
- Renseigne la durée pour une seule boucle de cette action (en modifiant [page:.timeScale timeScale]
- et en stoppant tous les warpings programmés). Cette méthode peut être chaînée.
- </p>
- <h3>[method:this setEffectiveTimeScale]( [param:Number timeScale] )</h3>
- <p>
- Renseigne le [page:.timeScale timeScale] et stoppe tous les warpings programmés. Cette méthode peut être chaînée.<br /><br />
- Si [page:.paused paused] est à false, l'échelle temporelle effective (propriété interne) sera également
- mise à cette valeur; par ailleurs l'échelle temporelle effective (affectant directement l'animation à
- cet instant) sera mis à `0`.<br /><br />
- Note: .`paused` ne sera pas automatiquement mis à `true`, si le .`timeScale` est mis à `0` par
- cette méthode.
- </p>
- <h3>[method:this setEffectiveWeight]( [param:Number weight] )</h3>
- <p>
- Renseigne le [page:.weight weight] et stop tous les fondus programmés. Cette méthode peut être chaînée.<br /><br />
- Si [page:.enabled enabled] est à true, le weight effectif (propriété interne) sera également mis
- à cette valeur; Par ailleurs le weight effectif (affectant directement l'action à cet instant)
- sera mis à `0`.<br /><br />
- Note: .`enabled` ne sera pas automatiquement mis à `false`, si le .`weight` est mis à `0` par
- cette méthode.
- </p>
- <h3>[method:this setLoop]( [param:Number loopMode], [param:Number repetitions] )</h3>
- <p>
- Renseigne le [page:.loop loop mode] et le nombre de [page:.repetitions répétitions]. Cette méthode
- peut être chaînée.
- </p>
- <h3>[method:this startAt]( [param:Number startTimeInSeconds] )</h3>
- <p>
- Définis le temps pour un départ différé (généralement [page:AnimationMixer.time] +
- deltaTimeInSeconds). Cette méthode peut être chaînée.<br /><br />
- Note: Cette action ne commencera qu'à un temps donné, si .`startAt` est chaîné avec
- [page:.play play], ou si l'action a déjà été activée dans le mixer (par un appel précédent
- de .`play`, sans l'avoir stoppée ou réinitialisée entre temps).
- </p>
- <h3>[method:this stop]()</h3>
- <p>
- Indique au mixer de désactiver cette action. Cette méthode peut être chaînée.<br /><br />
- L'action sera immédiatement stoppée et complètement [page:.reset reset].<br /><br />
- Note: Vous pouvez stopper simultanément toutes les actions actives d'un même mixer via
- [page:AnimationMixer.stopAllAction mixer.stopAllAction].
- </p>
- <h3>[method:this stopFading]()</h3>
- <p>
- Stoppe tous les [page:.fadeIn fondus] programmés qui sont appliqués à cette action. Cette méthode peut être
- chaînée.
- </p>
- <h3>[method:this stopWarping]()</h3>
- <p>
- Stoppe tous les [page:.warp warping] programmés qui sont appliqués à cette action. Cette méthode peut être
- chaînée.
- </p>
- <h3>[method:this syncWith]( [param:AnimationAction otherAction] )</h3>
- <p>
- Synchronise cette action avec l'action passée en paramètre. Cette méthode peut être chaînée.<br /><br />
- La synchronisation est faite en dupliquant les valeurs du [page:.time time] et du [page:.timeScale timeScale] de l'autre action
- (stoppant tous les warpings programmés).<br /><br />
- Note: Les changements futurs du `time` et du `timeScale` de l'autre action ne seront pas détéctés.
- </p>
- <h3>[method:this warp]( [param:Number startTimeScale], [param:Number endTimeScale], [param:Number durationInSeconds] )</h3>
- <p>
- Change la vitesse de lecture, durant l'intervalle temporelle passée en paramètre, en modifiant le
- [page:.timeScale timeScale] graduellement depuis `startTimeScale` jusqu'à `endTimeScale`. Cette méthode
- peut être chaînée.
- </p>
- <h2>Évènements</h2>
- <p class="desc">
- Il y a deux évènements indiquant quand une boucle de l'animation ou l'animation elle-même s'est terminée. Vous pouvez y réagir avec:
- </p>
- <code>
- mixer.addEventListener( 'loop', function( e ) { …} ); // properties of e: type, action and loopDelta
- mixer.addEventListener( 'finished', function( e ) { …} ); // properties of e: type, action and direction
- </code>
- <h2>Source</h2>
- <p>
- [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
- </p>
- </body>
- </html>
|