Enum CpuAccess 

pub enum CpuAccess {
    None,
    Read,
    Write,
    ReadWrite,
}

Declared CPU involvement for an image tensor, chosen at allocation.

The HAL assumes buffers are produced and consumed by hardware (ISP, codec, GPU, NPU) — hardware access needs no declaration. CPU access is the opt-in: it selects the CPU usage/mapping mode at allocation (write-combined for Write, cached for Read) and, on Android, pins the layout linear (vendor tile compression requires None).

Mapping beyond the declared access is best-effort, never silent: it may be refused (Error::NotSupported) or take a slow path, and it always increments unplanned_cpu_access_count with a once-per-buffer warning.

Variants

None

Hardware-only buffer (the default): no CPU mapping declared. Compression-eligible on platforms with vendor tile layouts.

Read

CPU reads (verification, CPU consumers) — cached mapping.

Write

CPU writes (decode targets) — write-combined mapping where the platform supports it; reading through a Write map is undeclared.

ReadWrite

CPU reads and writes — the pre-CpuAccess implicit behavior.

Implementations

impl CpuAccess

pub fn reads(self) -> bool

Whether this declaration includes CPU reads.

pub fn writes(self) -> bool

Whether this declaration includes CPU writes.

pub fn covers(self, requested: CpuAccess) -> bool

Whether this declaration covers requested (every direction the request needs is declared).

Trait Implementations

impl Clone for CpuAccess

fn clone(&self) -> CpuAccess

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CpuAccess

impl Debug for CpuAccess

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

Formats the value using the given formatter.

impl Default for CpuAccess

fn default() -> CpuAccess

Returns the “default value” for a type.

impl Eq for CpuAccess

impl PartialEq for CpuAccess

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CpuAccess