rootvg

Crates.iorootvg
lib.rsrootvg
version0.1.0
sourcesrc
created_at2024-04-05 23:35:50.16895
updated_at2024-04-05 23:35:50.16895
descriptionA 2D vector graphics library optimized for GUIs
homepagehttps://github.com/MeadowlarkDAW/rootvg
repositoryhttps://github.com/MeadowlarkDAW/rootvg
max_upload_size
id1197943
size318,263
Billy Messenger (BillyDM)

documentation

README

RootVG

Documentation Crates.io License

A 2D vector graphics library optimized for GUIs, written in Rust and wgpu

How it Works

Unlike other 2D vector graphics libraries which have a streaming drawing API similar to HTML5's Canvas API, users of RootVG construct reusable "primitives" that can be cheaply cloned and added in any order with any z index and inside of any scissoring rectangle. Primitives of the same type, z index, and scissoring rectangle are automatically batched together so that the number of draw calls to the GPU are greatly reduced.

See the demo for a quick overview of how the API works.

Primitive Types

RootVG provides six primitive types:

  • SolidQuadPrimitive and GradientQuadPrimitive - based on the quad primitives from Iced
  • SolidMeshPrimitive and GradientMeshPrimitive - draws arbitrary triangles with a solid color or a gradient. The lyon crate is used to generate meshes.
  • TextPrimitive - powered by glyphon
  • ImagePrimitive - supports scale and rotation. The output of a previous render pass can also be used as a texture source.

Additionally, users can create custom primitives with custom rendering pipelines. This can be useful for creating things like efficient spectrometer and oscilloscope displays.

Primitives types that aren't needed can be disabled in the feature flags.

Motivation

This library was created for the upcoming GUI library that will power the Meadowlark DAW.

Commit count: 36

cargo fmt