animsmith-core 0.2.0

Engine-agnostic data model, sampling, measurements, and checks for the animsmith animation-clip linter
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

//! `non-uniform-scale` — unequal scale components are risky for many rigs and
//! retargeters, whether they are animated or held in a constant channel.

use super::tracks;
use super::vec3_trajectory::analyze;
use crate::check::{Check, CheckCtx};
use crate::evaluation::CheckOutput;
use crate::finding::{Finding, Severity};
use crate::model::Property;

/// Relative component spread beyond which a scale trajectory counts as
/// non-uniform.
pub const NON_UNIFORM_TOLERANCE: f32 = 1e-4;

pub struct NonUniformScale;

impl Check for NonUniformScale {
    fn id(&self) -> &'static str {
        "non-uniform-scale"
    }

    fn evaluate(&self, ctx: &CheckCtx) -> CheckOutput {
        let mut findings = Vec::new();
        for (clip, bone, track) in tracks(ctx.doc) {
            if track.property != Property::Scale {
                continue;
            }
            let Some(trajectory) = analyze(track) else {
                continue;
            };
            if trajectory.is_non_uniform(NON_UNIFORM_TOLERANCE) {
                findings.push(
                    Finding::new(
                        self.id(),
                        Severity::Warning,
                        "non-uniform scale present — verify it is intentional; many rigs and \
                         retargeters mishandle non-uniform scale",
                    )
                    .clip(clip)
                    .bone(bone)
                    .time(trajectory.max_pairwise_time()),
                );
            }
        }
        CheckOutput::from_coverage(findings, Vec::new(), Vec::new())
    }
}