Struct ParticleBatch 

pub struct ParticleBatch { /* private fields */ }

Validated opaque instance payload, consumed directly by CPU/GPU paths.

Implementations

impl ParticleBatch

pub fn len(&self) -> usize

Number of dot/sprite/segment instances, including Plexus links.

pub fn is_empty(&self) -> bool

Whether this payload contains no instances.

pub fn bounds(&self) -> Rect

Conservative local geometric extent (before output antialias padding).

Trait Implementations

impl Clone for ParticleBatch

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParticleBatch

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

Formats the value using the given formatter.

impl Drawable for ParticleBatch

fn bounds(&self, context: &DrawContext) -> Result<Rect, ValidationError>

Local layout/ink bounds before node placement; invalid content is an error.

fn draw( &self, _: &DrawContext, canvas: &mut Canvas<'_>, ) -> Result<(), ValidationError>

Emits local commands; validation errors propagate without partial output.

fn baseline(&self, _context: &DrawContext) -> Option<f64>

Real horizontal text baseline in local coordinates; geometry has none.

impl InstanceBatch for ParticleBatch

fn analytic_upload(&self) -> Option<&AnalyticInstanceUpload>

Optional checked seeded trajectory program replacing evaluated primitive positions. Existing generic batches and fixed-step simulations retain their ordinary uploads.

fn analytic_fallback(&self) -> Option<&ValidationError>

Explicit reason an otherwise analytic batch retains evaluated CPU primitives.

fn blend(&self) -> InstanceBlend

Batch compositing policy; the default is source-over.

fn len(&self) -> usize

Number of independently painted instances.

fn bounds(&self) -> Rect

Conservative local bounds.

fn bytes(&self) -> u64

Retained logical bytes charged during preparation.

fn work(&self) -> u64

Conservative sampling work per output pixel.

fn spatial(&self) -> Option<&dyn SpatialInstances>

Optional conservative supports and ordered sampling; defaults to full-batch traversal.

fn validate(&self) -> Result<(), ValidationError>

Validates all stored instance/style values, including hidden instances.

fn sample( &self, point: Point, antialias: f64, destination: [f32; 4], space: BlendSpace, composite: InstanceComposite, ) -> Result<[f32; 4], ValidationError>

Samples instances in their declared order using the consumer’s compositor.

fn sample_with_zero_identity( &self, point: Point, antialias: f64, destination: [f32; 4], space: BlendSpace, composite: InstanceComposite, ) -> Result<[f32; 4], ValidationError>

Samples with a compositor for which every all-zero source, including signed zeros, is an infallible identity without observable side effects. Implementations may omit those calls, but must preserve nonzero sample order and errors. The default retains the ordinary sampling behavior. Callers with an arbitrary compositor must use Self::sample instead.

fn as_any(&self) -> &dyn Any

Resolves concrete content only within its owning implementation.

fn content_eq(&self, other: &dyn InstanceBatch) -> bool

Compares the logical payload of two instance records.

fn is_empty(&self) -> bool

Whether no instances are present.

fn upload_bytes(&self) -> u64

Exact upload charge for preflight admission; zero by default for CPU-only batches.

fn upload(&self) -> Result<Option<InstanceUpload>, ValidationError>

Checked evaluated primitives, or None when only CPU sampling is available.

impl PartialEq for ParticleBatch

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl SpatialInstances for ParticleBatch

fn support(&self, index: usize, antialias: f64) -> Rect

Local support, including antialiasing and numeric guards, for one instance.

fn sample_indices( &self, indices: &[usize], point: Point, antialias: f64, destination: [f32; 4], space: BlendSpace, composite: InstanceComposite, ) -> Result<[f32; 4], ValidationError>

Samples only the ascending, in-range instance indices supplied by a consumer. The compositor must treat all-zero sources as infallible identities.