rbx_mesh 0.8.0

Rust parser for Roblox mesh files.
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

// v1 based on https://github.com/MaximumADHD/Rbx2Source/blob/main/Geometry/Mesh.cs LoadGeometry_Ascii function
#[cfg(feature = "mesh-v1")]
mod v1;
#[cfg(feature = "mesh-v1")]
pub use v1::*;
// the rest are based on https://devforum.roblox.com/t/roblox-mesh-format/326114
mod v2;
pub use v2::*;
mod v3;
pub use v3::*;
mod v4;
pub use v4::*;
mod v5;
pub use v5::*;

use binrw::BinReaderExt;

pub type Error = binrw::Error;

#[cfg(feature = "mesh-v1")]
#[expect(clippy::large_enum_variant)]
#[binrw::binread]
#[br(little)]
#[derive(Debug, Clone)]
pub enum Mesh {
	// TODO: use feature-gated enum variant when this issue is fixed
	// https://github.com/jam1garner/binrw/issues/360
	// #[cfg(feature = "mesh-v1")]
	V1(Mesh1),
	V2(Mesh2),
	V3(Mesh3),
	V4(Mesh4),
	V5(Mesh5),
	//Version6(Mesh6),
	//Version7(Mesh7),
}

#[cfg(not(feature = "mesh-v1"))]
#[expect(clippy::large_enum_variant)]
#[binrw::binread]
#[br(little)]
#[derive(Debug, Clone)]
pub enum Mesh {
	V2(Mesh2),
	V3(Mesh3),
	V4(Mesh4),
	V5(Mesh5),
	//Version6(Mesh6),
	//Version7(Mesh7),
}

pub fn read_versioned<R: BinReaderExt>(mut read: R) -> Result<Mesh, Error> {
	read.read_le()
}