Crate ochre

High-quality anti-aliased vector graphics rendering on the GPU.

ochre rasterizes paths to a set of 8×8-pixel alpha-mask tiles at the path's boundary and n×8-pixel solid spans for the path's interior, which can then be uploaded to the GPU and rendered. Paths are rasterized using a high-quality analytic anti-aliasing method suitable for both text and general vector graphics.

Example

use ochre::{PathCmd, Rasterizer, TileBuilder, Transform, Vec2, TILE_SIZE};

struct Builder;

impl TileBuilder for Builder {
    fn tile(&mut self, x: i16, y: i16, data: [u8; TILE_SIZE * TILE_SIZE]) {
        println!("tile at ({}, {}):", x, y);
        for row in 0..TILE_SIZE {
            print!("  ");
            for col in 0..TILE_SIZE {
                print!("{:3} ", data[row * TILE_SIZE + col]);
            }
            print!("\n");
        }
    }

    fn span(&mut self, x: i16, y: i16, width: u16) {
        println!("span at ({}, {}), width {}", x, y, width);
    }
}

fn main() {
    let mut builder = Builder;

    let mut rasterizer = Rasterizer::new();
    rasterizer.fill(&[
        PathCmd::Move(Vec2::new(400.0, 300.0)),
        PathCmd::Quadratic(Vec2::new(500.0, 200.0), Vec2::new(400.0, 100.0)),
        PathCmd::Cubic(Vec2::new(350.0, 150.0), Vec2::new(100.0, 250.0), Vec2::new(400.0, 300.0)),
        PathCmd::Close,
    ], Transform::id());
    rasterizer.finish(&mut builder);
}

Structs

Mat2x2	A 2×2 matrix, in row-major order.
Rasterizer	Rasterizes paths.
Transform	A 2-dimensional affine transformation.
Vec2	A 2-dimensional vector.

Enums

PathCmd

A single command in a 2-dimensional vector path.

Constants

TILE_SIZE

The tile size used by the rasterizer (not configurable).

Traits

TileBuilder

A trait to implement for consuming the tile data produced by [rasterize()].

Functions

flatten	Computes a piecewise-linear approximation of the given path to within the supplied parametric error tolerance.
stroke	Converts the given path to a stroked path with the given width.