Crate vello_common 

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

Usage

This crate should not be used on its own, and you should instead use one of the renderers which use it. Choose Vello CPU for CPU-only rendering or Vello GPU for GPU rasterization with CPU-side preprocessing. The compute-centric vello renderer is a separate architecture and 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_gpu, providing essential components to minimize duplication.

Re-exports

pub use target::TargetInit;

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.

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.

target

Configuring how a render target is initialized before drawing.

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.