Overview#

The omni.assets.plugins extension provides essential asset loading and data source capabilities by bundling several core Carbonite plugins. It includes the primary assets management system through carb.assets, file system data source support via carb.datasource-file, and imaging functionality for asset processing.

Core Components#

The extension centers around two main plugins that work together to provide comprehensive asset handling. The carb.assets plugin manages asset loading with features like pooled asset management, asynchronous loading with task integration, snapshot-based access for thread safety, and automatic change detection with reload capabilities. The carb.datasource-file plugin handles file system operations including local file and directory access, asynchronous file reading with task suspension, file system change monitoring, and basic file operations like create, read, write, and delete.

The asset system uses a pool-based architecture where assets can be organized into separate pools for efficient memory management. Assets are loaded asynchronously and can be accessed through snapshots that provide thread-safe access to the loaded data. Change events allow applications to respond when assets are modified on disk, enabling automatic reload functionality for live editing workflows.