landon 0.10.2

A collection of tools, data structures and methods for exporting Blender data (such as meshes and armatures) and preparing it for your rendering pipeline.
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

# Custom Properties

`landon` exports all [custom properties][custom-properties-blender] found on a mesh.

These can be useful when your application code wants to treat certain meshes differently based on certain
properties that you label the mesh with in Blender.

For example - you might have a linter that ensures that none of your meshes go above 200 vertices in order
to preserve your low poly art style.

There might be some exceptions to this rule - so your code might check for the `override_max_vertex_count`
custom property to enforce a different limit in special cases.

In Blender custom properties these can be added in the Object section of the Context panel.

![Custom mesh properties](./custom-properties.png)

Int, Float, String and Vector custom properties are exported. Type information can be found next to every value
since the Rust API uses this to generate a type safe data structure.

Dictionaries are not currently supported - but feel free to open an issue if you need this.

### Rust API

[BlenderMesh.custom_properties Rust API][custom-properties-rust-api]

### Example JSON Representation

_Accurate as of May 31, 2020_

```
"custom_properties": {
    "example_float": {
        "Float": 20.0
    },
    "example_int": {
        "Int": 30
    },
    "example_string": {
        "String": "Hello"
    },
    "example_vec": {
        "Vec": [
            {"Float": 1.0},
            {"Int": 2},
            {"String": "World"}
        ]
    }
}
```

[custom-properties-blender]: https://docs.blender.org/manual/en/2.79/data_system/custom_properties.html
[custom-properties-rust-api]: https://docs.rs/blender-mesh/latest/blender_mesh/struct.BlenderMesh.html#method.custom_properties