aesir-utils-rs — Resolution-Independent Ultrawide & Multi-Monitor UI Layout Math

aesir-utils-rs is a zero-dependency Rust math library for scaling game interfaces and HUDs across 16:9, 21:9 ultrawide, 32:9 super-ultrawide, and bezel-corrected multi-monitor displays. It computes safe-zone anchor rectangles, aspect-ratio letterboxing, and DPI-aware coordinate transforms in sub-microsecond time.

$ cargo add aesir-utils-rs

GitHub ↗

Display Settings 16:9

Resolution Preset

Safezone Scalar ($S$) 0.90

Aspect Correction Mode

Mathematical Metrics

Resolution:1920 × 1080

Aspect Ratio (α):1.778

Category:Standard 16:9

Margins (Mx, My):96.0px, 54.0px

Safe Dimensions:1728 × 972

Comp Factor (Cx):1.000

Virtual Scale (1080p):1.000×

Rust Code Snippet

// Rust safezone initialization
let sz = Safezone::new(0.90);
let screen = Vec2::new(1920.0, 1080.0);
let rect = sz.compute_rect(screen);
let comp = AspectRatio::from_vec2(screen)
    .compensation_factor_16_9();

Screen Bounds

Safezone Perimeter ($S \in [0.8, 1.0]$)

UI Anchor Points (Minimap, HUD, Reticle)

Excluded Screen Margins

Verified Benchmarks Apple Silicon M-Series ARM64

aesir-utils-rs vs FiveM Lua / CEF Script Engines

Head-to-head performance comparing native pure Rust with zero heap allocations vs dynamic FiveM Lua coordinate math.

Full Benchmark Report (BENCHMARKS.md) →

Safezone & NDC Mapping

4.18 ns

48× – 108× faster vs Lua (239M/s)

Aspect & Viewport Fit

6.88 ns

29× – 73× faster vs Lua (145M/s)

9-Way Anchor Placement

3.19 ns

94× – 251× faster vs Lua (313M/s)

100-Elem Canvas Rescale

0.118 µs

169× – 380× faster (8.4M frames/s)

Scenario / Workload	aesir-utils-rs (Rust)	FiveM Lua Script	Speedup / Impact	Memory Overhead
Safezone Bounds & Two-Way Safe NDC	4.18 ns / eval	150 – 450 ns	48× – 108× faster	0 bytes (Registers)
Aspect Ratio Category & Viewport Fit	6.88 ns / eval	180 – 500 ns	29× – 73× faster	0 bytes (Stack)
9-Way Anchor Inward Placement	3.19 ns / eval	250 – 800 ns	94× – 251× faster	0 bytes (LUT)
Virtual 1080p Canvas (100 HUD Elements)	0.118 µs / frame	15 – 45 µs	169× – 380× faster	0 bytes (Zero GC)

Run the benchmark suite locally with Cargo: cargo run --release --example bench_vs_original