isgasho / contrast_renderer

Contrast is a web-gpu based 2D render engine written in Rust.

Contrast Renderer

Contrast is a web-gpu based 2D renderer written in Rust. It renders planar vector graphics and can easily be integrated with other forward-rendering code. Filling uses implicit curves and is resolution-independent, while stroking uses parametric curves and is approximated via polygon tesselation. This way you can have non-diegetic, diegetic and spacial GUI elements on any flat plane:

• As classic 2D menu overlay on top of the 3D scene.
• As HUD fixed relative to the camera movement but occluded by the 3D scene.
• As decals on walls or holograms hovering in the 3D scene.

To get started, checkout the showcase example.

Feature Roadmap

✓ Supported and implemented
◯ Rudimentary support
✗ Planned support, not implemented

• Rendering
  • Anti Aliasing ◯
    • MSAA ✓
  • Custom (User Defined) Shaders ✓
  • Instancing ✓
  • Depth Test ✗
• Filling
  • Paths
    • Polygons ✓
    • Bezier Curves
      • Integral (Normal)
        • Quadratic ✓
        • Cubic ✓
      • Rational (Weighted)
        • Quadratic ✓
        • Cubic ✓
  • Winding Fill Rules ✓
  • Nestable Clipping ✓
  • Nestable Group Opacity ✓
  • Custom (User Defined) Blending ✓
• Stroking
  • Paths
    • Polygons ✓
    • Bezier Curves
      • Approximation
        • Uniformly Spaced Parameters ✓
        • Uniform Tangent Angle ✓
        • Uniform Arc Length ✗
      • Integral (Normal)
        • Quadratic ✓
        • Cubic ✓
      • Rational (Weighted)
        • Quadratic ✓
        • Cubic ✓
  • Stroke Width ✓
  • Stroke Offset ◯
  • Closed / Open ✓
  • Line Joins
    • (Clipped) Miter ✓
    • Bevel ✓
    • Round ✓
  • Line Caps (Square, Round, Out, In, Right, Left, Butt) ✓
  • Dashing
    • Phase Translation ✓
    • Repeating Gap Intervals ✓
    • Dynamically Adjustable (for Animations) ✓
• Path Constructors
  • Polygon ✓
  • Bezier Curves
    • Integral (Normal)
      • Quadratic ✓
      • Cubic ✓
    • Rational (Weighted)
      • Quadratic ✓
      • Cubic ✓
  • Rect ✓
  • Rounded Rect ✓
  • Ellipse ✓
  • Circle ✓
  • Circle Arc ✓
  • [Optional] Font (TTF)
    • Glyph ✓
    • Text ◯
• Graphical User Interface ✗

Dependencies

Dependencies of the Library

• Graphics API: wgpu
• Geometric Algebra: geometric_algebra
• [Optional] Font Loader: ttf-parser

Dependencies of the Examples

• Window API: winit
• Logging: log