Crate vello_common 

This crate includes common geometry representations, tiling logic, and other fundamental components used by both Vello CPU and Vello Hybrid.

Usage

This crate should not be used on its own, and you should instead use one of the renderers which use it. At the moment, only Vello CPU is published, and you probably want to use that.

We also develop Vello, which makes use of the GPU for 2D rendering and has higher performance than Vello CPU. Vello CPU is being developed as part of work to address shortcomings in Vello. Vello does not use this crate.

Features

• std (enabled by default): Get floating point functions from the standard library (likely using your target’s libc).
• libm: Use floating point implementations from libm.
• png (enabled by default): Allow loading Pixmaps from PNG images. Also required for rendering glyphs with an embedded PNG. Implies std.

At least one of std and libm is required; std overrides libm.

Contents

• Shared data structures for paths, tiles, and strips
• Geometry processing utilities
• Common logic for rendering stages

This crate acts as a foundation for vello_cpu and vello_hybrid, providing essential components to minimize duplication.

Re-exports

pub use fearless_simd;

pub use peniko;

pub use peniko::color;

pub use peniko::kurbo;

Modules

blurred_rounded_rect

Blurred, rounded rectangles.

clip

Managing clipping state.

encode

Paints for drawing shapes.

filter

Common filter helper functions.

filter_effects

Filter effects API based on the W3C Filter Effects specification.

flatten

Flattening filled and stroked paths.

flatten_simd 🔒

This is a temporary module that contains a SIMD version of flattening of cubic curves, as well as some code that was copied from kurbo, which is needed to reimplement the full flatten method.

geometry

Geometry utilities.

image_cache

Image resource caching with multi-atlas allocation.

mask

Alpha and luminance masks.

math

Mathematical helper functions.

multi_atlas

Multi-atlas management for texture atlases.

paint

Types for paints.

pixmap

A simple pixmap type.

record

Recording rendering commands.

rect

Fast pixel-aligned rectangle rendering directly into strips.

render_state

Shared render state.

simd

A number of SIMD extension traits.

strip

Rendering strips.

strip_generator

Abstraction for generating strips from paths.

tile

Primitives for creating tiles.

transforms

Shared structures for holding different transforms.

util

Utility functions.

viewport

Shared viewport state.

Structs

TextureId

A handle to an external, user-provided texture.