Curve Editor: a conversão de quatérnio para ângulo de Euler não tem volta

O Curve Editor é a ferramenta que separa animação boa de animação com potencial no Roblox. Ele dá controle por eixo e tangentes de interpolação — o mesmo vocabulário de qualquer software de animação profissional.

E ele tem uma porta de entrada com uma decisão irreversível, escrita numa caixa de aviso que quase todo mundo fecha sem ler.

O problema

O que ele é: uma interface de edição de animação baseada em curvas, dentro do editor de animação, que permite ver e modificar como a posição e a orientação do rig mudam entre quadros-chave.

O ganho principal está numa frase: ele permite definir faixas independentes para os ângulos X, Y e Z. No dope sheet, um quadro-chave é a orientação inteira; na curva, cada eixo tem a própria linha, e dá para ajustar um sem mexer nos outros.

Há também um ganho de leitura que economiza tempo. Em vez de arrastar o scrubber de quadro em quadro para ver como as coisas mudam, o editor mostra os valores por réguas — a de posição à esquerda da linha do tempo, a de rotação à direita.

E dá para alternar entre o dope sheet e o editor de curvas a qualquer momento. Essa frase é verdadeira e é a origem do problema: ela sugere que alternar é reversível. A alternância é. A conversão não.

Passo a passo

A ordem correta tem quatro passos, e os dois primeiros são os que quase todo mundo pula.

1. Abra as configurações. O ícone fica no canto superior direito da janela do editor.

2. Escolha o tipo de rotação. No menu, em Default Rotation Type, escolha entre ângulos de Euler e quatérnios. A escolha vira o tipo de rotação padrão para projetos futuros também — então vale decidir com calma uma vez.

3. Abra o Curve Editor. O ícone fica no canto superior esquerdo da linha do tempo.

4. Confirme. Aparece uma janela avisando que o clipe KeyframeSequence vai virar um clipe CurveAnimation.

Quem faz o passo 3 antes dos passos 1 e 2 aceita o padrão sem saber que escolheu — e é aí que a próxima seção acontece.

Entendendo a interpolação. Interpolação é o preenchimento dos valores entre os quadros-chave, e é ela que permite ao rig animar suavemente de uma orientação a outra em vez de saltar.

Os dois tipos interpolam de formas diferentes, e isso muda como o gráfico se lê:

• Curva de Euler interpola entre os valores de cada quadro-chave. A altura de cada quadro-chave representa o valor da orientação ao longo do tempo. É um gráfico contínuo, como qualquer curva de animação.
• Curva de quatérnio interpola de 0 a 1 num tempo definido. Cada segmento representa a orientação mudando entre quadros-chave, e a linha mostra a interpolação. O gráfico é uma sequência de segmentos, não uma curva só.

Tangentes. O editor oferece tangentes — alças que ajustam a interpolação antes ou depois de um quadro-chave.

A distribuição delas difere: curva de Euler tem tangente antes e depois do quadro-chave; curva de quatérnio tem uma no começo e outra no fim do segmento.

E a convenção é fácil de inverter mentalmente: a tangente inicial controla a interpolação depois do quadro-chave, e a secundária controla a de antes.

Por que existem dois tipos de rotação. Vale entender a origem da escolha, porque ela explica todo o resto.

Quatérnio descreve uma orientação como um bloco único, sem eixos separados. É preciso, não sofre de travamento de eixo, e interpola pelo caminho mais curto entre duas orientações. O preço é que ele não se edita por eixo: não existe "mexer só no giro do pulso".

Ângulo de Euler descreve a mesma orientação como três números — um por eixo. Isso é o que permite as faixas independentes de X, Y e Z, e é o que torna o editor de curvas útil. O preço é o travamento de eixo, que acontece quando dois eixos se alinham e um grau de liberdade some.

Nenhum dos dois é melhor. Um é melhor para editar, o outro para preservar — e a decisão do passo 2 é exatamente essa.

Artefato

O documento abaixo põe a decisão em formato de conferência, com a ordem correta dos quatro passos e uma tabela comparando os dois tipos de rotação.

A tabela existe porque a escolha não é uma questão de preferência técnica — ela é uma troca concreta entre controle e fidelidade, e o artefato a resume em duas linhas no fim.

Vale ainda registrar um detalhe do fluxo que engana: a documentação diz que dá para alternar entre o dope sheet e o editor de curvas a qualquer momento, e isso é verdade. O que não é reversível é a conversão do clipe — o KeyframeSequence que vira CurveAnimation. Alternar a visualização depois disso continua livre; o que se perdeu já se perdeu na primeira abertura.

Erro comum

O erro é abrir o Curve Editor numa animação pronta, sem escolher o tipo de rotação antes.

O mecanismo está escrito na documentação, e é preciso: o Studio converte quatérnios em ângulos de Euler automaticamente ao abrir o Curve Editor. E logo em seguida vem a frase que define a gravidade: uma vez convertidos os quatérnios em faixas de ângulo de Euler, não há como voltar.

O que se perde não é óbvio na hora, e é isso que torna o erro caro. Como KeyframeSequence trabalha com quatérnio e animação em curva trabalha com Euler por padrão, a animação pode ficar um pouco diferente entre os quadros-chave — e a diferença é maior se algum ângulo de Euler chegar perto do travamento de eixo.

Leia com atenção o que muda: entre os quadros-chave. As poses em si continuam certas. O que se altera é o caminho entre elas, que é justamente o que ninguém confere depois de converter — porque o olho vai às poses, e as poses estão lá.

O resultado prático é uma animação que ficou sutilmente pior, de um jeito que você não sabe nomear, num arquivo que não tem como voltar ao que era.

A alternativa existe e está na mesma página: se você definir o tipo de rotação como quatérnio antes de converter, a conversão para curvas preserva os quatérnios e a animação fica igual.

Então a regra é simples: animação já pronta que não pode mudar entra como quatérnio. Animação em construção, onde o controle por eixo vale mais, entra como Euler — de propósito, sabendo o que se está trocando.

O segundo erro é sobre as tangentes de quatérnio. É comum ajustar uma tangente esperando mudar onde o movimento começa ou termina, e nada acontece nas pontas. O motivo está na documentação: por mais que se ajuste cada tangente, cada segmento sempre começa em 0 e termina em 1. A tangente muda o percurso, não as extremidades.

E há um detalhe do gráfico de quatérnio que confunde na primeira leitura: embora cada segmento seja desconectado do seguinte, os dois quadros-chave dentro do mesmo quadro sempre representam a mesma orientação. A descontinuidade visual não é uma descontinuidade do movimento.

Vale ainda saber ler o gráfico antes de mexer nele, porque os dois tipos se leem de formas diferentes e confundir as duas leva a ajustes no lugar errado. Na curva de Euler, procure a altura: ela é o valor da orientação, e uma linha que sobe é um ângulo que aumenta. Na de quatérnio, procure o segmento: cada um é a transição entre dois quadros-chave, e a forma da linha dentro dele é a velocidade dessa transição.

Próximo passo

Com o tipo de rotação decidido, o ganho real vem das tangentes — e ele aparece rápido num lugar específico: nas pontas da animação.

Movimento que começa e termina abruptamente é o defeito mais comum de animação feita só no dope sheet, porque o dope sheet não dá ferramenta para isso além dos modos de easing prontos. Uma tangente ajustada na entrada e outra na saída resolvem o que cinco quadros-chave a mais não resolvem.

O exercício: pegue uma animação simples e pronta, faça uma cópia, escolha quatérnio no menu de configuração, abra o Curve Editor e mexa apenas nas tangentes do primeiro e do último quadro-chave. É a mudança mais barata que o editor de curvas oferece, e costuma ser a mais visível.

E, antes de qualquer coisa: cópia. A conversão é irreversível, e o arquivo original é a única coisa que responde "como era antes".

CURVE EDITOR — a decisao que vem ANTES de abrir. Conferido em 23/09/2026.

!! IRREVERSIVEL. Convertido de quaternio para faixa de angulo de Euler,
   NAO HA COMO VOLTAR. Decida antes, nao depois.

== A ORDEM CORRETA ==

  1. [ ] icone de CONFIGURACAO, canto superior DIREITO do editor
  2. [ ] Default Rotation Type  >  escolher Euler Angles OU Quaternions
         ^ a escolha vira o PADRAO para projetos futuros tambem
  3. [ ] so ENTAO: icone do Curve Editor, canto superior ESQUERDO da
         linha do tempo
  4. [ ] confirmar a janela que avisa: o clipe KeyframeSequence vai
         virar um clipe CurveAnimation

  Quem faz 3 antes de 1 e 2 aceita o padrao sem saber que escolheu.

== QUAL ESCOLHER ==

| Criterio                          | Angulos de EULER        | QUATERNIOS            |
|-----------------------------------|-------------------------|-----------------------|
| faixas independentes por eixo     | SIM (X, Y, Z separados) | nao                   |
| a animacao muda na conversao?     | PODE MUDAR              | NAO muda              |
| travamento de eixo (gimbal lock)  | risco                   | sem risco             |
| tangentes por quadro-chave        | 2 (antes e depois)      | 2 por SEGMENTO        |
| leitura do grafico                | altura = valor da       | segmento = mudanca    |
|                                   | orientacao no tempo     | entre quadros-chave   |
| interpolacao                      | entre os VALORES de     | de 0 a 1 num tempo    |
|                                   | cada quadro-chave       | definido              |

  EULER  -> escolha quando o CONTROLE POR EIXO importa mais que a
            fidelidade ao que ja estava animado.
  QUATERNIO -> escolha quando a animacao JA ESTA PRONTA e nao pode mudar.

== POR QUE A ANIMACAO PODE MUDAR ==

  KeyframeSequence trabalha com QUATERNIO.
  Animacao em curva trabalha com EULER por padrao.

  A conversao entre os dois nao e perfeita: a animacao pode aparecer um
  pouco DIFERENTE entre os quadros-chave -- e a diferenca e MAIOR se
  algum angulo de Euler chegar perto do travamento de eixo.

  Os quadros-chave em si continuam certos. O que muda e o CAMINHO entre
  eles, que e justamente o que ninguem confere depois de converter.

== TANGENTES: qual controla o que ==

  tangente INICIAL   -> a interpolacao DEPOIS do quadro-chave
  tangente SECUNDARIA -> a interpolacao ANTES do quadro-chave

  Em quaternio: por mais que se ajuste a tangente, cada segmento SEMPRE
  comeca em 0 e termina em 1. O que a tangente muda e o percurso, nao as
  pontas.