Struct InstanceUpload 

pub struct InstanceUpload { /* private fields */ }

Checked immutable device payload without graphics API handles.

Implementations

impl InstanceUpload

pub fn new( records: impl ExactSizeIterator<Item = InstanceRecord>, sprite_size: [u32; 2], texels: impl IntoIterator<Item = [f32; 4]>, ) -> Result<Self, ValidationError>

Encodes checked twelve-word source-over primitives followed by a shared row-major linear RGBA image. A zero image size requires no texels; sprite records require a nonempty image.

pub fn new_blended( records: impl ExactSizeIterator<Item = InstanceRecord>, sprite_size: [u32; 2], texels: impl IntoIterator<Item = [f32; 4]>, blend: InstanceBlend, ) -> Result<Self, ValidationError>

Like Self::new, with an explicit batch compositing rule.

pub fn new_extended( records: impl ExactSizeIterator<Item = ExtendedInstanceRecord>, sprite_size: [u32; 2], texels: impl IntoIterator<Item = [f32; 4]>, blend: InstanceBlend, ) -> Result<Self, ValidationError>

Encodes versioned sixteen-word primitives and a batch compositing rule.

pub fn len(&self) -> usize

Number of encoded primitives.

pub fn is_empty(&self) -> bool

Whether no primitives are encoded.

pub fn bytes(&self) -> u64

Exact logical byte charge, including the header and shared image.

pub fn into_words(self) -> Vec<f32>

Transfers the validated words to the device planner without another allocation.

Trait Implementations

impl Debug for InstanceUpload

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

Formats the value using the given formatter.