wow-m2 0.6.4

Parser, validator, and converter for World of Warcraft M2 model files with animation support
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
72
73
74
75
76
77
78
79
80
81
82

//! Example: Loading and inspecting an M2 model
//!
//! This example demonstrates how to load an M2 model file and print basic information about it.
//!
//! Usage: cargo run --example load_model -- <path_to_m2_file>

use wow_m2::M2Model;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Get the file path from command line arguments
    let args: Vec<String> = std::env::args().collect();
    if args.len() < 2 {
        eprintln!("Usage: {} <path_to_m2_file>", args[0]);
        std::process::exit(1);
    }

    let path = &args[1];

    // Load the model
    println!("Loading model from: {path}");
    let m2_format = M2Model::load(path)?;
    let model = m2_format.model();

    // Print basic information
    println!("\n=== Model Information ===");
    println!(
        "Format: {}",
        if m2_format.is_chunked() {
            "Chunked (MD21)"
        } else {
            "Legacy (MD20)"
        }
    );
    println!("Name: {:?}", model.name);
    println!("Version: {:?}", model.header.version());
    println!("Magic: {:?}", std::str::from_utf8(&model.header.magic)?);

    // Print counts
    println!("\n=== Model Statistics ===");
    println!("Vertices: {}", model.vertices.len());
    println!("Bones: {}", model.bones.len());
    println!("Textures: {}", model.textures.len());
    println!("Materials: {}", model.materials.len());
    println!("Animations: {}", model.animations.len());
    println!("Animation Lookups: {}", model.animation_lookup.len());

    // Print texture information
    if !model.textures.is_empty() {
        println!("\n=== Textures ===");
        for (i, texture) in model.textures.iter().enumerate() {
            println!(
                "Texture {}: Type={:?}, Flags={:?}",
                i, texture.texture_type, texture.flags
            );
        }
    }

    // Print animations
    if !model.animations.is_empty() {
        println!("\n=== Animations ===");
        for (i, anim) in model.animations.iter().take(5).enumerate() {
            println!(
                "Animation {}: ID={}, SubID={}, Flags={:#x}",
                i, anim.animation_id, anim.sub_animation_id, anim.flags
            );
        }
        if model.animations.len() > 5 {
            println!("... and {} more animations", model.animations.len() - 5);
        }
    }

    // Check model bounds
    println!("\n=== Model Bounds ===");
    println!("Bounding Box Min: {:?}", model.header.bounding_box_min);
    println!("Bounding Box Max: {:?}", model.header.bounding_box_max);
    println!(
        "Bounding Sphere Radius: {}",
        model.header.bounding_sphere_radius
    );

    Ok(())
}