fbx-dom 0.1.0

Document Model for Reading in FBX
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

# FBX-DOM

A Document Model for Reading in FBX.

Supports 7300 ASCII

## Binary ingress spike (`fbxcel-loader-spike`)

Primary binary ingress is `fbxcel` **tree API** (`tree::any::AnyTree`) for now.

- We parse binary bytes into an `AnyTree`.
- We adapt tree nodes into existing `Document` fields (header, definitions, globals, objects, connections).
- The `AnyTree` is treated as an **ephemeral adapter input** and is dropped after
  `Document` materialization, so we avoid keeping both a long-lived `fbxcel` tree
  and a second binary DOM copy in memory.

Pull-parser remains useful as an internal building block (and can be revisited for
streaming hot paths), but the canonical ingress in `fbx-dom` is tree-first while
the shape of `Document` is stabilized.

## Test assets (`assets/`)

| File | Source |
|------|--------|
| [`assets/duck.fbx`](assets/duck.fbx) | Assimp test model. The file’s embedded `DocumentUrl` / texture paths reference the Assimp tree (`…/test/models/Collada/duck.fbx`). Upstream collection: [assimp/test/models](https://github.com/assimp/assimp/tree/master/test/models). |
| [`assets/collision-track-straight.fbx`](assets/collision-track-straight.fbx) | [Kenney — Starter Kit Racing](https://github.com/KenneyNL/Starter-Kit-Racing), [`models/collision-track-straight.fbx`](https://github.com/KenneyNL/Starter-Kit-Racing/blob/main/models/collision-track-straight.fbx). |

How to Write:

FBX Element ->

u64 id,
usize ref Document
usize Element Index