moltrun 1.7.2

High-performance game engine library with AI capabilities, built on wgpu for modern 3D graphics and physics simulation
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71

/// YAML 컴포넌트 키 정의 - 타입 안전성과 IDE 지원을 위한 상수들
pub mod yaml_keys {
    // Transform 컴포넌트 키들
    pub mod transform {
        pub const POSITION: &str = "position";
        pub const ROTATION: &str = "rotation";
        pub const SCALE: &str = "scale";
    }
    
    // Sprite 컴포넌트 키들
    pub mod sprite {
        pub const TEXTURE: &str = "texture";
        pub const SIZE: &str = "size";
        pub const VISIBLE: &str = "visible";
        pub const TINT: &str = "tint";
        pub const FLIP_X: &str = "flip_x";
        pub const FLIP_Y: &str = "flip_y";
        pub const LAYER: &str = "layer";
    }
    
    // Text 컴포넌트 키들
    pub mod text {
        pub const CONTENT: &str = "content";
        pub const FONT: &str = "font";
        pub const FONT_SIZE: &str = "font_size";
        pub const COLOR: &str = "color";
        pub const VISIBLE: &str = "visible";
        pub const ALIGNMENT: &str = "alignment";
        pub const LINE_SPACING: &str = "line_spacing";
        pub const LAYER: &str = "layer";
    }
}

/// YAML 값 파싱을 위한 헬퍼 유틸리티들
pub mod yaml_utils {
    use serde_yaml::Value;
    use crate::math::Vec2;
    use crate::components::Color;

    #[derive(Debug, thiserror::Error)]
    pub enum YamlParseError {
        #[error("Invalid component data: {0}")]
        InvalidData(String),
    }
    
    pub fn parse_vec2_array(value: &Value, field_name: &str) -> Result<Vec2, YamlParseError> {
        if let Some(array) = value.as_sequence() {
            let x = array.get(0)
                .and_then(|v| v.as_f64())
                .ok_or_else(|| YamlParseError::InvalidData(format!("Invalid {} x component", field_name)))? as f32;
            let y = array.get(1)
                .and_then(|v| v.as_f64())
                .ok_or_else(|| YamlParseError::InvalidData(format!("Invalid {} y component", field_name)))? as f32;
            Ok(Vec2::new(x, y))
        } else {
            Err(YamlParseError::InvalidData(format!("Expected array for {}", field_name)))
        }
    }
    
    pub fn parse_color_array(value: &Value) -> Result<Color, YamlParseError> {
        if let Some(array) = value.as_sequence() {
            let r = array.get(0).and_then(|v| v.as_f64()).unwrap_or(1.0) as f32;
            let g = array.get(1).and_then(|v| v.as_f64()).unwrap_or(1.0) as f32;
            let b = array.get(2).and_then(|v| v.as_f64()).unwrap_or(1.0) as f32;
            let a = array.get(3).and_then(|v| v.as_f64()).unwrap_or(1.0) as f32;
            Ok(Color::new(r, g, b, a))
        } else {
            Ok(Color::white())
        }
    }
}