forked from mrdoob/three.js
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Docs: Portuguese - Animation...Constants translation (mrdoob#24514)
- Loading branch information
1 parent
11cf35c
commit 61c5d0a
Showing
38 changed files
with
4,024 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,359 @@ | ||
| <!DOCTYPE html> | ||
| <html lang="pt-br"> | ||
| <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"> | ||
| AnimationAction programa o desempenho das animações que são armazenadas em | ||
| [page:AnimationClip AnimationClips].<br /><br /> | ||
|
|
||
| Nota: A maioria dos métodos da AnimationAction podem ser encadeados.<br /><br /> | ||
|
|
||
| Para obter uma visão geral dos diferentes elementos do sistema de animação three.js, consulte o | ||
| artigo "Sistema de animação" na seção "Próximos Passos" do manual. | ||
| </p> | ||
|
|
||
|
|
||
| <h2>Construtor</h2> | ||
|
|
||
| <h3>[name]( [param:AnimationMixer mixer], [param:AnimationClip clip], [param:Object3D localRoot] )</h3> | ||
| <p> | ||
| [page:AnimationMixer mixer] - o `AnimationMixer` que é controlado por esta ação.<br /> | ||
| [page:AnimationClip clip] - o `AnimationClip` que contém os dados da animação para esta ação.<br /> | ||
| [page:Object3D localRoot] - o objeto raiz no qual esta ação é executada.<br /><br /> | ||
|
|
||
| Nota: Ao invés de chamar este construtor diretamente, você deve instanciar um AnimationAction com | ||
| [page:AnimationMixer.clipAction] uma vez que este método fornece cache para melhor desempenho. | ||
| </p> | ||
|
|
||
|
|
||
| <h2>Propriedades</h2> | ||
|
|
||
| <h3>[property:Boolean clampWhenFinished]</h3> | ||
| <p> | ||
| Se `clampWhenFinished` estiver definido como true a animação será automaticamente [page:.paused pausada] | ||
| em seu último quadro.<br /><br /> | ||
|
|
||
| Se `clampWhenFinished` estiver definido como false, [page:.enabled enabled] será trocado automaticamente | ||
| para false quando o último loop da ação terminar, para que esta ação não tenha mais impacto.<br /><br /> | ||
|
|
||
| O padrão é falso.<br /><br /> | ||
|
|
||
| Nota: `clampWhenFinished` não tem impacto se a ação for interrompida (só tem efeito se | ||
| seu último loop realmente terminou). | ||
| </p> | ||
|
|
||
| <h3>[property:Boolean enabled]</h3> | ||
| <p> | ||
| Definir `enabled` como `false` desativa esta ação, para que não tenha efeito. O padrão é `true`.<br /><br /> | ||
|
|
||
| Quando a ação é reativada, a animação continua de seu [page:.time time] (tempo) | ||
| (configurar `enabled` para `false` não redefine a ação).<br /><br /> | ||
|
|
||
| Nota: Definir `enabled` como `true` não reinicia automaticamente a animação. Configurar `enabled` | ||
| para `true` só reiniciará a animação imediatamente se a seguinte condição for atendida: | ||
| [page:.paused paused] é `false`, esta ação não foi desativada nesse meio tempo | ||
| (executando um comando [page:.stop stop] ou [page:.reset reset]), e nem [page:.weight weight] | ||
| nem [page:.timeScale timeScale] são `0`. | ||
| </p> | ||
|
|
||
| <h3>[property:Number loop]</h3> | ||
| <p> | ||
| O modo de looping (pode ser alterado com [page:.setLoop setLoop]). O padrão é | ||
| [page:Animation THREE.LoopRepeat] (com um número infinito de [page:.repetitions repetitions] (repetições)).<br /><br /> | ||
|
|
||
| Deve ser uma destas constantes:<br /><br /> | ||
| [page:Animation THREE.LoopOnce] - reproduzindo o clipe uma vez,<br /> | ||
| [page:Animation THREE.LoopRepeat] - reproduzindo o clipe com o número escolhido de `repetições`, | ||
| cada vez pulando do final do clipe diretamente para o início,<br /> | ||
| [page:Animation THREE.LoopPingPong] - reproduzindo o clipe com o número escolhido de `repetições`, | ||
| tocando alternadamente para frente e para trás. | ||
| </p> | ||
|
|
||
| <h3>[property:Boolean paused]</h3> | ||
| <p> | ||
| Definir `paused` como `true` pausa a execução da ação definindo a escala de tempo efetiva | ||
| para '0'. O padrão é `false`.<br /><br /> | ||
| </p> | ||
|
|
||
| <h3>[property:Number repetitions]</h3> | ||
| <p> | ||
| O número de repetições do [page:AnimationClip] ao longo desta ação. | ||
| Pode ser definido através de [page:.setLoop setLoop]. O padrão é `Infinity`.<br /><br /> | ||
| Definir este número não tem efeito se o [page:.loop modo de loop] está configurado como | ||
| [page:Animation THREE.LoopOnce]. | ||
| </p> | ||
|
|
||
| <h3>[property:Number time]</h3> | ||
| <p> | ||
| O tempo local desta ação (em segundos, começando com `0`).<br /><br /> | ||
|
|
||
| O valor é fixado ou encapsulado em `0...clip.duration` (de acordo com o estado do loop). Pode ser | ||
| dimensionado em relação ao tempo do mixer global, alterando [page:.timeScale timeScale] (usando | ||
| [page:.setEffectiveTimeScale setEffectiveTimeScale] ou [page:.setDuration setDuration]).<br /> | ||
| </p> | ||
|
|
||
| <h3>[property:Number timeScale]</h3> | ||
| <p> | ||
| Fator de escala para o [page:.time tempo]. Um valor de `0` faz com que a animação seja pausada. Valores | ||
| negativos fazem com que a animação seja reproduzida para trás. O padrão é `1`.<br /><br /> | ||
| Propriedades/métodos referentes a `timeScale` (respectivamente `time`) são: | ||
| [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> | ||
| O grau de influência desta ação (no intervalo `[0, 1]`). Valores entre '0' (sem impacto) | ||
| e 1 (impacto total) podem ser usados para mesclar várias ações. O padrão é `1`. <br /><br /> | ||
| Propriedades/métodos relativos a `weight` são: | ||
| [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> | ||
| Ativa interpolação suave sem separar clipes por início, loop e fim. O padrão é `true`. | ||
| </p> | ||
|
|
||
| <h3>[property:Boolean zeroSlopeAtStart]</h3> | ||
| <p> | ||
| Ativa interpolação suave sem separar clipes por início, loop e fim. O padrão é `true`. | ||
| </p> | ||
|
|
||
|
|
||
| <h2>Métodos</h2> | ||
|
|
||
|
|
||
| <h3>[method:this crossFadeFrom]( [param:AnimationAction fadeOutAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3> | ||
| <p> | ||
| Faz com que a ação [page:.fadeIn fade in] esmaeça outra ação simultaneamente, dentro do | ||
| intervalo de tempo passado. Este método pode ser encadeado.<br /><br /> | ||
|
|
||
| Se warpBoolean for true, [page:.warp warping] (mudanças graduais das escalas de tempo) adicional | ||
| será aplicado.<br /><br /> | ||
|
|
||
| Nota: Como em `fadeIn`/`fadeOut`, o desvanecimento começa/termina com um peso de 1. | ||
| </p> | ||
|
|
||
| <h3>[method:this crossFadeTo]( [param:AnimationAction fadeInAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3> | ||
| <p> | ||
| Faz com que a ação [page:.fadeOut fade out] esmaeça em outra ação simultaneamente, dentro do | ||
| intervalo de tempo passado. Este método pode ser encadeado.<br /><br /> | ||
| Se warpBoolean for true, [page:.warp warping] (mudanças graduais das escalas de tempo) adicional | ||
| será aplicado.<br /><br /> | ||
|
|
||
| Nota: Como com `fadeIn`/`fadeOut`, o desvanecimento começa/termina com um peso de 1. | ||
| </p> | ||
|
|
||
| <h3>[method:this fadeIn]( [param:Number durationInSeconds] )</h3> | ||
| <p> | ||
| Aumenta o [page:.weight weight] desta ação gradualmente de `0` para `1`, dentro do intervalo de | ||
| tempo decorrido. Este método pode ser encadeado. | ||
| </p> | ||
|
|
||
| <h3>[method:this fadeOut]( [param:Number durationInSeconds] )</h3> | ||
| <p> | ||
| Diminui o [page:.weight weight] desta ação gradualmente de `1` para `0`, dentro do intervalo de | ||
| tempo decorrido. Este método pode ser encadeado. | ||
| </p> | ||
|
|
||
| <h3>[method:Number getEffectiveTimeScale]()</h3> | ||
| <p> | ||
| Retorna a escala de tempo efetiva (considerando os estados atuais de distorção (warping) e | ||
| [page:.paused paused]). | ||
| </p> | ||
|
|
||
| <h3>[method:Number getEffectiveWeight]()</h3> | ||
| <p> | ||
| Retorna o peso efetivo (considerando os estados atuais de desvanecimento (fading) e | ||
| [page:.enabled enabled]). | ||
| </p> | ||
|
|
||
| <h3>[method:AnimationClip getClip]()</h3> | ||
| <p> | ||
| Retorna o clipe que contém os dados de animação para esta ação. | ||
| </p> | ||
|
|
||
| <h3>[method:AnimationMixer getMixer]()</h3> | ||
| <p> | ||
| Retorna o mixer que é responsável por reproduzir esta ação. | ||
| </p> | ||
|
|
||
| <h3>[method:Object3D getRoot]()</h3> | ||
| <p> | ||
| Retorna o objeto raiz no qual esta ação é executada. | ||
| </p> | ||
|
|
||
| <h3>[method:this halt]( [param:Number durationInSeconds] )</h3> | ||
| <p> | ||
| Desacelera a velocidade desta animação para '0' diminuindo [page:.timeScale timeScale] gradualmente | ||
| (a partir de seu valor atual), dentro do intervalo de tempo decorrido. Este método pode ser encadeado. | ||
| </p> | ||
|
|
||
| <h3>[method:Boolean isRunning]()</h3> | ||
| <p> | ||
| Retorna verdadeiro se a ação [page:.time time] estiver em execução no momento.<br /><br /> | ||
|
|
||
| Além de ser ativado no mixer (consulte [page:.isScheduled isScheduled]), as seguintes condições devem ser atendidas: | ||
| [page:.paused paused] é igual a false, [page:.enabled enabled] é igual a true, | ||
| [page:.timeScale timeScale] é diferente de `0` e não há agendamento para início atrasado | ||
| ([page:.startAt startAt]).<br /><br /> | ||
|
|
||
| Nota: `isRunning` sendo true não significa necessariamente que a animação pode realmente ser vista. | ||
| Este é apenas o caso, se [page:.weight weight] for definido adicionalmente para um valor diferente de zero. | ||
| </p> | ||
|
|
||
| <h3>[method:Boolean isScheduled]()</h3> | ||
| <p> | ||
| Retorna verdadeiro, se esta ação estiver ativada no mixer.<br /><br /> | ||
| Nota: Isso não significa necessariamente que a animação está realmente em execução (compare as | ||
| condições para [page:.isRunning isRunning]). | ||
| </p> | ||
|
|
||
| <h3>[method:this play]()</h3> | ||
| <p> | ||
| Diz ao mixer para ativar a ação. Este método pode ser encadeado.<br /><br /> | ||
|
|
||
| Nota: A ativação desta ação não significa necessariamente que a animação começará imediatamente: | ||
| Se a ação já havia terminado antes (chegando ao final de seu último loop), ou se o tempo | ||
| para um início atrasado foi definido (via [page:.startAt startAt]), um [page:.reset reset] deve ser | ||
| executado primeiro. Algumas outras configurações ([page:.paused paused]=true, [page:.enabled enabled]=false, | ||
| [page:.weight weight]=0, [page:.timeScale timeScale]=0) podem também impedir a reprodução da animação. | ||
| </p> | ||
|
|
||
| <h3>[method:this reset]()</h3> | ||
| <p> | ||
| Redefine a ação. Este método pode ser encadeado.<br /><br /> | ||
|
|
||
| Este método define [page:.paused paused] como false, [page:.enabled enabled] como true, | ||
| [page:.time time] para `0`, interrompe qualquer desvanecimento e distorção programados e remove a | ||
| contagem de loop e agendamento para início atrasado.<br /><br /> | ||
|
|
||
| Nota: .`reset` é sempre chamado por [page:.stop stop], mas .`reset` não chama .`stop` em si. | ||
| Isso significa: Se você quer ambos, resetar e parar, não chame .`reset`; chame .`stop` em vez disso. | ||
| </p> | ||
|
|
||
| <h3>[method:this setDuration]( [param:Number durationInSeconds] )</h3> | ||
| <p> | ||
| Define a duração de um único loop desta ação (ajustando [page:.timeScale timeScale] | ||
| e parando qualquer distorção programada). Este método pode ser encadeado. | ||
| </p> | ||
|
|
||
| <h3>[method:this setEffectiveTimeScale]( [param:Number timeScale] )</h3> | ||
| <p> | ||
| Define [page:.timeScale timeScale] e interrompe qualquer distorção (warping) programada. Este método pode ser encadeado.<br /><br /> | ||
|
|
||
| Se [page:.paused paused] for falso, a escala de tempo efetiva (uma propriedade interna) também será definida | ||
| com este valor; caso contrário, a escala de tempo efetiva (afetando diretamente a animação | ||
| neste momento) será definida como '0'.<br /><br /> | ||
|
|
||
| Nota: .`paused` não será alterado para `true` automaticamente, se .`timeScale` for definido como `0` por | ||
| este método. | ||
| </p> | ||
|
|
||
| <h3>[method:this setEffectiveWeight]( [param:Number weight] )</h3> | ||
| <p> | ||
| Define o [page:.weight weight] e interrompe qualquer desvanecimento (fading) programado. Este método pode ser encadeado.<br /><br /> | ||
|
|
||
| Se [page:.enabled enabled] for true, o peso (weight) efetivo (uma propriedade interna) também será definido | ||
| com este valor; caso contrário, o peso efetivo (afetando diretamente a animação neste momento) | ||
| será definido como '0'.<br /><br /> | ||
|
|
||
| Nota: .`enabled` não será alterado para `false` automaticamente, se .`weight` for definido como `0` com | ||
| este método. | ||
| </p> | ||
|
|
||
| <h3>[method:this setLoop]( [param:Number loopMode], [param:Number repetitions] )</h3> | ||
| <p> | ||
| Define o [page:.loop loop mode] e o número de [page:.repetitions repetitions]. Este método | ||
| pode ser encadeado. | ||
| </p> | ||
|
|
||
| <h3>[method:this startAt]( [param:Number startTimeInSeconds] )</h3> | ||
| <p> | ||
| Define o tempo para um início atrasado (geralmente passado como [page:AnimationMixer.time] + | ||
| deltaTimeInSeconds). Este método pode ser encadeado.<br /><br /> | ||
|
|
||
| Nota: A animação só começará em um dado momento se .`startAt` estiver encadeado com | ||
| [page:.play play], ou se a ação já foi ativada no mixer (por uma | ||
| chamada de .`play`, sem parar ou redefini-lo nesse meio tempo). | ||
| </p> | ||
|
|
||
| <h3>[method:this stop]()</h3> | ||
| <p> | ||
| Diz ao mixer para desativar esta ação. Este método pode ser encadeado.<br /><br /> | ||
|
|
||
| A ação será imediatamente interrompida e completamente [page:.reset resetada] (reset).<br /><br /> | ||
|
|
||
| Nota: Você pode parar todas as ações ativas no mesmo mixer de uma só vez usando | ||
| [page:AnimationMixer.stopAllAction mixer.stopAllAction]. | ||
| </p> | ||
|
|
||
| <h3>[method:this stopFading]()</h3> | ||
| <p> | ||
| Interrompe qualquer [page:.fadeIn fading] agendado que seria aplicado a esta ação. Este método pode ser | ||
| encadeado. | ||
| </p> | ||
|
|
||
| <h3>[method:this stopWarping]()</h3> | ||
| <p> | ||
| Interrompe qualquer [page:.warp warp] agendado que seria aplicado a esta ação. Este método pode ser | ||
| encadeado. | ||
| </p> | ||
|
|
||
| <h3>[method:this syncWith]( [param:AnimationAction otherAction] )</h3> | ||
| <p> | ||
| Sincroniza esta ação com a outra ação passada. Este método pode ser encadeado.<br /><br /> | ||
|
|
||
| A sincronização é feita definindo os valores [page:.time time] e [page:.timeScale timeScale] desta ação | ||
| aos valores correspondentes da outra ação (parando qualquer distorção (warping) programada).<br /><br /> | ||
|
|
||
| Nota: Alterações futuras do `time` e do `timeScale` da outra ação não serão detectadas. | ||
| </p> | ||
|
|
||
| <h3>[method:this warp]( [param:Number startTimeScale], [param:Number endTimeScale], [param:Number durationInSeconds] )</h3> | ||
| <p> | ||
| Altera a velocidade de reprodução, dentro do intervalo de tempo passado, modificando | ||
| [page:.timeScale timeScale] gradualmente de `startTimeScale` para `endTimeScale`. Este método pode | ||
| ser encadeado. | ||
| </p> | ||
|
|
||
|
|
||
| <h2>Eventos</h2> | ||
|
|
||
|
|
||
| <p class="desc"> | ||
| Existem dois eventos que indicam quando um único ciclo da ação ou toda a ação é concluída. | ||
| Você pode reagir a eles com: | ||
| </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> |
Oops, something went wrong.