Struct BoneMask 

pub struct BoneMask {
    pub weights: Vec<f32>,
}

Per-bone blend weights in [0.0, 1.0] used for partial-body animation layers.

A weight of 1.0 means the layer fully overrides that bone; 0.0 means the bone is untouched.

Fields

weights: Vec<f32>

Indexed by bone index (same order as Skeleton::bones).

Implementations

impl BoneMask

pub fn uniform(bone_count: usize, default_weight: f32) -> Self

Create a mask with all weights set to default_weight.

pub fn zero(bone_count: usize) -> Self

Zero mask — no bones affected.

pub fn full_body(bone_count: usize) -> Self

Full-body mask — all bones at weight 1.0.

pub fn upper_body(skeleton: &Skeleton) -> Self

Upper-body preset for a standard humanoid skeleton.

Sets bones named with “spine”, “chest”, “neck”, “head”, “shoulder”, “arm”, “hand”, “finger”, “clavicle” to weight 1.0; all others to 0.0.

pub fn lower_body(skeleton: &Skeleton) -> Self

Lower-body preset for a standard humanoid skeleton.

Sets bones named with “hip”, “pelvis”, “leg”, “knee”, “ankle”, “foot”, “toe” to weight 1.0; all others to 0.0.

pub fn set_weight(&mut self, id: BoneId, weight: f32)

Set the weight for a specific bone.

pub fn get_weight(&self, id: BoneId) -> f32

Get the weight for a specific bone.

pub fn scale(&self, factor: f32) -> Self

Scale all weights by a factor.

pub fn union(&self, other: &BoneMask) -> Self

Combine two masks by taking the maximum weight per bone.

pub fn intersection(&self, other: &BoneMask) -> Self

Combine two masks by taking the minimum weight per bone.

pub fn invert(&self) -> Self

Invert all weights (1.0 - w).

pub fn from_pairs(bone_count: usize, pairs: &[(BoneId, f32)]) -> Self

Build a mask from an explicit list of (BoneId, weight) pairs.

pub fn from_bone_subtree( skeleton: &Skeleton, root_bones: &[BoneId], weight: f32, ) -> Self

Build a mask where only the listed bones (and their children) are active.

Trait Implementations

impl Clone for BoneMask

fn clone(&self) -> BoneMask

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BoneMask

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

Formats the value using the given formatter.