Enum ViewportError 

#[non_exhaustive]
pub enum ViewportError {
    EmptyMesh {
        positions: usize,
        indices: usize,
    },
    MeshLengthMismatch {
        positions: usize,
        normals: usize,
    },
    OverrideBufferVertexCountMismatch {
        mesh_id: usize,
        mesh_vertices: usize,
        override_vertices: usize,
    },
    StaleHandle {
        index: usize,
        count: usize,
    },
    InvalidVertexIndex {
        vertex_index: u32,
        vertex_count: usize,
    },
    VolumeDataLengthMismatch {
        actual: usize,
        expected: usize,
        dims: [u32; 3],
    },
    InvalidTextureData {
        expected: usize,
        actual: usize,
    },
    UnsupportedTextureFormat {
        format: TextureFormat,
    },
    CompressedTextureNotBlockAligned {
        width: u32,
        height: u32,
        block_width: u32,
        block_height: u32,
    },
    InvalidCompressedTextureData {
        level: u32,
        expected: usize,
        actual: usize,
    },
    SlotEmpty {
        index: usize,
    },
    AttributeNotFound {
        mesh_id: usize,
        name: String,
    },
    AttributeLengthMismatch {
        expected: usize,
        got: usize,
    },
    McBufferTooLarge {
        buffer: &'static str,
        needed: u64,
        limit: u64,
    },
    InvalidGaussianSplatData {
        reason: &'static str,
    },
    JobWorkerLost {
        reason: &'static str,
    },
    JobNotReady,
    JobResultMissing {
        reason: &'static str,
    },
    DeformSlotsExhausted {
        max: usize,
    },
    DeformNameTaken {
        name: String,
    },
    DeformShaderInvalid {
        reason: String,
    },
    LodGroupEmpty,
    LodLevelCountMismatch {
        meshes: usize,
        thresholds: usize,
    },
    LodThresholdsNotDescending {
        level: usize,
    },
    LodLevelIncompatible {
        level: usize,
        reason: String,
    },
    LodGroupNotFound {
        index: usize,
    },
}

Errors that can occur during mesh upload and manipulation.

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.

EmptyMesh

Mesh data has empty positions or indices.

Fields

positions: usize

Number of positions provided.

indices: usize

Number of indices provided.

MeshLengthMismatch

Positions and normals arrays have different lengths.

Fields

positions: usize

Number of positions provided.

normals: usize

Number of normals provided.

OverrideBufferVertexCountMismatch

A position/normal override buffer was bound to a mesh whose vertex count differs from the buffer’s. The shader indexes the override per mesh vertex, so a smaller buffer reads out of bounds and a different count silently scrambles the geometry.

Fields

mesh_id: usize

Index of the mesh the override was bound to.

mesh_vertices: usize

Vertex count of the mesh.

override_vertices: usize

Vertex count the override buffer holds.

StaleHandle

A handle does not resolve to a live resource: its slot was freed, reused at a newer generation, or its index is out of range for the store.

Fields

index: usize

The slot index the handle points at.

count: usize

The number of live entries currently in the store.

InvalidVertexIndex

An index buffer entry references a vertex that does not exist.

Fields

vertex_index: u32

The offending index value.

vertex_count: usize

Total number of vertices.

VolumeDataLengthMismatch

Volume scalar data length does not match the declared grid dimensions.

Fields

actual: usize

Number of scalar values provided.

expected: usize

Expected length, equal to dims[0] * dims[1] * dims[2].

dims: [u32; 3]

Grid dimensions [nx, ny, nz].

InvalidTextureData

Texture RGBA data has an unexpected size.

Fields

expected: usize

Expected byte count (width * height * 4).

actual: usize

Actual byte count provided.

UnsupportedTextureFormat

A compressed-texture upload requested a format the device cannot sample, or a format that is not block-compressed.

The device check reads the format’s required wgpu feature (for example TEXTURE_COMPRESSION_BC, _ASTC, or _ETC2). When this is returned for a hardware reason, the caller should fall back to upload_texture / upload_normal_map or ship a variant the device supports.

Fields

format: TextureFormat

The format that was rejected.

CompressedTextureNotBlockAligned

A compressed-texture upload had base dimensions that are not a multiple of the format’s block size. Block-compressed textures must be created with block-aligned dimensions; pad the image (and adjust UVs) or upload it uncompressed.

Fields

width: u32

Base (mip 0) width in texels.

height: u32

Base (mip 0) height in texels.

block_width: u32

Format block width.

block_height: u32

Format block height.

InvalidCompressedTextureData

A mip level of a compressed-texture upload had the wrong byte length for its block-packed dimensions.

Fields

level: u32

The mip level whose data was the wrong size (0 is the base level).

expected: usize

Expected block-packed byte count for this level.

actual: usize

Actual byte count provided for this level.

SlotEmpty

Attempted to access or replace a slot that is empty (its resource was previously freed).

Fields

index: usize

The slot index that was accessed.

AttributeNotFound

Named scalar attribute not found on the given mesh.

Fields

mesh_id: usize

The mesh index that was accessed.

name: String

The attribute name that was requested.

AttributeLengthMismatch

Attribute data length does not match the existing buffer.

replace_attribute requires the same vertex count as the original upload.

Fields

expected: usize

Expected number of f32 elements (original attribute length).

got: usize

Actual number of f32 elements provided.

McBufferTooLarge

A buffer required for GPU marching cubes upload exceeds the device’s max_buffer_size limit. The caller should fall back to CPU marching cubes.

Fields

buffer: &'static str

Short name identifying which buffer exceeded the limit (e.g. "vertex_buf").

needed: u64

Bytes required for the allocation.

limit: u64

The device’s max_buffer_size limit.

InvalidGaussianSplatData

Gaussian splat data is malformed or empty.

Fields

reason: &'static str

Short description of what is wrong.

JobWorkerLost

A background upload worker panicked or dropped its channel before sending a result.

Fields

reason: &'static str

Short description of how the worker was lost.

JobNotReady

upload_result_* was called before the corresponding job reached the Ready state. Poll upload_status and retry on the next frame.

JobResultMissing

upload_result_* was called with a JobId that does not belong to the matching upload type, has already been taken, or was never issued.

Fields

reason: &'static str

Short description of why the result is unavailable.

DeformSlotsExhausted

No deformer slots remain. The registry has a fixed budget set by the vertex-stage storage-buffer limit; once all slots are taken, callers must release one with unregister_deformer (when implemented) before registering another.

Fields

max: usize

Total number of slots the registry exposes.

DeformNameTaken

A deformer with this name is already registered.

Fields

name: String

The duplicate name that was rejected.

DeformShaderInvalid

The composed mesh-family shader failed validation, either because the supplied wgsl_body is malformed or because composition produced an invalid module. The reason carries the underlying validator message and identifies which shader failed.

Fields

reason: String

Validator message prefixed by the shader name that failed.

LodGroupEmpty

A LOD group was registered with no levels.

LodLevelCountMismatch

The mesh list and threshold list passed to register_lod_group differ in length. Each level needs exactly one threshold.

Fields

meshes: usize

Number of meshes provided.

thresholds: usize

Number of thresholds provided.

LodThresholdsNotDescending

LOD thresholds must strictly decrease from the full level to the crudest, since each level applies to a smaller on-screen size than the one before.

Fields

level: usize

The level whose threshold is not smaller than its predecessor’s.

LodLevelIncompatible

A level’s mesh is not compatible with the other levels in the group: a switch to it would change rendering. Today this means its named attribute set or its deformer attachment differs from level 0.

Fields

level: usize

The level that does not match level 0.

reason: String

What differs (a missing attribute name, or a deform mismatch).

LodGroupNotFound

A LOD group id does not refer to a registered group.

Fields

index: usize

The group index that was looked up.

Trait Implementations

impl Clone for ViewportError

fn clone(&self) -> ViewportError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ViewportError

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

Formats the value using the given formatter.

impl Display for ViewportError

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

Formats the value using the given formatter.

impl Error for ViewportError

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.