AnimationClip.html 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145
  1. <!DOCTYPE html>
  2. <html lang="pt-br">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body>
  10. <h1>[name]</h1>
  11. <p class="desc">
  12. Um AnimationClip é um conjunto reutilizável de keyframe tracks que representam uma animação.<br /><br />
  13. Para obter uma visão geral dos diferentes elementos do sistema de animação three.js, consulte o
  14. artigo "Sistema de animação" na seção "Próximos Passos" do manual.
  15. </p>
  16. <h2>Construtor</h2>
  17. <h3>[name]( [param:String name], [param:Number duration], [param:Array tracks] )</h3>
  18. <p>
  19. [page:String name] - um nome para este clipe.<br />
  20. [page:Number duration] - a duração deste clipe (em segundos). Se for passado um valor negativo,
  21. a duração será calculada a partir do array `tracks` passado.<br />
  22. [page:Array tracks] - um array de [page:KeyframeTrack KeyframeTracks].<br /><br />
  23. Nota: Em vez de instanciar um AnimationClip diretamente com o construtor, você pode usar um
  24. de seus métodos estáticos para criar AnimationClips: de JSON ([page:.parse parse]), da sequência morph
  25. target ([page:.CreateFromMorphTargetSequence CreateFromMorphTargetSequence],
  26. [page:.CreateClipsFromMorphTargetSequences CreateClipsFromMorphTargetSequences]) ou de
  27. hierarquias de animação ([page:.parseAnimation parseAnimation]) - se o seu modelo ainda não
  28. contiver AnimationClips no array de animações de sua geometria.
  29. </p>
  30. <h2>Propriedades</h2>
  31. <h3>[property:Number duration]</h3>
  32. <p>
  33. A duração deste clipe (em segundos). Pode ser calculado a partir do array de [page:.tracks tracks]
  34. através de [page:.resetDuration resetDuration].
  35. </p>
  36. <h3>[property:String name]</h3>
  37. <p>
  38. Um nome para este clipe. Um determinado clipe pode ser pesquisado via [page:.findByName findByName].
  39. </p>
  40. <h3>[property:Array tracks]</h3>
  41. <p>
  42. Um array contendo um [page:KeyframeTrack] para cada propriedade animada por este clipe.
  43. </p>
  44. <h3>[property:String uuid]</h3>
  45. <p>
  46. O [link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] desta instância de clipe.
  47. Ele é atribuído automaticamente e não deve ser editado.
  48. </p>
  49. <h2>Métodos</h2>
  50. <h3>[method:AnimationClip clone]()</h3>
  51. <p>
  52. Retorna uma cópia deste clipe.
  53. </p>
  54. <h3>[method:this optimize]()</h3>
  55. <p>
  56. Otimiza cada faixa (track) removendo chaves sequenciais equivalentes (que são comuns em sequências morph target).
  57. </p>
  58. <h3>[method:this resetDuration]()</h3>
  59. <p>
  60. Define a [page:.duration duration] do clipe para a duração de seu maior
  61. [page:KeyframeTrack].
  62. </p>
  63. <h3>[method:Object toJSON]()</h3>
  64. <p>
  65. Retorna um objeto JSON que representa o clipe de animação serializado.
  66. </p>
  67. <h3>[method:this trim]()</h3>
  68. <p>
  69. Apara todas as faixas para a duração do clipe.
  70. </p>
  71. <h3>[method:Boolean validate]()</h3>
  72. <p>
  73. Executa a validação mínima em cada faixa (track) do clipe. Retorna verdadeiro se todas as faixas forem válidas.
  74. </p>
  75. <h2>Métodos estáticos</h2>
  76. <h3>[method:Array CreateClipsFromMorphTargetSequences]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
  77. <p>
  78. Retorna um array de novos AnimationClips criados a partir
  79. de sequências morph target de uma geometria, tentando classificar nomes de morph targets em grupos de animação
  80. padrão como "Walk_001, Walk_002, Run_001, Run_002 ...".
  81. </p>
  82. <h3>[method:AnimationClip CreateFromMorphTargetSequence]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
  83. <p>
  84. Retorna um novo AnimationClip do array de morph targets passado de uma geometria, recebendo um nome e o número de quadros por segundo.<br /><br />
  85. Nota: O parâmetro fps é obrigatório, mas a velocidade da animação pode ser sobrescrita em um
  86. `AnimationAction` via [page:AnimationAction.setDuration animationAction.setDuration].
  87. </p>
  88. <h3>[method:AnimationClip findByName]( [param:Object objectOrClipArray], [param:String name] )</h3>
  89. <p>
  90. Procura um AnimationClip por nome, tendo como primeiro parâmetro um array de
  91. AnimationClips ou um mesh ou geometria que contém um array chamado "animations".
  92. </p>
  93. <h3>[method:AnimationClip parse]( [param:Object json] )</h3>
  94. <p>
  95. Analisa uma representação JSON de um clipe e retorna um AnimationClip.
  96. </p>
  97. <h3>[method:AnimationClip parseAnimation]( [param:Object animation], [param:Array bones] )</h3>
  98. <p>
  99. Analisa o formato animation.hierarchy e retorna um AnimationClip.
  100. </p>
  101. <h3>[method:Object toJSON]( [param:AnimationClip clip] )</h3>
  102. <p>
  103. Recebe um AnimationClip e retorna um objeto JSON.
  104. </p>
  105. <h2>Source</h2>
  106. <p>
  107. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  108. </p>
  109. </body>
  110. </html>