Examples Gallery

All examples live in packages/graphics/examples/. Run any example with:

uv run python packages/graphics/examples/<filename>.py

Getting Started

Example	Description	Demo	Platforms
start_triangle.py	Minimal 2D triangle via draw() override.	Play	Web, Vulkan
start_bouncing_ball.py	Colourful balls bouncing off screen edges.	Play	Web, Vulkan
start_rotating_cube.py	Simple 3D rotating cube using the node system.	Play	Web, Vulkan

2D Games

Example	Description	Demo	Platforms
game_pong.py	Two-player Pong with paddles, ball, and score.	Play	Web, Vulkan
game_platformer.py	CharacterBody2D with gravity, jump, and platforms.	Play	Web, Vulkan
game_asteroids2d.py	Classic arcade game with wrap-around physics.	Play	Web, Vulkan
game_spaceinvaders2d.py	Rows of enemies, bullets, and wave progression.	Play	Web, Vulkan
game_tictactoe/game.py	Classic two-player game built with UI widgets.	Play	Web, Vulkan
games/dungeon_explorer/main.py	Top-down dungeon crawler with procedural generation, loot, skill trees, and boss fights.	Play	Web

3D Games

Example	Description	Demo	Platforms
game_asteroids3d.py	Top-down arcade game with 3D objects.	Play	Web, Vulkan
game_spaceinvaders3d.py	Classic arcade game with 3D meshes.	Play	Web, Vulkan
game_physics_sandbox.py	Visual demo of the SimVX physics engine.	Play	Web, Vulkan
game_pad_grid.py	Pad instrument with recording, loop, and training modes.	Play	Web
game_planet_explorer.py	Infinite procedural flyover with terrain, day/night cycle, and weather.	Play	Web, Vulkan
game_tictactoe3d/game.py	3D board with animated X and O pieces.		—
game_deep_sea_aquarium/main.py	Bioluminescent underwater world with boids, music, and bloom.	Play	Web

2D Features

Example	Description	Demo	Platforms
2d_sprite.py	PNG textures as 2D quads via draw_texture().	Play	Web, Vulkan
2d_tilemap.py	GPU-rendered tilemap with multi-layer and player-follow camera.	Play	Web (TileMap rendering not yet supported on web.), Vulkan
2d_light.py	Coloured point lights with shadow-casting occluders.	Play	Web (2D lighting not composited on web — only occluder outlines and light markers render.), Vulkan (2D lighting not composited on web.)
2d_navigation.py	A* pathfinding – click-to-move character on a grid.	Play	Web, Vulkan
2d_ninepatch.py	9-slice sprite scaling via draw_texture_region().	Play	Web, Vulkan
2d_joints.py	2D physics joints (pendulum chain).	Play	Web, Vulkan
2d_path_follow.py	Path following with Curve2D and PathFollow2D.	Play	Web, Vulkan
2d_trail.py	Trail rendering behind moving objects.	Play	Web, Vulkan

3D Features

Example	Description	Demo	Platforms
3d_lighting.py	Directional, point, and spot lights.	Play	Web, Vulkan
3d_shadows.py	Cascade shadow maps with debug visualisation.		—
3d_point_shadows.py	Point and spot light shadow maps.		—
3d_ssao.py	Screen-space ambient occlusion.		—
3d_fog.py	Fog and colour grading via WorldEnvironment.	Play	Web (Fog renders differently than desktop (no tonemap exposure on web).), Vulkan
3d_ibl.py	Image-based lighting with metallic spheres.	Play	Web (Skybox and image-based lighting not yet supported on web.), Vulkan
3d_particles.py	CPU + GPU particle effects with sub-emitters, collision, trails.	Play	Web (No particles render on web.), Vulkan (GPUParticles3D not rendered on web; CPU emitters still work.)
3d_model_viewer.py	Load glTF models with PBR textures and orbit camera.		Vulkan
3d_animation_blend.py	BlendSpace1D, crossfade, and keyframe events.	Play	Web, Vulkan
3d_motion_blur.py	Camera-based motion blur.		Vulkan
3d_multimesh.py	1600 instanced cubes via MultiMeshInstance3D.	Play	Web, Vulkan
3d_noise.py	Perlin, Simplex, Value, and Cellular noise side by side.	Play	Web, Vulkan
3d_picking.py	Mouse picking – click cubes to change colour.		—
3d_raycast.py	Ray grid with animated cubes and single/multi-hit toggle.		—
3d_render_layers.py	Object visibility via render layer bitmasks.		—
3d_textured_cubes.py	Checkerboard textures on cubes.		—
3d_mesh_parenting.py	MeshInstance3D rendering inside different parent node types.	Play	Web
3d_text.py	Text textures on 3D geometry + MSDF overlay.		—
3d_csg.py	CSG boolean operations (union, subtract, intersect).	Play	Web, Vulkan
3d_joints.py	3D physics joints (pin, hinge).	Play	Web (HingeJoint3D angular limits not enforced — door rotates full 360°.), Vulkan (HingeJoint3D angular limits not enforced.)
3d_navigation.py	3D pathfinding with NavigationAgent3D.	Play	Web, Vulkan
3d_skeletal.py	Skeletal animation with bone deformation.		—
3d_path_follow.py	3D path following (camera rail).		—
3d_custom_shader.py	ShaderMaterial API preview — visual effect blocked on renderer integration.		Vulkan (ShaderMaterial not yet applied on web — shapes render with default materials.)
3d_feature_showcase.py	Interactive 3D showcase: PBR, collisions, raycasting, DebugDraw.		—

UI

Example	Description	Demo	Platforms
ui_widget_showcase.py	Comprehensive UI showcase with DemoRunner.	Play	Web
ui_text_input.py	Character input, focus routing, and scissor clipping.		—
ui_menus.py	MenuBar with PopupMenu dropdowns and z-ordering.	Play	Web
ui_tree.py	Live scene tree inspector with expand/collapse.	Play	Web
ui_theme_demo.py	StyleBox theming system.		—
ui_terminal.py	Interactive terminal emulator running bash.		—
ui_audio.py	Audio – generate and play test tones.		—
ui_i18n.py	Translated text and locale switching.		—
ui_undo.py	Undo/Redo with Ctrl+Z / Ctrl+Shift+Z.		—
ui_gestures.py	Touch gesture recognition (tap, swipe, pinch, rotate).		—

Debug

Example	Description	Demo	Platforms
debug_draw.py	Wireframe boxes, spheres, axes, and rays.		—
debug_overlay.py	F3 debug overlay with feature cycling.		—