notes-folders.txt 2022-12-03

All assets are stored in the apps 'usr' folder. This includes 'global'
assets shared across datasets and media (3D models, texture maps, etc.).


--- Global Assets ---

'usr/global/' folder holds shared assets (loaded during app startup).

'usr/global/images/' stores texture maps. (previously 'usr/images/').

'usr/global/models/' stores 3D models (with their texture maps too).


'usr/global/csv/antzglobals.csv' loads globals environment variables.
    (eg. fullscreen mode, fileviz URL, OSC ports...)

Other global forders are for future use ('av', 'json', 'plugins'...)


--- Datasets ---

Each dataset has a root folder that is named for that dataset. This
includes default datasets (eg. 'usr/preset-1/', 'usr/preset-2/'...),
and user defined datasets (eg. 'usr/mydataset/'.)

Each dataset has its own set of sub-folders (eg. csv, images...) that
contain its (non global) assets.

*Future feature, embedding dataset folders. If you place a dataset
folder into another datasets sub-directories, then it would load with
the dataset, while using localized resources to that dataset.
