Enum ViewportError 

#[non_exhaustive]
pub enum ViewportError {
    EmptyMesh {
        positions: usize,
        indices: usize,
    },
    MeshLengthMismatch {
        positions: usize,
        normals: usize,
    },
    MeshIndexOutOfBounds {
        index: usize,
        count: usize,
    },
    InvalidVertexIndex {
        vertex_index: u32,
        vertex_count: usize,
    },
    VolumeDataLengthMismatch {
        actual: usize,
        expected: usize,
        dims: [u32; 3],
    },
    InvalidTextureData {
        expected: usize,
        actual: usize,
    },
    MeshSlotEmpty {
        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,
    },
}

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.

MeshIndexOutOfBounds

Mesh index is out of bounds for the mesh storage.

Fields

index: usize

The requested mesh index.

count: usize

The number of meshes currently stored.

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.

MeshSlotEmpty

Attempted to access or replace a mesh slot that is empty (previously removed).

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.

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.