ds3

Pure-Rust parser for Autodesk 3D Studio binary (.3ds) files.

No dependencies on graphics engines — output is plain f32 arrays that you feed into Mesh::insert_attribute (Bevy), glBufferData (OpenGL), or whatever renderer you use.

The crate is published as ds3 (a Rust identifier can't start with a digit); the repository is 3ds-rs. It is no_std + alloc compatible (disable the default std feature) with a minimum supported Rust version of 1.70.

Installation

cargo add ds3

[dependencies]
ds3 = "0.1"
# no_std: ds3 = { version = "0.1", default-features = false }
# serde:  ds3 = { version = "0.1", features = ["serde"] }

Quick start

use ds3::parse;

let scene = parse(&std::fs::read("model.3ds")?)?;
for mesh in &scene.meshes {
    println!("{}: {} verts, {} faces", mesh.name, mesh.vertices.len(), mesh.faces.len());

    // Flat-shaded (one vertex per face corner)
    let (pos, nrm, uv, idx) = mesh.to_flat_buffers();

    // Smooth-shaded (vertices shared across smooth groups)
    let (pos, nrm, uv, idx) = mesh.to_smooth_buffers();
}

Features

Coordinate system

3DS stores vertices in right-handed Y-up. No axis permutation is required. The Mesh3ds::transform matrix is also Y-up.

Some exporters write Z-up regardless of the spec; swap Y/Z after parse if you know your source is Z-up.

Supported chunks

All other chunks are silently skipped.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT license (LICENSE-MIT)

at your option.