#3d-model #obj #gltf #stl #texture #matrix #dae

morph3d

Yet another assimp alternative (obj, gltf & glb is supported). DAE, Stl and Usdz support is comming soon.

2 releases

0.1.1 Sep 6, 2024
0.1.0 Sep 6, 2024

#630 in Game dev

MIT/Apache

17KB
127 lines

morph3d

morph3d is a Rust crate for loading and processing 3D model files in various formats, including OBJ, GLTF, DAE, USDZ, and STL. This crate provides functionality to extract and manipulate mesh data such as vertices, indices, texture coordinates, and normals, and apply transformations to the loaded meshes.

Features

  • OBJ Loader: Load and process OBJ files, including vertices, normals, texture coordinates, and transformation matrices.
  • GLTF Loader: Load GLTF & GLB files with support for vertices, indices, texture coordinates, normals, and node matrices.

Upcomming

  • DAE Loader: Load Collada (DAE) files and extract vertices, indices, texture coordinates, and normals.
  • USDZ and STL Support: Soon.

Getting Started

Installation

Add morph3d to your Cargo.toml:

[dependencies]
morph3d = "0.1.1"  # Replace with the latest version

Or use

$ cargo add morph3d

Usage

use morph3d::{Loader, ModelFormat, Collection};

fn main() {
    let mut loader = Loader::new("path/to/your/model.obj", ModelFormat::OBJ);

    // Load OBJ file
    let obj_collection: Vec<Collection> = loader.load();
    // Process obj collections...
}

API

Collection

  • vertices: Vec<[f32; 3]>: List of vertices in the mesh.
  • indices: Vec<u32>: List of indices for the mesh.
  • texture_coordinates: Vec<[f32; 2]>: List of texture coordinates.
  • normals: Vec<[f32; 3]>: List of normals.
  • matrix: Matrix4<f32>: Transformation matrix applied to the mesh.

Contributing

Contributions are welcome! Please open an issue or submit a pull request if you have suggestions or improvements.

License

This crate is licensed under the MIT License OR Apache 2.0 License. Feel free to choose one of them.

Acknowledgements

  • Thanks to the Rust community and the maintainers of the dae-parser, tobj, and other libraries used in this project.

Dependencies

~9.5MB
~176K SLoC