animsmith-core 0.6.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
48
49
50

//! `constant-nonunit-scale` — a retained non-unit scale channel can matter to
//! pipelines even when it has no temporal variation.

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;

/// Deviation from unit scale beyond which a constant channel is non-unit.
pub const UNIT_TOLERANCE: f32 = 1e-4;

pub struct ConstantNonunitScale;

impl Check for ConstantNonunitScale {
    fn id(&self) -> &'static str {
        "constant-nonunit-scale"
    }

    fn enabled_by_default(&self) -> bool {
        false
    }

    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.varies(UNIT_TOLERANCE)
                && trajectory.max_unit_deviation() > UNIT_TOLERANCE
            {
                findings.push(
                    Finding::new(
                        self.id(),
                        Severity::Note,
                        "constant non-unit scale channel present",
                    )
                    .clip(clip)
                    .bone(bone),
                );
            }
        }
        CheckOutput::from_coverage(findings, Vec::new(), Vec::new())
    }
}