Struct ShapeBulkEval 

pub struct ShapeBulkEval<E: BulkEvaluator> { /* private fields */ }

Wrapper around a BulkEvaluator

Unlike the raw bulk evaluator, a ShapeBulkEval knows about the tape’s X, Y, Z axes and accepts a transform matrix.

Implementations

impl<E: BulkEvaluator> ShapeBulkEval<E>

where E::Data: From<f32> + Transformable,

pub fn eval( &mut self, tape: &ShapeTape<E::Tape>, x: &[E::Data], y: &[E::Data], z: &[E::Data], ) -> Result<&[E::Data], ShapeBulkEvalError>

Bulk evaluation of many samples, without any variables

If the shape includes variables other than X, Y, Z, eval_with_vars or eval_with_var_arrays should be used instead (and this function will return an error).

pub fn eval_with_transform( &mut self, tape: &ShapeTape<E::Tape>, x: &[E::Data], y: &[E::Data], z: &[E::Data], transform: &Matrix4<f32>, ) -> Result<&[E::Data], ShapeBulkEvalError>

Bulk evaluation of many samples with a transform

pub fn eval_with_var_arrays<V: Deref<Target = [G]>, G: Into<E::Data> + Copy>( &mut self, tape: &ShapeTape<E::Tape>, x: &[E::Data], y: &[E::Data], z: &[E::Data], vars: &ShapeVars<V>, ) -> Result<&[E::Data], ShapeBulkEvalError>

Bulk evaluation of many samples, with slices of variables

Each variable is a slice (or Vec) of values, which must be the same length as the x, y, z slices. This is in contrast with eval_with_vars, where variables have a single value used for every position in the x, y, z slices.

Before evaluation, the transform matrix is applied to input coordinates.

pub fn eval_with_transform_and_var_arrays<V: Deref<Target = [G]>, G: Into<E::Data> + Copy>( &mut self, tape: &ShapeTape<E::Tape>, x: &[E::Data], y: &[E::Data], z: &[E::Data], transform: &Matrix4<f32>, vars: &ShapeVars<V>, ) -> Result<&[E::Data], ShapeBulkEvalError>

Bulk evaluation of many transformed samples, with slices of variables

pub fn eval_with_vars<G: Into<E::Data> + Copy>( &mut self, tape: &ShapeTape<E::Tape>, x: &[E::Data], y: &[E::Data], z: &[E::Data], vars: &ShapeVars<G>, ) -> Result<&[E::Data], ShapeBulkEvalError>

Bulk evaluation of many samples, with fixed variables

Each variable has a single value, which is used for every position in the x, y, z slices. This is in contrast with eval_with_var_arrays, where variables can be different for every position in the x, y, z slices.

pub fn eval_with_transform_and_vars<G: Into<E::Data> + Copy>( &mut self, tape: &ShapeTape<E::Tape>, x: &[E::Data], y: &[E::Data], z: &[E::Data], transform: &Matrix4<f32>, vars: &ShapeVars<G>, ) -> Result<&[E::Data], ShapeBulkEvalError>

Bulk evaluation of many transformed samples, with fixed variables

pub fn var_array<V: Deref<Target = [G]>, G: Into<E::Data> + Copy>( vars: &ShapeVars<V>, ) -> impl Fn(&mut [E::Data], VarIndex) -> Result<(), ShapeBulkEvalError>

Helper to bind to a multi-value variable map

This is a building block for working with eval_raw, and you probably don’t need it unless you’re deep in the weeds.

pub fn var_value<G: Into<E::Data> + Copy>( vars: &ShapeVars<G>, ) -> impl Fn(&mut [E::Data], VarIndex) -> Result<(), ShapeBulkEvalError>

Helper to bind to a single-variable map

This is a building block for working with eval_raw, and you probably don’t need it unless you’re deep in the weeds.

pub fn eval_raw<F>( &mut self, tape: &ShapeTape<E::Tape>, x: &[E::Data], y: &[E::Data], z: &[E::Data], transform: Option<&Matrix4<f32>>, copy_vars: F, ) -> Result<&[E::Data], ShapeBulkEvalError>

where F: Fn(&mut [E::Data], VarIndex) -> Result<(), ShapeBulkEvalError>,

Core implementation of evaluation

copy_vars is a way to populate variable slices (other than the X, Y, Z inputs), and may be generated from a helper like var_value or var_array.

Trait Implementations

impl<E: Debug + BulkEvaluator> Debug for ShapeBulkEval<E>

where E::Data: Debug,

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

Formats the value using the given formatter.

impl<E: Default + BulkEvaluator> Default for ShapeBulkEval<E>

where E::Data: Default,

fn default() -> ShapeBulkEval<E>

Returns the “default value” for a type.