4 releases
new 0.2.0 | Jan 24, 2025 |
---|---|
0.1.2 | Jul 22, 2024 |
0.1.1 | Mar 29, 2024 |
0.1.0 | Mar 13, 2024 |
#31 in Data formats
102 downloads per month
25KB
780 lines
Roblox Mesh Parser
Mesh Example
Print the mesh vertices for any mesh version / vertex size
use rbx_mesh::{read_versioned,mesh::{VersionedMesh,SizeOfVertex2}};
let file=std::fs::File::open("torso.mesh")?;
let input=std::io::BufReader::new(file);
let versioned_mesh=read_versioned(input)?;
match versioned_mesh{
VersionedMesh::Version1(mesh)=>println!("{:?}",mesh.vertices),
VersionedMesh::Version2(mesh)=>{
match mesh.header.sizeof_vertex{
SizeOfVertex2::Full=>println!("{:?}",mesh.vertices),
SizeOfVertex2::Truncated=>println!("{:?}",mesh.vertices_truncated),
}
},
VersionedMesh::Version3(mesh)=>{
match mesh.header.sizeof_vertex{
SizeOfVertex2::Full=>println!("{:?}",mesh.vertices),
SizeOfVertex2::Truncated=>println!("{:?}",mesh.vertices_truncated),
}
},
VersionedMesh::Version4(mesh)=>println!("{:?}",mesh.vertices),
VersionedMesh::Version5(mesh)=>println!("{:?}",mesh.vertices),
}
Union Example
use rbx_mesh::{read_physics_data,PhysicsData,CSGPHS};
// this data is extracted from the "PhysicsData" property of UnionOperation
let file=std::fs::File::open("CSGPHS_3.data")?;
let input=std::io::BufReader::new(file);
let physics_data=read_physics_data(input)?;
match physics_data{
// the most common format (99% of the 100000 unions in my testing)
PhysicsData::CSGPHS(CSGPHS::Meshes3(meshes))
// this format is identical but has a different magic number.
|PhysicsData::CSGPHS(CSGPHS::Meshes5(meshes))=>println!("CSGPHS::Meshes"),
// Only one occurence in my data set.
// Who writes a uuid as ascii hex in a binary format!?
PhysicsData::CSGK(csgk)=>println!("CSGK"),
// These formats have zero occurences in my dataset
// But they are documented at
// https://devforum.roblox.com/t/some-info-on-sharedstrings-for-custom-collision-data-meshparts-unions-etc/294588
PhysicsData::CSGPHS(CSGPHS::Block)=>println!("CSGPHS::Block"),
PhysicsData::CSGPHS(CSGPHS::PhysicsInfoMesh(physics_info_mesh))=>println!("CSGPHS::PhysicsInfoMesh"),
}
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~4–5MB
~100K SLoC