Struct Model 

pub struct Model { /* private fields */ }

A validated HMA1 blob.

The decoder reads keys without bounds checks, so the only way to build one is Model::new, which walks every clip and bone once and proves that no playback position can read outside the blob. The fields are private so safe code cannot widen what was proven.

Implementations

impl Model

pub fn new(d: &'static [u8]) -> Option<Model>

Validate and wrap an HMA1 blob. None when any clip, at any playback position, would read outside d, when a bone’s parent does not come before it (the decoder composes parents first), or when there are no clips.

pub fn bone_count(&self) -> usize

Number of bones; decode needs this many Affine slots.

pub fn clip_count(&self) -> usize

Number of clips in the blob (at least one).

pub fn clip_intervals(&self, clip: usize) -> u32

Source frame intervals of clip (numframes - 1, at least 1): the clip’s position runs 0..=clip_intervals * 256. Clips past the last read the last.

pub fn decode(&self, clip: usize, pos_q8: u32, out: &mut [Affine])

Decode every bone of clip at pos_q8 into model-space affines. Clips past the last decode the last; an out shorter than Model::bone_count is left untouched.

pub fn decode_with( &self, clip: usize, pos_q8: u32, jaw: &Jaw, out: &mut [Affine], )

Model::decode with a local controller rotation on one bone. out must hold at least n_bones entries.

Trait Implementations

impl Clone for Model

fn clone(&self) -> Model

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Model