Struct BundleLoadOptions 

pub struct BundleLoadOptions {
    pub load_assets: bool,
    pub decompress_blocks: bool,
    pub validate: bool,
    pub max_memory: Option<usize>,
    pub max_unityfs_block_cache_memory: Option<usize>,
    pub max_compressed_blocks_info_size: Option<usize>,
    pub max_blocks_info_size: Option<usize>,
    pub max_legacy_directory_compressed_size: Option<usize>,
    pub max_compressed_block_size: Option<usize>,
    pub max_blocks: usize,
    pub max_nodes: usize,
}

Bundle loading options

Fields

load_assets: bool

Whether to load all assets immediately

decompress_blocks: bool

Whether to decompress all blocks immediately

validate: bool

Whether to validate the bundle structure

max_memory: Option<usize>

Maximum memory usage for decompression (in bytes)

max_unityfs_block_cache_memory: Option<usize>

Maximum memory for caching UnityFS decompressed blocks during lazy range extraction.

This controls peak memory when AssetBundle::extract_node_data reads only a few nodes from a large UnityFS without fully decompressing the entire bundle.

If None, block cache growth is unbounded (not recommended for untrusted inputs).

max_compressed_blocks_info_size: Option<usize>

Maximum size of compressed blocks info (metadata) in bytes.

This is a cap on the compressed bytes read from the input stream before decompression.

max_blocks_info_size: Option<usize>

Maximum size of decompressed blocks info (metadata) in bytes.

max_legacy_directory_compressed_size: Option<usize>

Maximum size of the legacy (UnityWeb/UnityRaw) directory compressed section in bytes.

This is a cap on the raw bytes read from the input stream before decompression.

max_compressed_block_size: Option<usize>

Maximum size of a single UnityFS compressed data block (in bytes).

This is a cap on the raw bytes read for each block before decompression. It helps protect against malicious headers that declare multi-GB compressed blocks.

max_blocks: usize

Maximum number of compression blocks allowed in metadata.

max_nodes: usize

Maximum number of directory nodes / file entries allowed in metadata.

Implementations

impl BundleLoadOptions

pub fn lazy() -> Self

Create options for lazy loading (validate metadata, but do not preload assets or decompress blocks).

pub fn fast() -> Self

Create options for fast loading (minimal processing)

pub fn complete() -> Self

Create options for complete loading (all processing)

Trait Implementations

impl Clone for BundleLoadOptions

fn clone(&self) -> BundleLoadOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BundleLoadOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BundleLoadOptions

fn default() -> Self

Returns the “default value” for a type.