RootVG

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 Yarrow GUI library which powers the Meadowlark DAW.

You might also like...

ASCII 3D-renderer using Ray Marching technique written in Rust with NCurses

Comments

OpenGL bug with scissor rectangles

There seems to be a bug in wgpu when setting scissoring rectangles with the OpenGL backend, causing rendering issues. Further investigation is needed.

I have only tested the OpenGL backend on my Arch Linux system running on an AMD RX570 graphics card with the KDE desktop environment (I get the same problem in both Wayland and X11).

(I'm creating this issue for future reference.)

opened by BillyDM 0