BinaryAsset

Asset for loading binary files as raw bytes.

BinaryAsset loads any file as raw binary data, making it useful for:

• Custom file formats
• Binary protocols
• Compressed data
• Non-text resources

The loaded data is provided as haxe.io.Bytes, which can be processed as needed by your application.

Features:

• Hot-reload support for binary files
• Asynchronous loading
• Memory-efficient byte handling

// Load a binary file
var binaryAsset = new BinaryAsset('data');
binaryAsset.path = 'data/level.dat';
binaryAsset.onComplete(this, success -> {
    if (success) {
        // Access the raw bytes
        var bytes = binaryAsset.bytes;
        trace('Loaded ${bytes.length} bytes');
        // Process the binary data
        var input = new haxe.io.BytesInput(bytes);
        var version = input.readInt32();
        // ... read more data
    }
});
assets.addAsset(binaryAsset);
assets.load();

Instance Members #

The loaded binary data as raw bytes. Will be null until the asset is successfully loaded.

Use haxe.io APIs to read and process the binary data:

• BytesInput for reading
• BytesOutput for writing
• BytesBuffer for building

Loads the binary file from the specified path.

The loading is asynchronous and will emit a complete event when finished. On success, the bytes property will contain the loaded data.

Supports hot-reload on platforms that allow it - the file will be automatically reloaded when it changes on disk.

Destroys the binary asset and releases the loaded bytes from memory.

Private Members #

Event when bytes field changes.

Called when asset files change on disk (hot-reload support). Automatically reloads the binary file if it has been modified.

Metadata #