Enum ChunkResidencyError 

pub enum ChunkResidencyError {
    Host(HostWorkingSetError),
    UnsupportedPayload,
    PayloadMissing,
    TrackingCapacity,
    SizeOverflow,
    EmptyChunk,
    AtomMetadataMissing {
        local_row: u32,
    },
    LocalAddressOverflow,
    TrajectoryTopologyMismatch,
    InstanceTimelineMismatch,
    AttributeTimelineMismatch,
    EndpointNotResident {
        dataset: DatasetId,
        row: LogicalRow,
    },
    ProviderBondRecord {
        local_row: u32,
    },
    Placement(ChunkPlacementError),
    Dataset(DatasetError),
    Arena(ArenaError),
    Upload(UploadBackpressure),
    Gpu(GpuError),
}

Typed failure at the host-to-GPU residency boundary.

Variants

Host(HostWorkingSetError)

Host lifecycle or identity validation failed.

UnsupportedPayload

The payload has no renderer residency implementation.

PayloadMissing

The host lifecycle claimed readiness without retaining a payload.

TrackingCapacity

Fixed tracked-chunk capacity was exhausted.

SizeOverflow

Coordinate bytes cannot be represented by the staging ring.

EmptyChunk

A provider returned an empty structure chunk.

AtomMetadataMissing

Provider atom metadata did not resolve one locally addressable row.

Fields

local_row: u32

Chunk-local row that could not be decoded.

LocalAddressOverflow

A compact GPU offset or count exceeded local u32 addressing.

TrajectoryTopologyMismatch

Two trajectory frames or their structure have different row counts.

InstanceTimelineMismatch

Paged rigid-transform frames do not match their declared occurrence.

AttributeTimelineMismatch

Paged attribute frames do not match their stable column contract.

EndpointNotResident

One global bond endpoint is outside every resident atom page.

Fields

dataset: DatasetId

Atom dataset owning the endpoint.

row: LogicalRow

Global logical atom row.

ProviderBondRecord

A provider bond row could not be projected from retained storage.

Fields

local_row: u32

Chunk-local bond row rejected by the provider.

Placement(ChunkPlacementError)

Declarative placement validation failed.

Dataset(DatasetError)

Provider logical-row metadata could not form a valid chunk span.

Arena(ArenaError)

Paged GPU allocation failed.

Upload(UploadBackpressure)

Upload staging applied explicit backpressure.

Gpu(GpuError)

Backend submission/completion failed.

Trait Implementations

impl Debug for ChunkResidencyError

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

Formats the value using the given formatter.

impl Display for ChunkResidencyError

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

Formats the value using the given formatter.

impl Error for ChunkResidencyError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ArenaError> for ChunkResidencyError

fn from(source: ArenaError) -> Self

Converts to this type from the input type.

impl From<ChunkPlacementError> for ChunkResidencyError

fn from(source: ChunkPlacementError) -> Self

Converts to this type from the input type.

impl From<ChunkResidencyError> for RenderError

fn from(source: ChunkResidencyError) -> Self

Converts to this type from the input type.

impl From<DatasetError> for ChunkResidencyError

fn from(source: DatasetError) -> Self

Converts to this type from the input type.

impl From<GpuError> for ChunkResidencyError

fn from(source: GpuError) -> Self

Converts to this type from the input type.

impl From<HostWorkingSetError> for ChunkResidencyError

fn from(source: HostWorkingSetError) -> Self

Converts to this type from the input type.

impl From<UploadBackpressure> for ChunkResidencyError

fn from(source: UploadBackpressure) -> Self

Converts to this type from the input type.