Skip to content

ROADMAP.md

Latest commit

 

History

History
377 lines (307 loc) · 20.1 KB

ROADMAP.md

File metadata and controls

377 lines (307 loc) · 20.1 KB
Raw

gg Roadmap

Enterprise-Grade 2D Graphics Library for Go

Designed to power IDEs, browsers, and professional graphics applications.

Vision

gg is a Pure Go 2D graphics library following modern Rust patterns (vello, tiny-skia, kurbo). Our goal is to provide production-ready 2D rendering for Go applications without CGO dependencies.

Core Principles

  1. Pure Go — No CGO, easy cross-compilation, single binary deployment
  2. GPU-First — Designed for GPU acceleration from day one
  3. Production-Ready — Enterprise-grade error handling and patterns
  4. API Stability — Semantic versioning with clear deprecation policy

Current State: v0.50.0

✅ Production-ready with GPU-accelerated rendering:

  • Text stroke/outline (ADR-033) — StrokeString + TextPath, Skia/Cairo/HTML5 pattern
  • Aliased text (ADR-034) — TextModeAliased on GPU (Tier 6 NoAAFiller) AND CPU (per-glyph binary rasterization), Skia kAlias parity
  • Per-glyph text rendering (ADR-039) — fractional glyph advances (Skia linearMetrics), hinted outlines + fractional positioning
  • Stroke inner join (ADR-038) — tiny-skia parity, no teeth on thick strokes
  • SparseStripsFiller winding — Vello backdrop.wgsl prefix-sum, windingDelta propagation
  • SDF thin stroke fallback (ADR-040) — lineWidth < 2.0 → geometric expansion
  • NaN safety (ADR-035) — depth guards on all 12 recursive flatten functions
  • Damage union — forwardDamageRects unions explicit + frame damage
  • CJK text rendering (ADR-027) — script-aware hinting, exact-size rasterization, dual MSDF atlas 64/128px
  • Damage-aware compositing (ADR-026) — LoadOpLoad + scissor, TrackDamageRect, debug overlay dedup
  • Scene text TagText (ADR-022) — glyph references, shape-once, DrawShapedGlyphs (Skia drawTextBlob)
  • ClearType LCD auto-detection (ADR-024) — Windows SPI, macOS None, Linux Xft/Wayland
  • Four-level damage pipeline (ADR-021) — Object Diff → Tile Dirty → GPU Scissor → OS Present
  • Seven-tier GPU render pipeline (SDF + Convex + Stencil+Cover + Textured Quad + MSDF Text + Compute + Glyph Mask)
  • Zero-readback compositor pipeline (ADR-015/016), single command buffer (ADR-017)
  • All 5 backends: Vulkan, DX12, DX12+DXIL, GLES, Software
  • Skia AAA pixel-perfect rasterizer, Vello 9-stage compute pipeline
  • Smart multi-engine rasterizer — 6 algorithms with per-path auto-selection
  • SVG renderer, Recording System (PDF/SVG export), premultiplied alpha, 29 blend modes

Roadmap to v1.0.0 (November 2027 — Go's 18th anniversary)

v0.49.x — Font Stack Foundation (Q2-Q3 2026) ✅ COMPLETE

  • Enterprise auto-hinter — skrifa golden parity, 17/19 diff=0, 6 scripts
  • TrueType bytecode interpreter — 200+ opcodes, 624/624 skrifa diff=0
  • HVAR variable font advance — own parser, ItemVariationStore

v0.50.0 — Pure Go Font Stack (Q3 2026) ✅ COMPLETE

  • Own font table parsers — cmap (format 4/6/12), hmtx/hhea, name, head/OS/2
  • gvar/avar variable font outlines — IUP interpolation, skrifa phantom diff=0
  • GSUB/GPOS shaper — ligatures, kerning, 5-10x faster than HarfBuzz
  • Integration — ownParsedFont + OwnShaper as defaults, sfnt/go-text decoupled
  • Performance benchmarks — 27 benchmarks, own parser 7-46x faster than sfnt

v0.51.0 — Gradients & Clipping (Q3-Q4 2026)

  • Linear & radial gradients — BrushLinearGradient/BrushRadialGradient, GPU SDF gradient shader
  • GPU-CLIP-003d — stencil-based arbitrary path clip for text + complex shapes
  • Thread safety (#365) — atomic global caches, Context.closed CAS, sync.Once for gpuCtx
  • Performance (#365) — scissor groups ownership transfer (~5-10% CPU), path conversion scratch buffers

v0.52.0 — API Quality (Q4 2026)

  • Type alias cleanup (#365) — replace 7 public aliases with real types (breaking)
  • Error hierarchy — GPUError, FontError, RenderError with sentinel values
  • wgpu#218 migration — gputypes direct imports (13 files, 86 lines)
  • Deprecated Paint fields — removal or v2.0 commitment (Pattern, LineWidth, LineCap, LineJoin)
  • Test coverage for GPU core — gpu_render_context.go (0 tests → 50+), render_session.go expansion

v0.53.0+ — Advanced Features (Q4 2026 – Q1 2027)

  • Conic gradients — sweep/angular gradient (CSS conic-gradient parity)
  • Mesh gradients — Coons patch (Inkscape/SVG2 pattern)
  • Path boolean operations — union, intersect, difference, XOR (Skia PathOps)
  • GPU blur/shadow — Gaussian blur compute shader, drop shadows (Skia SkMaskFilter)
  • Backdrop filters — blur, color matrix behind layers (CSS backdrop-filter, Flutter BackdropFilter)
  • Color filter layers — hue/saturation/brightness per-layer (Skia SkColorFilter)

v0.54.0 — Platform Expansion (Q1–Q2 2027)

  • WebAssembly — browser rendering via wgpu Browser backend (js,wasm build tag)
  • Android/iOS — mobile GPU rendering via wgpu Metal/Vulkan
  • SVG 2.0 compliance — full SVG rendering (JSVG-level feature parity)
  • PDF export improvements — gradients, clipping, transparency in PDF output

Pre-1.0.0 — API Freeze Blockers

  • API-001 — GPU handle API shape: generics Handle[Tag] vs plain structs
  • API-002 — eliminate remaining any (PresentTexture, DrawText face, Canvas.texture)
  • API-003 — full public API review: exported types, interfaces, error types
  • fogleman/gg migration guide — side-by-side comparison, breaking changes documented
  • Performance baseline — published benchmarks with regression tracking
  • 90%+ test coverage on core API (context.go, path.go, software.go)

v1.0.0 — Production Release (November 2027)

  • API stability guarantee — no breaking changes without major version bump
  • Semantic versioning commitment with deprecation policy
  • Enterprise deployment guide with configuration reference
  • Comprehensive pkg.go.dev documentation with examples for every public type
  • Long-term support plan (LTS branch for critical fixes)

Current Release

v0.48.13 — Current

  • Dependencies — gogpu v0.42.0 → v0.42.1

v0.48.12 ✅ Released

  • AMD stencil invert workaround (#374, @lkmavi) — dynamic fill rule via HadInnerJoin()
  • Smooth paths → NonZero (avoids buggy StencilOperationInvert on AMD D3D12)
  • Sharp paths → EvenOdd (correct V-shape handling)
  • 3 regression tests + 4 Vello accumulator tests updated

v0.48.11 ✅ Released

  • Vello StrokePath EvenOdd fill rule (#369, ADR-043, @TimLai666) — thin strokes solid fill on GPU compute

v0.48.10 ✅ Released

  • Backdrop prefix sum boundary fix (BUG-BACKDROP-001, ADR-042) — Vello backdrop_dyn pattern
  • wgpu v0.30.1 opaque handle migration — DeviceFromHandle/AdapterFromHandle, zero unsafe.Pointer
  • Dependencies — wgpu v0.30.1, gogpu v0.42.0, gpucontext v0.21.0

v0.48.9 ✅ Released

  • Glyph mask quadOffset fix (BUG-GLYPHMASK-001, #365) — text invisible in offscreen GPU textures
  • Dependencies — wgpu v0.29.15, naga v0.17.15, gogpu v0.41.14

v0.48.8 ✅ Released

  • HiDPI double-scale fix (#361, @TuSKan) — deviceMatrix applied twice in text outlines
  • OpenType font features (#362, @TuSKan) — WithFeatures(TabularNums), Language() fix

v0.48.6–v0.48.7 ✅ Released

  • SparseStripsFiller winding propagation (BUG-SPARSE-STRIPS-001) — Vello backdrop.wgsl parity
  • SDF thin stroke fallback (#346, ADR-040) — lineWidth < 2.0 → geometric expansion
  • Present damage union — forwardDamageRects unions explicit + frame damage
  • Dependencies update

v0.48.5 ✅ Released

  • TextModeAliased CPU fallback (#353) — per-glyph NoAAFiller, works without GPU
  • Fractional glyph advances (ADR-039) — Skia linearMetrics, letters no longer merge at 10-12px
  • Per-glyph text rendering — text.Draw replaced font.Drawer with RasterizeHinted

v0.48.4 ✅ Released

  • Stroke inner join teeth (#354, #353, ADR-038) — tiny-skia stroker.rs parity

v0.48.0–v0.48.3 ✅ Released

  • Text stroke (ADR-033), TextModeAliased GPU (ADR-034), zero-alloc paint (ADR-036)
  • Scissor coalescing (#335 @celer), NaN safety (ADR-035), polygon rotation (#334 @rcarlier)
  • GPU stroke polyline fix (#347 @TuSKan), stroke expander kurbo parity, BUG-SDF-001

v0.47.0–v0.47.4 ✅ Released

  • Pixel-Perfect Mode (ADR-030), text batch coalescing (ADR-031)
  • HiDPI damage scaling, NewPixmapFromBuffer zero-copy

v0.46.0–v0.46.11 ✅ Released

v0.45.2–v0.45.3 ✅ Released

  • GPU scene clip: transform Push/Pop fix (BUG-GG-GPU-SCENE-CLIP-001)
  • Rect clips → hardware scissor in GPUSceneRenderer
  • SetDamageTracking API (ADR-021)
  • Flash-and-fade damage debug overlay (GOGPU_DEBUG_DAMAGE=1)
  • Scene Append layer-aware encoding
  • TagStroke LineCap/LineJoin/MiterLimit fix
  • Software backend softwareMode flag (lazy GPU init)

v0.44.0–v0.45.1 ✅ Released

  • GPU-CLIP-003a: Depth-based arbitrary path clipping (Impeller/Graphite pattern)
  • GPU-CLIP-003b: Vello coarse.wgsl clip tag dispatch
  • dc.Clip() GPU bridge + stencil-then-cover-to-depth
  • Four-level damage pipeline (ADR-021, ADR-020)
  • Adapter-aware render mode (GOGPU_RENDER_MODE)
  • clip_path + damage_demo examples

v0.43.3–v0.43.7 ✅ Released

  • Scene fixes (CTM, transform stack, LoadOp, image index, AppendWithTranslation)
  • DrawGPUTextureWithOpacity, ADR-018 type-safe handles, ADR-019 render pass blit
  • Auto-hinter stem collapse 12px, Retina text half-size fix (#276)
  • deps cascade: wgpu v0.26.12, gogpu v0.31.0, naga v0.17.10

v0.43.1–v0.43.2 ✅ Released

  • Blit-only fix, type-safe GPU handles (ADR-018), overlay fix, 14 enterprise tests

Pre-1.0.0 — Public API Freeze Blockers

  • API-001: GPU handle API shape — generics Handle[Tag] vs plain structs (ADR-018 follow-up). Must decide before 1.0.0 — changing after = breaking. See docs/dev/kanban/0-backlog/API-001-gpu-handle-generics-vs-struct.md
  • API-002: Eliminate remaining any — face any in DrawText (circular dep), Canvas.texture any (internal), PresentTexture(tex any) (cross-package token)
  • API-003: Public API review — full audit of exported types, methods, interfaces before freeze

v0.43.0–v0.43.1 ✅ Released

  • Zero-readback compositor pipeline (ADR-015/016) — FlushPixmap, DrawGPUTextureBase, BeginGPUFrame, non-MSAA blit path
  • Single command buffer compositor (ADR-017, Flutter Impeller pattern) — CreateSharedEncoder + SubmitSharedEncoder
  • Non-MSAA blit-only fast path — 93% bandwidth reduction for compositor-only frames
  • FillRectCPU + Pixmap.FillRect — CPU-only rect fill bypassing GPU accelerator
  • FlushGPUWithViewDamage — damage-aware sub-region compositing
  • Blit-only black screen fix — early return skipped baseLayer-only frames
  • GPU texture resource leak fix — session-level persistent buffers (grow-only)
  • blit_only example — standalone non-MSAA compositor demo
  • Dependencies: wgpu v0.26.4, gogpu v0.29.2

v0.42.0–v0.42.1 ✅ Released

  • GPU-to-GPU texture compositing — DrawGPUTexture + CreateOffscreenTexture (Flutter pattern)
  • Bullet-proof encoder lifecycle — defer-based safety, MinBindingSize
  • DrawGPUTexture deep-copy fix (v0.42.1)

v0.41.0 ✅ Released

  • Per-context GPU accelerator (ARCH-GG-001, ADR-013) — Skia GrContext pattern
  • GPU textured quad pipeline (Tier 3) — DrawImage GPU rendering
  • Skia AAA pixel-perfect rasterizer — coverage diff=0 vs C++ Skia
  • Convex fast path (RAST-012) — 1.6x faster, zero allocs
  • Scene GPU auto-select — GPU rendering for retained-mode scenes
  • TexturePool — Flutter RenderTargetCache pattern
  • Per-pass View routing (PR #255) — WebGPU spec alignment
  • BUG-RAST-011 shadow fix (#235) — near-horizontal edge bleed eliminated

v0.40.0–v0.40.1 ✅ Released

  • Alpha mask API — per-shape, per-layer, luminance, GPU interface (v0.40.0)
  • Adreno Vulkan fix — packed blend stack + PIXELS_PER_THREAD=4 (#252)
  • Vello compute clip pipeline — SceneElement BeginClip/EndClip (ADR-012)
  • Buffer.Map API migration, deps update (wgpu v0.25.1, naga v0.17.4)
  • Removed incorrect gogpu dependency from go.mod

v0.39.0–v0.39.4 ✅ Released

  • Path SOA representation — zero per-verb allocs (ADR-010)
  • Zero-alloc rasterizer — FillRect/FillCircle 0 allocs/op
  • Comprehensive allocation reduction (gradients, scene, stroke, worker pool)
  • 3 dead naga SPIR-V workarounds removed (GPU golden verified)
  • Clear() API fix (#227), MSDF Retina fix (#247), ParseHex (#237)
  • dashQuad/dashCubic off-by-one fix

v0.37.4–v0.38.1 ✅ Released

  • Separate deviceMatrix from user CTM (#218), test coverage 81.5%
  • Enterprise SVG renderer, SVG path parser, ClearType LCD pipeline
  • DrawImage rotation fix (#224), GLES blit fix (#226)

v0.37.0–v0.37.3 ✅ Released

  • Migrate internal/gpu from hal to wgpu public API (zero hal imports)
  • Explicit SetViewport in all GPU render passes (#171)
  • Universal ggcanvas.Render() — one call, all backends
  • GLES/Software backend support
  • Pipeline clip recreation fix
  • naga v0.14.7–v0.14.8, wgpu v0.21.0–v0.21.3

v0.36.0–v0.36.4 ✅ Released

  • GPU Glyph Mask Cache (Tier 6) — CPU rasterize → R8 alpha atlas → GPU composite
  • RoundRectShape with SDF tile rendering
  • BeginClip/EndClip in tile renderer
  • Font hinting (auto-hinter ≤48px), ClearType LCD infrastructure
  • GPU scissor rect clipping (GPU-CLIP-001)
  • GPU RRect SDF clip in fragment shaders (GPU-CLIP-002)
  • naga MSL buffer(0) collision fix (v0.14.7)

v0.33.0–v0.35.3 ✅ Released

  • Text DPI scaling, MSDF fixes, TextMode API, vector text
  • HiDPI/Retina platform support (gogpu v0.23.0+)
  • MSDF atlas FontID collision fix

v0.25.0–v0.32.1 ✅ Released

  • Vello tile-based AA, architecture refactor, GPU acceleration
  • Five-tier GPU rendering, MSDF text, Vello 9-stage compute
  • Smart multi-engine rasterizer, CoverageFiller, RasterizerMode
  • Text API redesign, CPU text transform, Recording System

v1.0.0 — Production Release (see roadmap above)

Post-1.0 Vision

Theme Description Reference
3D integration Scene graph bridge to gogpu/g3d (PBR, glTF) Skia → Filament
Compute shaders for 2D Full Vello compute pipeline on GPU (all 9 stages) linebender/vello
SIMD rasterization Go 1.25+ goexperiment.simd for CPU path (AVX-512/NEON) GoMLX PackGEMM
Animation primitives Easing, spring physics, path interpolation Flutter AnimationController
Accessibility Screen reader text extraction, contrast analysis Skia SkAnnotation
Color management ICC profiles, Display P3, wide gamut Skia SkColorSpace

Architecture

                        gg (Public API)
                             │
         ┌───────────────────┼───────────────────┐
         │                   │                   │
   Immediate Mode       Retained Mode        Resources
   (Context API)      (scene.Renderer)    (Images, Fonts)
         │                   │                   │
         │              orchestration            │
         │         (tiles, workers, cache)       │
         │                   │                   │
         └───────────────────┼───────────────────┘
                             │ delegation
              ┌──────────────┴──────────────┐
              │                             │
      SoftwareRenderer                GPUAccelerator
      (always available)              (opt-in via gpu/)
              │                             │
    internal/raster              internal/gpu (seven-tier)
                                 ├── Tiers 1-4, 6 (render pass)
                                 └── Tier 5 (compute pipeline)

Released Versions

Version Date Highlights
v0.48.13 2026-06 Deps: gogpu v0.42.1
v0.48.12 2026-06 AMD stencil invert workaround (#374 @lkmavi), dynamic fill rule HadInnerJoin
v0.48.11 2026-06 Vello StrokePath EvenOdd (#369 @TimLai666), thin strokes solid fill fix
v0.48.10 2026-06 Backdrop prefix sum fix (ADR-042), wgpu v0.30.1 opaque handles, gogpu v0.42.0
v0.48.9 2026-06 Glyph mask quadOffset fix (BUG-GLYPHMASK-001, #365), deps v0.29.15/v0.17.15/v0.41.14
v0.48.8 2026-06 HiDPI fix (#361 @TuSKan), OpenType font features (#362 @TuSKan)
v0.48.7 2026-05 Dependencies update
v0.48.6 2026-05 SparseStripsFiller winding (Vello parity), SDF thin stroke fallback (#346), damage union
v0.48.5 2026-05 TextModeAliased CPU (#353), fractional advances (ADR-039), per-glyph rendering
v0.48.4 2026-05 Stroke inner join teeth (#354, ADR-038, tiny-skia parity)
v0.48.0–3 2026-05 Text stroke (ADR-033), aliased text GPU (ADR-034), GPU stroke fix (#347)
v0.47.0–4 2026-05 Pixel-Perfect Mode (ADR-030), text batch coalescing, HiDPI damage
v0.46.0–11 2026-05 CJK (ADR-027), damage pipeline (ADR-026), scene text (ADR-022), LCD auto-detect
v0.43.0–v0.45.4 2026-04 Compositor APIs, single command buffer, damage pipeline, GPU clips
v0.42.0 2026-04 GPU texture compositing (DrawGPUTexture + CreateOffscreenTexture), Flutter pattern
v0.41.0–2 2026-04 Per-context GPU (ADR-013), Tier 3 textured quad, Skia AAA, ImageCache genID, text kerning
v0.40.1 2026-04 Adreno fix (#252), Vello compute clip, Buffer.Map, deps update
v0.40.0 2026-04 Alpha mask API — per-shape, per-layer, luminance, GPU
v0.39.0–4 2026-04 Path SOA (ADR-010), zero-alloc rasterizer, MSDF Retina fix
v0.38.0–2 2026-03 SVG renderer, Clear() fix (#227), DrawImage rotation (#224)
v0.37.4 2026-03 Separate deviceMatrix/userMatrix (#218), test coverage 81.5%
v0.37.3 2026-03 Universal ggcanvas.Render(), GLES/Software support
v0.37.2 2026-03 Pipeline clip recreation + wgpu v0.21.2 validation
v0.37.1 2026-03 wgpu v0.21.1, gogpu v0.24.2
v0.37.0 2026-03 wgpu public API migration, SetViewport fix (#171), naga v0.14.7
v0.36.4 2026-03 GPU RRect SDF clip (GPU-CLIP-002), ClipRoundRect API
v0.36.0–3 2026-03 Glyph Mask Tier 6, RoundRectShape, scissor clip, font hinting, ClearType
v0.35.x 2026-03 MSDF atlas fixes, text DPI scaling
v0.34.x 2026-03 HiDPI/Retina support, diagnostic logging
v0.33.x 2026-03 TextMode API, MSDF quality improvements
v0.32.x 2026-02 Smart multi-engine rasterizer, CPU text transform
v0.31.x 2026-02 Text API redesign, DrawStringWrapped
v0.30.x 2026-02 Vello 9-stage compute pipeline
v0.29.x 2026-02 GPU MSDF text, scene.Renderer delegation
v0.28.x 2026-02 Three-tier GPU rendering, RenderDirect
v0.27.x 2026-02 SDF GPU acceleration, compute shaders
v0.25–26 2026-02 Vello AA rasterizer, architecture refactor
v0.1–24 2025-12 – 2026-02 Core features, GPU backend, text, images, recording

→ See CHANGELOG.md for detailed release notes

Contributing

We welcome contributions! Priority areas:

  1. API Feedback — Try the library and report pain points
  2. Test Cases — Expand test coverage
  3. Examples — Real-world usage examples
  4. Documentation — Improve docs and guides
  5. Performance — Benchmark and optimize hot paths

See CONTRIBUTING.md for guidelines.

Non-Goals

  • 3D graphics — See gogpu/gogpu
  • Animation system — Application layer concern
  • GUI widgets — See gogpu/ui (planned)

License

MIT License — see LICENSE for details.