Animación isométrica SVG
Un script (node build.mjs) coloca cada forma en unidades de plano, lo proyecta a isométrica y escribe un diagram.svg autocontenido (con keyframes CSS, que se reproduce como un <img> simple) y un preview.html (el mismo SVG incrustado y escalado a la ventana). Nada se dibuja a mano: cada corrección es un cambio de código y una reconstrucción.
Antes de escribir el script, lee references/generator.md: sus secciones y el código central para proyección, tarjetas, texto en suelo, rutas, keyframes, plataformas y ensamblaje.
Pasos
- Historia. Lee la documentación del propio sistema, luego escribe la historia del diagrama en una línea: qué entra, qué lo procesa, qué impulsa el trabajo, qué sale. El flujo se lee de abajo a la izquierda a arriba a la derecha. Terminado cuando cada etapa de la línea es un nodo que se puede nombrar en una a tres palabras y el usuario está de acuerdo con la línea.
- Resumen. Obtén una imagen de referencia para la sensación (grosor de línea, densidad, estilo de plataforma); cuando el usuario no tenga ninguna, muestra los diagramas en references/examples.md y deja que elija. Define el tema, la relación de aspecto (1.6:1 encaja en una ventana del navegador) y dónde vivirá el SVG. Terminado cuando los cuatro están en el comentario de cabecera del script.
- Construcción estática. Plataformas, nodos, rutas, etiquetas; sin movimiento todavía. Terminado cuando la auditoría de la construcción no imprime superposiciones ni esquinas apretadas, y el usuario ha aprobado una captura de pantalla del diseño.
- Movimiento. Añade el bucle. Terminado cuando un bucle reproduce la historia una vez, en orden, y el movimiento reducido muestra el estado final.
- Exportación. Consulta Exportación abajo.
Cada ronda de revisión: toma las notas del usuario una a una, responde cualquier pregunta antes de cambiar algo, copia la construcción actual en versions/ antes de un cambio grande, y responde con una captura de pantalla. Cuando el usuario elige entre nombres o iconos, renderiza las opciones lado a lado.
Principios
Contenido
- Un flujo, pocos detalles. Cada nodo se nombra por lo que realmente hace; cuando un nombre se disputa, di cuál es preciso y por qué, luego deja que el usuario elija.
- Cada etiqueta se lee por sí sola para un extraño. Una etiqueta que necesita explicación se reescribe o se elimina.
- Una pila de placas solo para algo que realmente es una pila (las páginas de un informe); cualquier otro nodo es una sola tarjeta.
- Los caminos laterales honestos se quedan dibujados (entradas que saltan una etapa), incluso cuando cuestan espacio.
- Los sistemas externos se sientan en plataformas con el mismo relleno que los internos; solo un borde discontinuo los marca como externos.
- Las entradas sueltas yacen planas en el suelo, sin plataforma debajo.
Geometría
- Unidades de plano en todas partes:
acorre a lo largo del flujo (pantalla arriba-derecha),ba través (pantalla abajo-derecha),zhacia arriba. Posiciones, tamaños, espacios y rutas están en unidades de plano; los píxeles de pantalla existen solo dentro de la proyección. - Una tarjeta es una cara superior más una banda lateral (el casco de sus contornos superior e inferior) con un trazo en el contorno exterior, y la cara se encuentra con el grosor sin línea. Las plataformas trazan su cara superior en su lugar, ya que esa cara yace en la cuadrícula.
- Un grosor para cada tarjeta y pastilla de módulo. Las pastillas de nombre yacen planas sin grosor.
- Pinta por capas (suelo, plataformas, cables, objetos, etiquetas), ordenadas por profundidad dentro de cada una.
Texto
- Cada etiqueta yace en el plano del suelo con su línea base a lo largo de
a. Los glifos se convierten en trazados en tiempo de construcción, por lo que el SVG se renderiza igual como<img>en cualquier lugar y no carga ninguna fuente. - Los tamaños provienen de una pequeña tabla (pastilla, etiqueta, pequeño, pie de foto, título). Los títulos de plataforma son mayúsculas espaciadas monoespacio.
Diseño
- Una cuadrícula de suelo a 2 unidades. Los bordes de plataforma se alinean hacia afuera a las líneas de la cuadrícula; los espacios entre plataformas y entre filas son celdas enteras; una línea troncal compartida corre en una línea de cuadrícula centrada en su espacio.
- Las plataformas se dimensionan solas: cada nodo y etiqueta registra su huella con su plataforma, y la plataforma es esa caja más un relleno uniforme, alineado a la cuadrícula. Las plataformas en una fila comparten sus bordes enfrentados.
- Un título de plataforma se sitúa tan lejos del borde izquierdo como del borde frontal (medido hasta el pie de sus mayúsculas), alineado a la izquierda con el contenido.
- La cuadrícula se extiende más allá de cada borde del marco y se desvanece a través de una elipse con la relación de aspecto del marco, por lo que la imagen no tiene un borde duro. El fondo es transparente.
- Cada construcción imprime una auditoría: los cuatro márgenes de cada plataforma, los espacios entre plataformas, las superposiciones etiqueta × etiqueta y etiqueta × tarjeta, y las esquinas demasiado apretadas para su radio. Léela antes de mostrar cualquier cosa.
Líneas
- Cada conexión es un trazado continuo: ortogonal, con giros de cuarto de vuelta de un radio fijo, de modo que las rutas que comparten un tramo lo comparten exactamente y una rama sale de su tronco a lo largo de una tangente. Dibuja las rutas primero y los nodos encima; el resultado no tiene muñones, bifurcaciones ni espacios.
- Los tipos de línea se diferencian por patrón: sólido para el flujo, discontinuo para un raíl externo, puntos redondos para acceso de solo lectura.
Tono
- El tono es estado. Solo neutros (R = G = B). Claro = aún no alcanzado, un paso más oscuro = su entrada está lista, más oscuro = terminado en esta ejecución. Los iconos y contornos siguen la misma regla, por lo que cualquier "¿por qué este es más oscuro?" tiene un estado como respuesta. La tinta más oscura es un gris medio-oscuro; el negro puro y los bloques oscuros sólidos se quedan fuera.
- Las líneas descansan muy claras y se oscurecen solo después de que una luz ha corrido a lo largo de ellas.
- El color significa trabajando ahora mismo: la tarjeta permanece blanca mientras un toque del gradiente de marca se muestra por debajo de ella, con un brillo tenue alrededor. Las luces toman su color de un gradiente colocado a través de toda la imagen a lo largo del flujo.
- Un acento para una fase (por ejemplo, las entradas siendo recogidas) se muestra solo mientras está iluminado, luego vuelve al gris en el que descansaba.
Movimiento
- Animación SVG: keyframes CSS dentro del SVG, sin script, reproduciéndose como un
<img>. Un vídeo renderizado solo cuando se solicita. - El estilo de reposo es la ejecución finalizada; los keyframes comienzan cada bucle desde una ejecución intacta. El movimiento reducido y una exportación estática muestran por tanto el diagrama finalizado.
- El tiempo proviene de la geometría. Las luces viajan a una velocidad de pantalla (aproximadamente 400 px/s); cada llegada es inicio + longitud de ruta ÷ velocidad, y el siguiente evento es esa llegada más una pausa. Mueve un nodo y la línea de tiempo lo sigue. Calcula toda la línea de tiempo, y la longitud del bucle con ella, antes de escribir cualquier keyframe.
- Un bucle cuenta la historia una vez: las entradas viajan hacia adentro, el controlador corre de arriba a abajo, las piezas se reúnen y la salida se ensambla, exporta, espera, limpia, repite. Suficientemente lento para seguir (aproximadamente 20 s).
- Una luz es un guión corto que corre a lo largo de su ruta con un halo más suave y amplio; un rastro más oscuro permanece detrás de ella hasta que el bucle se limpia. Un nodo que trabaja se eleva unos pocos píxeles, brilla y muestra su cara de gradiente.
Coste de renderizado
Como un <img>, cualquier animación en ejecución hace que el navegador vuelva a rasterizar toda la imagen cada fotograma.
- Las máscaras, filtros y grupos se mantienen pequeños: la cuadrícula se desvanece a través de su propio gradiente de trazo, y una máscara abraza el trazado que revela.
- Cualquier cosa que no se pueda ver está
visibility: hidden(opacidad 0 y un guión aparcado fuera de su trazado aún se pinta). - Los keyframes idénticos se escriben una vez.
Exportación
- PNG estático: abre el propio documento SVG con movimiento reducido emulado y captura la pantalla. Dentro de un
<img>la emulación nunca alcanza el SVG, y capturas el primer fotograma del bucle en su lugar. - Las vistas previas viven en una página independiente servida localmente, fuera del sitio del usuario, hasta que el usuario coloca el SVG.