Organizing Projects

The B3d Pipeline docs refer to "project roots" and "data trees" - these concepts are best defined with an example.

Example project structure :

• The project root: C:\projects\myGame\
• The project exe: C:\projects\myGame\myGame.exe
• Relative data paths: data\entities\units\hero.b3d
• The root of the data tree: \data\

To format relative data paths, B3d Pipeline searches the absolute data path for the root of a data tree.

This root folder is defined in B3dExp.ini  Default: DataRoot="\data\"

So: C:\projects\myGame\data\entities\objects\castle.b3d

Becomes: data\entities\objects\castle.b3d

To display this project relative data correctly, the B3d Viewer needs to know the project root.

The B3d Viewer uses this directory to construct absolute paths to data. (see B3d Viewer Settings )

This project structure can also encourage texture sharing.

Example: B3d files in both the "objects" and "units" folders can reference textures in the "shared" folder by using the relative path: "..\shared\"

See "Relative Paths" in the B3d Export Dialog .