← Documentación

Lenguaje de escenas

Actualizado el 5 de agosto de 2026

Las escenas de SimuLab no se dibujan con un editor gráfico: se describen escribiendo. Eso significa que puedes definir exactamente qué figuras aparecen, cómo se mueven y desde qué punto de vista, con un lenguaje sencillo pensado para problemas de ciencias.

Dónde se edita la escena

Al crear o editar un problema manualmente, desplázate hasta la sección Enunciado del editor. Debajo del texto del enunciado encontrarás un campo de texto monoespaciado con el indicador Código de la simulación. Ahí escribes el código. El botón Previsualizar ejecuta la escena en un recuadro para que puedas verla antes de guardar.

Estructura general

Una escena tiene dos partes principales:

  1. El bloque scene, que define el tipo de escena (2d o 3d), el área visible y todas las figuras.
  2. Uno o más bloques anim, donde se define cómo se mueven o cambian las figuras a lo largo del tiempo, usando el formato anim inicio..fin.

Dentro de un bloque anim, cada línea de animación puede ir precedida de @inicio..fin para indicar en qué intervalo de tiempo ocurre esa animación concreta.

Familias de elementos disponibles

Escenas 2D

Elemento Para qué sirve
point Marca una posición con un punto y etiqueta opcional
vector Flecha con dirección y magnitud
segment Segmento entre dos puntos
line Recta infinita entre dos puntos
circle Círculo, relleno o solo contorno
rect Rectángulo
polygon Polígono con los vértices que necesites
curve Curva definida por una función matemática
label Texto posicionado en la escena
emitter Emisor de partículas (fluidos, campos)
axis Ejes cartesianos con etiquetas

Escenas 3D

Elemento Para qué sirve
sphere Esfera en el espacio
box Caja rectangular
cylinder Cilindro
plane Plano
arrow3 Flecha en 3D
molecule Molécula a partir de su fórmula SMILES
camera Configura la vista inicial de la cámara

Animaciones disponibles

Las animaciones se escriben en los bloques anim, mencionando el nombre de la figura a la que se aplican. Las principales son:

Animación Qué hace
move Desplaza la figura a otra posición
rotate La hace girar
scale Cambia su tamaño
fade Cambia su opacidad
oscillate La hace oscilar alrededor de un punto
orbit La hace orbitar alrededor de otro elemento
follow La mueve a lo largo de una curva
trace Dibuja la trayectoria que recorre
spin Gira continuo sobre un eje
pulse Hace latir el tamaño
flow Genera un flujo de partículas sobre la figura
show / hide Muestra u oculta la figura
set Cambia una propiedad en un momento concreto

Ejemplo mínimo

El siguiente código define una escena 2D con un punto que se mueve hacia la derecha:

scene 2d
  space x=-5..5 y=-5..5
  point A at (0, 0) color=blue label="A"
anim 0..3
  move A to (4, 0)

Este ejemplo crea una escena en dos dimensiones, define el área visible entre −5 y 5 en ambos ejes, coloca un punto llamado A en el origen con color azul, y define una animación de 0 a 3 segundos que lo mueve hasta la posición (4, 0).

La escena es opcional al crear un problema. Si no añades código, el problema funciona igual pero sin la visualización animada.

Preguntas frecuentes

¿Necesito saber programar para escribir escenas? No. El lenguaje está pensado para ser legible: cada línea describe una figura o un movimiento en palabras que se parecen a lo que hacen. Con unos minutos de práctica y los ejemplos como referencia es suficiente.

¿Qué colores puedo usar? Los nombres de color disponibles son: red, blue, green, yellow, orange, purple, cyan, magenta, white, black y gray.

¿Puedo usar fórmulas matemáticas en los valores? Sí. Los campos de tipo expresión aceptan operaciones con sin, cos, sqrt, exp, abs, ln, log, pow y otras funciones. También puedes usar las constantes pi, e y t (el tiempo de la animación).

Siguiente paso