Enum Compression 

#[non_exhaustive]
pub enum Compression {
    Any,
    Scheme(CompressionScheme),
}

Requested tile-compression behavior for an image allocation (set via ImageDesc::with_compression).

Vendor GPUs store textures in proprietary compressed tile layouts (UBWC, AFBC, PVRIC, DCC) that cut memory bandwidth; eligibility requires a hardware-only buffer (CpuAccess::None) because CPU mapping pins the layout linear. The request records best knowledge on the tensor (Tensor::compression); it never changes what bytes a consumer sees through the GPU/NPU.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Any

Let the platform use its native scheme when the format is eligible; otherwise allocate linear and count the fallback (compression_fallback_count). The right default for pipelines that want the bandwidth win without portability failures.

Scheme(CompressionScheme)

Require one specific scheme: allocation fails with Error::InvalidArgument when the device’s scheme differs and [Error::NotSupported] on platforms without vendor tile compression. For consumers whose ABI names a layout (e.g. a QNN context binary declaring UBWC inputs).

Trait Implementations

impl Clone for Compression

fn clone(&self) -> Compression

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Compression

impl Debug for Compression

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

Formats the value using the given formatter.

impl Eq for Compression

impl PartialEq for Compression

fn eq(&self, other: &Compression) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Compression