Layout Showcase

Python Code

"""
Comprehensive showcase of all vood layout functions
Demonstrates each layout's unique characteristics with animated transition
"""

from vood.component import TextRenderer, TextState
from vood.converter.converter_type import ConverterType
from vood import layout
from vood.core.logger import configure_logging
from vood.velement import VElement
from vood.vscene import VScene
from vood.vscene.vscene_exporter import VSceneExporter
from dataclasses import replace
from vood.core.color import Color

from vood.animation.atomic import sequential_transition, fade, trim

configure_logging(level="INFO")


def main():
    # Create the scene
    scene = VScene(width=256, height=256, background=Color("#000017"))

    # Create text states for numbers 1-20 with consistent styling
    base_states = [
        TextState(
            text=f"{num:02}",
            font_family="Courier New",
            font_size=10,
            fill_color=Color("#FDBE02"),
        )
        for num in range(1, 21)
    ]

    base_name_state = TextState(
        text="",
        font_family="Courier New",
        font_size=10,
        fill_color=Color("#AA0000"),
        y=110,
    )

    # Define all layout transition
    layout_states = []
    layout_name_states = []

    # 1. Start: Grid layout
    layout_states.append(layout.grid(base_states, cols=5, spacing_h=20, spacing_v=20))
    layout_name_states.append(replace(base_name_state, text="Grid Layout"))

    # 2. Circle layout
    layout_states.append(
        layout.circle(base_states, radius=100, alignment=layout.ElementAlignment.LAYOUT)
    )
    layout_name_states.append(replace(base_name_state, text="Circle Layout"))

    # 3. Spiral layout
    layout_states.append(
        layout.spiral(
            base_states,
            start_radius=20,
            radius_step=5,
            angle_step=40,
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Spiral Layout"))

    # 4. Line layout (horizontal)
    layout_states.append(
        layout.line(
            base_states,
            spacing=13,
            rotation=40,
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Line Layout"))

    # 5. Wave layout
    layout_states.append(
        layout.wave(
            base_states,
            amplitude=25,
            wavelength=80,
            spacing=12,
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Wave Layout"))

    # 6. Ellipse layout
    layout_states.append(
        layout.ellipse(
            base_states,
            rx=110,
            ry=70,
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Ellipse Layout"))

    # 7. Polygon layout (hexagon)
    layout_states.append(
        layout.polygon(
            base_states,
            sides=5,
            radius=100,
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Polygon Layout"))

    # 8. Bezier curve layout
    layout_states.append(
        layout.bezier(
            base_states,
            control_points=[(-110, -80), (-60, 80), (60, -80), (110, 80)],
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Bezier Layout"))

    # 9. Random scatter layout
    layout_states.append(
        layout.scatter(
            base_states,
            x_range=(-115, 115),
            y_range=(-115, 115),
            seed=42,
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Scatter Layout"))

    # 10. Path Points layout
    layout_states.append(
        layout.path_points(
            base_states,
            points=[(-110, -100), (-60, 0), (0, 60), (60, 0), (110, 100)],
            smooth=True,
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Path Points Layout"))

    # 11. Radial grid layout
    layout_states.append(
        layout.radial_grid(
            base_states,
            rings=4,
            segments=5,
            ring_spacing=25,
            inner_radius=15,
            alignment=layout.ElementAlignment.LAYOUT,
        )
    )
    layout_name_states.append(replace(base_name_state, text="Radial Grid Layout"))

    # 12. Back to grid (closing the loop)
    layout_states.append(layout.grid(base_states, cols=5, spacing_h=20, spacing_v=20))
    layout_name_states.append(replace(base_name_state, text="Grid Layout"))

    # Create a text renderer
    renderer = TextRenderer()

    layout_keyframes = [
        sequential_transition(states, trim, 0.8) for states in zip(*layout_states)
    ]

    elements = [
        VElement(
            renderer=renderer,
            keystates=keystates,
        )
        for keystates in layout_keyframes
    ]

    # Add all elements to the scene
    scene.add_elements(elements)

    text_keyframes = sequential_transition(layout_name_states, fade, 0.5)

    texts = VElement(renderer=renderer, keystates=text_keyframes)
    scene.add_element(texts)

    # Create the exporter
    exporter = VSceneExporter(
        scene=scene,
        converter=ConverterType.PLAYWRIGHT,
        output_dir="output/",
    )

    # Export to MP4 file
    exporter.to_mp4(
        filename="layout_showcase.mp4",
        total_frames=len(layout_states) * 60,
        framerate=30,
        png_width_px=1024,
    )


if __name__ == "__main__":
    main()

Remarks

• Comprehensive showcase of all vood layout functions we have added so far.