dioxus-motion 0.3.5

Animations library for Dioxus.
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
51
52
53
54
55
56
57

//! Epsilon utilities for animation precision control
//!
//! With the simplified Animatable trait, most animations use a single default epsilon (0.01).
//! This module provides validation utilities for custom epsilon values.

/// Validates that an epsilon value is within reasonable bounds
///
/// Ensures epsilon values are neither too small (causing infinite loops)
/// nor too large (causing jerky animations).
///
/// # Arguments
/// * `epsilon` - The epsilon value to validate
///
/// # Returns
/// * `Ok(())` if the epsilon is valid
/// * `Err(String)` with an error message if invalid
///
/// # Examples
/// ```rust
/// use dioxus_motion::animations::epsilon::validate_epsilon;
///
/// assert!(validate_epsilon(0.01).is_ok());
/// assert!(validate_epsilon(0.0).is_err());
/// assert!(validate_epsilon(0.2).is_err());
/// ```
pub fn validate_epsilon(epsilon: f32) -> Result<(), String> {
    if epsilon <= 0.0 {
        return Err("Epsilon must be positive".to_string());
    }

    if epsilon <= 0.000001 {
        return Err("Epsilon too small, may cause infinite animation loops".to_string());
    }

    if epsilon > 0.1 {
        return Err("Epsilon too large, may cause jerky animations".to_string());
    }

    Ok(())
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_validate_epsilon() {
        assert!(validate_epsilon(0.001).is_ok());
        assert!(validate_epsilon(0.01).is_ok());
        assert!(validate_epsilon(0.1).is_ok());

        assert!(validate_epsilon(0.0).is_err());
        assert!(validate_epsilon(-0.001).is_err());
        assert!(validate_epsilon(0.000001).is_err());
        assert!(validate_epsilon(0.2).is_err());
    }
}