Diapositivas

scene.slides reúne componentes editoriales listos para presentaciones y videos explicativos: insignias, tarjetas, rótulos, listas, tablas y la identidad visual de cada segmento. Cada componente se mide a partir de su texto y devuelve un grupo Drawable que se coloca y anima como cualquier objeto.

from gaanim import Scene

scene = Scene(frame=(16, 9), theme="presentation")
heading = scene.slides.section_header("Resultados", kicker="03").move_to(0, 2.6)
metric = scene.slides.stat_card("98%", "Precisión", delta="+4.2%", variant="success").move_to(-2.2, -0.4)
note = scene.slides.card("Conclusión", "El solver converge en 12 ms.", variant="accent").move_to(2.4, -0.4)
scene.play([heading.animate.fade_in(), metric.animate.grow_from_center(), note.animate.fade_in()], duration=1.0)
scene.render()

Los componentes comparten opciones de estilo:

• variant: tono semántico del tema ("neutral", "accent", "success", "warning" o "danger").
• appearance: "soft" (fondo suave), "solid" (fondo lleno) u "outline" (solo borde).
• color, background y border: colores explícitos que sustituyen los del tema.
• Las medidas (width, padding, gap, radius…) están en unidades de escena.

Texto vacío, variantes desconocidas o medidas inválidas lanzan ValueError.

Insignias y chips

Etiquetas cortas de estado, categoría o metadatos que se ajustan a su texto.

tag = scene.slides.badge("LISTO", variant="success", appearance="solid").move_to(-2.4, 1.2)
code = scene.slides.badge("_vel_max", font="DejaVu Sans Mono", weight=600, markup=False)
scene.play([tag.animate.grow_from_center()])

live = scene.slides.chip("En vivo", variant="danger", appearance="outline")

Tarjetas

Paneles de altura automática para contenido, métricas y citas.

result = scene.slides.card("Resultado", "El solver converge.", "12 ms", variant="accent")

metric = scene.slides.stat_card("98%", "Precisión", delta="+4.2%", variant="success")

quote = scene.slides.quote_card("La claridad importa.", "Gaanim", appearance="outline")

Rótulos y encabezados

Portadas, cabeceras de sección y rótulos anclados a los bordes seguros.

FÁBRICASlideKit.title_cardtitle_card(title: str, subtitle: Optional[str] = None, *, width: float = 7.6, height: float = 3.2, panel: bool = False, background: Optional[ColorLike] = None, color: Optional[ColorLike] = None, accent: Optional[ColorLike] = None) -> Drawable

Portada centrada con título, regla y subtítulo opcional, animable como un solo grupo. panel=True la enmarca; accent colorea la regla.

Ejemplo

from gaanim import Scene
scene = Scene(frame=(16, 9), background="#0f172a")
opening = scene.slides.title_card("Movimiento vectorial", "Una explicación técnica", panel=True)
scene.play([opening.animate.fade_in().duration(0.7)])
scene.render()

heading = scene.slides.section_header("Método", kicker="02", align="center")

notice = scene.slides.banner("Simulación completa", position="bottom", variant="success")

speaker = scene.slides.lower_third("Ada Lovelace", "Matemática", kicker="PONENTE")

FÁBRICASlideKit.calloutcallout(text: str, target: Drawable, *, offset: tuple[float, float] = (1.6, 0.96), width: float = 2.4, height: float = 0.72, background: Optional[ColorLike] = None, color: Optional[ColorLike] = None) -> Drawable

Llamada con tarjeta, texto y conector que apunta a target desde offset y lo sigue de forma nativa, sin callbacks de Python por fotograma.

Ejemplo

from gaanim import GOLD, Scene
scene = Scene(frame=(16, 9), background="#0f172a")
mass = scene.geometry.dot(0.15).fill(GOLD).move_to(-0.5, 0)
note = scene.slides.callout("Masa en movimiento", mass, offset=(1.625, 0.875))
scene.play([mass.animate.shift_by(1, 0).duration(1.0), note.animate.fade_in().duration(0.4)])
scene.render()

Listas y tablas

Agendas con viñetas y tablas técnicas compactas.

FÁBRICASlideKit.bulletsbullets(items: Sequence[str], *, width: float = 7.2, gap: float = 0.68, bullet_radius: float = 0.08, bullet_color: Optional[ColorLike] = None, color: Optional[ColorLike] = None) -> Drawable

Lista con viñetas como un solo objeto. Cada punto se alinea a la izquierda, justo después de su viñeta, y se ajusta al resto de width. Ajusta width, gap, bullet_radius y bullet_color.

Ejemplo

from gaanim import GOLD, Scene
scene = Scene(frame=(16, 9), background="#0f172a")
agenda = scene.slides.bullets(["Preparar", "Animar", "Exportar"], gap=0.6, bullet_color=GOLD).move_to(0, 0.5)
scene.play([agenda.animate.fade_in().duration(0.6)])
scene.render()

FÁBRICASlideKit.tabletable(headers: Sequence[str], rows: Sequence[Sequence[str]], *, width: float = 7.6, row_height: float = 0.58, header_background: Optional[ColorLike] = None, rule_color: Optional[ColorLike] = None, color: Optional[ColorLike] = None) -> Drawable

Tabla con cabecera y reglas. Cada fila debe tener tantas celdas como cabeceras. Para tablas con celdas combinadas usa scene.text.typst(...) (ver Texto).

Ejemplo

from gaanim import Scene
scene = Scene(frame=(16, 9), background="#0f172a")
tbl = scene.slides.table(["Método", "Error", "Tiempo"], [["Base", "0.18", "48 ms"], ["GPU", "0.04", "15 ms"]]).move_to(0, 0)
scene.play([tbl.animate.fade_in().duration(0.6)])
scene.render()

Identidad de la presentación

Logo, pie, regla y número de diapositiva comunes a todos los segmentos.

scene.slides.brand(logo="assets/logo.svg", footer="LAB · 2026")
scene.segment("Portada")
scene.wait(0.5)
scene.segment("Contenido")
scene.wait(0.5)

scene.slides.target(20 * 60)
scene.segment("Portada", target=60)
scene.wait(0.5)