plutonium_engine

A pure Rust 2D graphics engine built on wgpu. SVG-first, DPI-aware, with text and optional widgets.

Features:

• SVG textures rendered via resvg/tiny-skia
• Texture atlases with per-tile UVs
• Text rendering via a font atlas
• Optional retained-mode widgets: Texture2D, TextureAtlas2D, Text2D, Button, TextInput (feature: widgets)
• Camera with boundary and tether

Coordinate system:

• Logical pixels; origin top-left, +x right, +y down. DPI scaling handled internally.

API styles:

• Immediate-mode: begin_frame(), draw_*, end_frame()
• Optional retained widgets (feature widgets): higher-level objects that render via the same draw path
• DrawParams supports z, scale, rotation, and tint (RGBA) for sprites

Cargo features:

[features]

default = ["backend-wgpu"]

backend-wgpu = []           # WGPU backend

raster = []                 # PNG/JPEG helpers

widgets = []                # Retained-mode widgets

layout = []                 # Simple layout helpers (anchors/percent)

Versioning:

• The public API may evolve; see CHANGELOG.md for details.

Testing and CI:

• Unit tests (math, transforms, UVs) and headless snapshots (checkerboard, atlas, sprite, many sprites) are provided.
• Snapshots are intended to run locally; keep large perf snapshots out of CI.

Further docs in docs/:

• docs/coordinates-and-dpi.md
• docs/api-styles.md
• docs/features-and-modules.md
• docs/layering.md
• docs/getting-started.md
• docs/layout.md
• docs/instancing-and-batching.md