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

//! # picocadrs
//!
//! This is a crate for working with [picoCAD](https://johanpeitz.itch.io/picocad) project files.
//! It supports de-/serialization of picoCAD projects and some other helpful methods and function.
//!
//! <br/>
//!
//! If you are interested in how a picoCAD file is structured start from [here](assets::model) and
//! work your way down.
//!
//! # Example
//!
//! ```no_run
//! use std::ffi::OsString;
//! use picocadrs::assets::{Color, Model, Point3D}; // Point3D required for point macro
//! use picocadrs::point;
//!
//! // Loads the file "test.txt" located in the picoCAD project folder as a model.
//! // This model now can access any part of that project.
//! // For this example test.txt is a new picoCAD project that has a single plane added without
//! // modifying it saved under the name "test".
//! let model = Model::load(OsString::from("test")).unwrap();
//!
//! println!("Model name: {}", model.header.name);          // "Model name: test"
//! println!("Amount of meshes: {}", model.meshes.len());   // "Amount of meshes: 1"
//!
//! let mesh = model.meshes.get(0).unwrap();
//! println!("Mesh name: {}", mesh.name);           // "Mesh name: plane"
//! println!("Mesh position: {}", mesh.position);   // "Mesh position: 0,0,0"
//!
//! let face = mesh.faces.get(0).unwrap();
//! println!("Face color: {}", face.color.as_i32()); // "Face color: 6"
//! println!("Double sided: {}", face.double_sided); // "Double sided: true"
//! println!("No texture: {}", face.no_texture);     // "No texture: false"
//!
//! print!("\n");
//!
//! // Of course, you can change these values too.
//! let mut model = Model::load(OsString::from("test")).unwrap();
//!
//! model.header.name = "model_name".to_string();
//! println!("Model name: {}", model.header.name);          // "Model name: model_name"
//! println!("Amount of meshes: {}", model.meshes.len());   // "Amount of meshes: 1"
//!
//! let mesh = model.meshes.get_mut(0).unwrap();
//! mesh.name = "some_plane".to_string();
//! mesh.position = point!(1.5, -1.0, 2.0);
//! println!("Mesh name: {}", mesh.name);           // "Mesh name: some_plane"
//! println!("Mesh position: {}", mesh.position);   // "Mesh position: 1.5,-1,2"
//!
//! let face = mesh.faces.get_mut(0).unwrap();
//! face.color = Color::Lavender;
//! face.double_sided = false;
//! face.no_texture = true;
//! println!("Face color: {}", face.color.as_i32()); // "Face color: 13"
//! println!("Double sided: {}", face.double_sided); // "Double sided: false"
//! println!("No texture: {}", face.no_texture);     // "No texture: true"
//! ```

pub mod assets;
pub mod error;
pub mod paths;