Automatic Camera

Python Code

import math

from dataclasses import replace

from svan2d.component.state.circle import CircleState
from svan2d.converter.converter_type import ConverterType
from svan2d.core.color import Color
from svan2d.core.logger import configure_logging
from svan2d.core.point2d import Point2D
from svan2d.velement import VElement
from svan2d.vscene import VScene
from svan2d.vscene.automatic_camera import automatic_camera
from svan2d.vscene.vscene_exporter import VSceneExporter

configure_logging(level="INFO")

COLOR_ONE = Color("#775F17")
COLOR_TWO = Color("#AA0000")

NUM_CIRLCES = 6


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

    colors = [
        COLOR_TWO.interpolate(COLOR_ONE, t / (NUM_CIRLCES - 1))
        for t in range(NUM_CIRLCES)
    ]

    step = 360 // NUM_CIRLCES
    angles = list(range(0, 360, step))

    circle_elements = []
    for i, (color, angle) in enumerate(zip(colors, angles)):
        rad = math.radians(angle)

        start = CircleState(
            radius=10,
            pos=Point2D(40 * math.cos(rad), 40 * math.sin(rad)),
            fill_color=Color(color),
        )
        d = 40 + 210 * i / (NUM_CIRLCES - 1)
        end = replace(
            start,
            pos=Point2D(d * math.cos(rad), d * math.sin(rad)),
        )

        circle_elements.append(VElement().keystates([start, end]))

    scene = scene.add_elements(circle_elements)

    ring = VElement(
        state=CircleState(
            radius=40,
            fill_color=Color.NONE,
            stroke_color=Color("#ffffff"),
            stroke_width=0.5,
            stroke_opacity=0.3,
        )
    )
    scene = scene.add_element(ring)

    scene = automatic_camera(scene, padding=1.2, exclude=[ring])

    exporter = VSceneExporter(
        scene=scene,
        converter=ConverterType.PLAYWRIGHT_HTTP,
        output_dir="output/",
    )

    exporter.to_mp4(
        filename="automatic_camera",
        total_frames=90,
        framerate=30,
        png_width_px=1024,
    )


if __name__ == "__main__":
    main()

Remarks

• The automatic_camera method in Svan2d manages zoom and offset automatically to ensure the complete scene remains in view.
• See Automatic Camera with custom offset for an example of how to specify a custom camera focus point.
• See Automatic Camera with offset func for an example of how to specify the custom camera focus point by a function.