Struct BinaryRasterizer

pub struct BinaryRasterizer { /* private fields */ }

A rasterizer that burns shapes into a 2-dimensional boolean array. It can be built either by calling new or using BinaryBuilder.

Each Rasterizer requires a width and height measured in pixels that describe the shape of the output array. They can optionally take an affine transform that describes how to convert world-space coordinates into pixel-space coordinates. When a transformer is supplied, all of its parameters must be finite or RasterizeError::NonFiniteCoordinate will be returned.

use geo::{Geometry, Line, Point};
use ndarray::array;
use geo_rasterize::BinaryBuilder;

let shapes: Vec<Geometry<i32>> =
    vec![Point::new(3, 4).into(),
         Line::new((0, 3), (3, 0)).into()];

let mut r = BinaryBuilder::new().width(4).height(5).build()?;
for shape in shapes {
    r.rasterize(&shape)?;
}

let pixels = r.finish();
assert_eq!(
    pixels.mapv(|v| v as u8),
    array![
        [0, 0, 1, 0],
        [0, 1, 1, 0],
        [1, 1, 0, 0],
        [1, 0, 0, 0],
        [0, 0, 0, 1]
    ]
);

Implementations

impl BinaryRasterizer

pub fn new( width: usize, height: usize, geo_to_pix: Option<Transform>, ) -> Result<Self>

pub fn geo_to_pix(&self) -> Option<Transform>

Retrieve the transform.

pub fn rasterize<Coord, InputShape, ShapeAsF64>( &mut self, shape: &InputShape, ) -> Result<()>

where InputShape: MapCoords<Coord, f64, Output = ShapeAsF64>, ShapeAsF64: Rasterize<u8> + for<'a> CoordsIter<'a, Scalar = f64> + MapCoordsInplace<f64>, Coord: Into<f64> + Copy + Debug + Num + NumCast + PartialOrd,

Rasterize one shape, which can be any type that geo provides using any coordinate numeric type that can be converted into f64.

pub fn finish(self) -> Array2<bool>

Retrieve the completed raster array.

Trait Implementations

impl Clone for BinaryRasterizer

fn clone(&self) -> BinaryRasterizer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BinaryRasterizer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.