Property Keystates

Python Code

from dataclasses import replace

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 vood.core import Color
from vood.core.color import Color

configure_logging(level="INFO")

START_COLOR = Color("#FDBE02")
END_COLOR = Color("#AA0000")


def main():

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

    # Create text states for each number with consistent styling
    states = [
        TextState(
            text=str(num),
            font_family="Courier New",
            font_size=20,
            fill_color=Color("#FDBE02"),
        )
        for num in range(1, 10)
    ]

    # Arrange the numbers along a line for start and end positions
    start_states = layout.line(states, center_x=-100, spacing=20, rotation=90)
    middle_states = layout.line(states, spacing=20, rotation=90)
    end_states = layout.line(states, center_x=100, spacing=20, rotation=90)

    # lets animate also a change of color
    middle_states = [replace(state, fill_color="#d88023") for state in end_states]
    end_states = [replace(state, fill_color=Color("#AA0000")) for state in end_states]

    # Create a text renderer for all numbers
    renderer = TextRenderer()

    elements = [
        VElement(
            renderer=renderer,
            keystates=[(0, start_state), (0.1 * (i + 1), middle_state), (1, end_state)],
            property_keystates={
                "fill_color": [
                    (0, START_COLOR),
                    (0.3, END_COLOR),
                ],
            },
        )
        for i, (start_state, middle_state, end_state) in enumerate(
            zip(start_states, middle_states, end_states)
        )
    ]

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

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

    # Export to MP4 file
    exporter.to_mp4(
        filename="property_keystates",
        total_frames=90,
        framerate=30,
        png_width_px=1024,
    )


if __name__ == "__main__":
    main()

Remarks

• Small adaptation of Keyframe Variety using a global color transition. Unlike the previous example in which the smaller numbers turned red faster due to per-element keyframe timing, this version applies uniform color progression to all elements simultaneously.