Fireworks 🎉

Here's a program that spawns particles to form fireworks every second at a random position on the screen.

# /// script
# requires-python = ">=3.11"
# dependencies = [
#   "batFramework"
# ]
# ///
import batFramework as bf
import pygame
from random import randint

class MainScene(bf.Scene):
    def __init__(self):
        super().__init__("main")

    def do_when_added(self):
        self.set_clear_color((10, 10, 20))
        self.pg = bf.ParticleGenerator()
        self.add("world", self.pg)
        bf.Timer(duration=1.0, end_callback=self.generate, loop=-1).start()

    def generate(self):
        position = bf.utils.random_point_on_screen(margin=40)
        for _ in range(200):
            velocity = pygame.math.Vector2(randint(40, 280), 0)
            velocity.rotate_ip(randint(0, 360))
            self.pg.add_particle(
                bf.BasicParticle(
                    position,
                    velocity,
                    duration=1.0,
                    color=bf.utils.random_color(40, 255),
                    size=(3, 3),
                )
            )

bf.init(
    resolution=(640, 480),
    flags=pygame.SCALED,
    window_caption="Fireworks",
    fps_limit=60,
)
bf.Manager(MainScene()).run_async()

You can see the result here.

Web build

The live demo is built with pygbag against the PyPI release of batFramework. Both documentation tracks share this same demo.

SCALED flag

You can pass the pygame.SCALED flag to bf.init() to scale the window when the resolution is small.