# 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:
```toml
[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`
