Transform Sync (.anm / .pvt)

▶Videotutorial — próximamente

Dos tipos de archivo llevan movimiento, no arte:

Archivo	Viene de	Lleva
.anm	Octo Transform Sync	pegs animados — posición, rotación y escala, por frame
.pvt	un bake de huesos de Blender	una jerarquía de huesos con sus transformaciones de reposo

Los dos se pueden explorar y poner en staging, y ninguno se vuelve nunca un drawing. Construyen pegs.

Qué aterriza en el árbol

Soltar cualquiera de los dos te da un slot envoltorio con el nombre del archivo, que lleva un peg, un group y un composite (Peg Order: Parent, Comp Order: Inside). Ese envoltorio es organización de staging, no parte del rig.

Debajo, un peg por hueso, con el nombre del hueso. Si el exportador ya escribió los sufijos -P / -G / -C de Harmony, se quitan — el slot pone los suyos, y arm-P-P no ayuda a nadie.

Todo peg que sale de estos archivos nace con:

Ajuste	Valor	Por qué
Enable 3D	lo declarado en el archivo	un bake 3D necesita pegs 3D
Position	3D Path o Separate, según lo declarado	el exportador sabe cuál escribió
Exclude AutoPivot	activado	los pivotes son los del bake, y AutoPivot no debe sobrescribirlos

Un peg de cámara en el archivo se salta — la escena tiene la suya.

Qué escribe Assemble

Para un .anm, los keyframes se aplican por frame sobre el peg:

• POSITION.X / Y / Z
• ROTATION.ANGLEX / ANGLEY / ANGLEZ
• SCALE.X / Y / Z

Las posiciones se convierten de unidades de OpenGL a las unidades propias de la escena al entrar, usando la conversión de campo de visión de la escena — así que un bake hecho contra otra resolución de proyecto igualmente aterriza en el sitio correcto.

position.SEPARATE se pone a true antes de escribir las claves, porque los canales separados son a lo que apuntan los atributos por eje.

La pose de reposo también llega

Incluso sin keyframes, un peg lleva la rotación de Euler que declara el archivo (rotation.anglex/y/z). Un .pvt sin animación sigue siendo un esqueleto usable.

El viaje de ida y vuelta

El flujo previsto es:

1. Blender / Maya — animar o hacer bake.
2. Octo Transform Sync — exportar .anm.
3. OSA — poner el .anm en staging junto al arte que mueve, y ensamblar la escena entera de una pasada.

Por eso estos archivos están en el Browser: la jerarquía de pegs y los drawings que cuelgan de ella no deberían ser dos importaciones separadas con un paso manual de reemparentado en medio.

Validación

Un .anm se comprueba antes de poner nada en staging. Tiene que declarar format: octo_anm y llevar una clave pegs; si no, OSA lo dice en el log y no pone nada en staging, en vez de construir una jerarquía vacía que parece una importación fallida.

.pvt es un bake de Blender, no un archivo de pivotes de Harmony

La extensión se malinterpreta fácil. Un .pvt aquí es un JSON de bake de huesos; no tiene nada que ver con los datos de pivote propios de Harmony.