Solución de problemas¶
Síntomas, qué los causa, y qué revisar.
La herramienta no se abre¶
No pasa nada al ejecutar el script.
Harmony lanza los scripts de usuario a través de un Python 3.9 del sistema en el PATH, y 3.10 o posterior se ignora en silencio — sin error, sin ventana, sin nada. Instala Python 3.9 y vuelve a intentarlo.
El script no está en el menú Scripts.
OctoSceneAssembler.js debe quedar suelto en <version>-scripts/, no en una subcarpeta, y el paquete Python debe estar en una carpeta llamada exactamente octoSceneAssembler. Ver Instalación.
Una tag no hizo nada¶
head-Peg me dio un dibujo llamado head-Peg.
Una tag tiene que ser una pieza entera entre separadores. Peg no es una tag; P sí. Escribe head-P o head=P.
sky-0007 no se leyó como profundidad.
Un número suelto no es una tag, a propósito — los archivos de secuencia están llenos de ellos, y un frame llamado 0007 jamás debe convertirse en una instrucción de profundidad. Escribe Z0.1, 0.5F o 10B.
Parte de mi nombre desapareció.
El parser lee las tags de derecha a izquierda y se detiene en la primera pieza que no lo es. Si una palabra real de tu nombre resulta ser una tag válida (…-P), usa la forma con igual: two-part-name=P.
Gramática completa: Tags.
Una carpeta no fue enrutada¶
Entró como carpeta normal en vez de ir a su magnet.
O bien ningún magnet coincide con el nombre, o bien el magnet está inactivo. OSA lo dice al importar:
'PROPS' magnet is off: 'PROPS' came in as a plain folder, nothing was routed
Revisa la sección Magnets, y recuerda que el emparejamiento no distingue mayúsculas y prueba exacto, prefijo y sufijo — gana la coincidencia más larga. Ver Magnets.
El botón Assemble está gris¶
La barra de feedback tiene un mensaje rojo. El rojo es el único color que deshabilita el botón, y la barra nombra el blocker. Resuélvelo y el botón vuelve.
Los verbos de frame se niegan¶
Enable 'Split/Merge Frames' checkbox to merge/suck frames
Esa protección está apagada por defecto, en la sección Settings del Browser. Las ediciones estructurales reorganizan un plan; las de frames reorganizan el timing. Ver Split y Merge.
Merge o Split está en gris¶
Pasa el ratón por encima — el tooltip dice por qué. Merge necesita al menos dos nodos; Split necesita algo que dividir. Una entrada gris sin razón es un bug de la interfaz, no una regla.
El arte no llegó¶
Lee el reporte. Cada rechazo tiene un tipo:
| Tipo | Revisa |
|---|---|
import-failed |
que el archivo fuente siga existiendo y sea legible |
format-mismatch |
la extensión miente sobre el contenido — un archivo renombrado |
element-swap |
un dibujo de Original Bitmap siguió siendo un TVG |
utransform |
la conversión fue rechazada; a menudo por una fuente no soportada |
no-bridge |
Harmony está ahí pero el puente de scripting nunca se abrió — reinicia Harmony |
Lista completa: Ensamblar.
Una track vectorial desapareció en Original Bitmap¶
No desapareció — no se escribió, y sigue en tu árbol. Original Bitmap no tiene art layers, así que el vector no puede aterrizar ahí. O cambias el dibujo a Art Layers, o mueves esa track a un dibujo que sí lo sea. Ver Original Bitmap.
"Could not auto-save the session to disk"¶
Un mensaje amarillo y temporal. El árbol sigue en memoria y Assemble sigue funcionando — pero la red contra crashes está caída.
La razón está en el log, y nombra la causa:
%APPDATA%/Toon Boom Animation/Toon Boom Harmony Premium/octo_scene_assembler/osa.log
Busca Autosave: could not write the file:. Las causas comunes son un disco lleno, una carpeta bloqueada, o un antivirus reteniendo el directorio de sesiones.
La sesión no volvió¶
No se ofreció ninguna barra. Una sesión es por escena — una escena guardada con otro nombre tiene otra sesión. Además: un Restore exitoso borra la sesión que restauró, y Dismiss la borra a propósito.
La barra dijo que la sesión era ilegible. Tanto el archivo como su único respaldo fallaron al interpretarse. OSA te lo dice en vez de arrancar vacío en silencio, porque que no te digan nada es como la gente concluye que el autoguardado nunca funcionó.
Ver Sesiones y recuperación tras un crash.
Harmony se cayó durante el Assemble¶
Assemble no es una transacción — Harmony acumula toda la construcción en un único undo, así que un crash o una cancelación deja los nodos ya creados.
Recuperación: el undo del propio Harmony, luego arregla el árbol y vuelve a ensamblar. Tu árbol de staging sigue describiendo todo lo que no aterrizó, porque OSA solo aplana lo que aterrizó.
El Node View se ve apilado, no organizado¶
Nodos unos sobre otros significan que la pasada de layout no se ejecutó — busca un phase-error en el reporte. El Wide Bus coloca cada nodo, así que un montón es un fallo, no un estilo.
Reportar un bug¶
? → About tiene las tres cosas que necesita un reporte: versión, estado de la licencia y Machine ID.
Adjunta osa.log. Es como el soporte lee lo que hizo tu Harmony sin necesitar tu escena.