Enum RendererError 

#[non_exhaustive]
pub enum RendererError {
    Generic(String),
    BadTexture(String),
    InvalidRenderState(String),
    FrameNotPrepared,
    FrameEpochOutOfOrder {
        active: u64,
        received: u64,
    },
    ContextNotBound,
    ContextDropped,
    ContextMismatch,
    ContextAlreadyHasRenderer,
    RendererStateDrift {
        field: &'static str,
    },
    DrawBufferTooLarge {
        buffer: &'static str,
    },
    DrawBufferOffsetOverflow {
        buffer: &'static str,
    },
    DrawCommandIndexRangeOutOfBounds {
        start: usize,
        end: usize,
        len: usize,
    },
    DrawCommandVertexOutOfBounds {
        index: usize,
        len: usize,
    },
    RawDrawCallbackUnsupported,
    BufferCreationFailed(String),
    TextureCreationFailed(String),
    PipelineCreationFailed(String),
    ShaderCompilationFailed(String),
    Wgpu(Error),
    InvalidTextureId(TextureId),
    TextureIdExhausted,
    ExternalTextureNotFound(TextureId),
    ManagedTextureMissing(SnapshotTextureId),
    ManagedTextureLayoutMismatch {
        texture: SnapshotTextureId,
        expected: [u32; 2],
        actual: [u32; 2],
    },
    RendererConsumer(RendererConsumerError),
    FrameCapture(SnapshotError),
    ContextAttachment(ContextAttachmentError),
    TextureFeedback(TextureFeedbackError),
}

Errors that can occur during rendering operations

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.

Generic(String)

Generic error with message

BadTexture(String)

Bad texture error

InvalidRenderState(String)

Invalid render state

FrameNotPrepared

Secondary viewport rendering began before the Context frame was reconciled.

FrameEpochOutOfOrder

A frame older than the renderer’s active resource epoch was supplied.

Fields

active: u64

received: u64

ContextNotBound

The renderer has not been attached to a Dear ImGui context.

ContextDropped

The Dear ImGui context used to initialize the renderer has been dropped.

ContextMismatch

A context-taking operation received a context other than the renderer owner.

ContextAlreadyHasRenderer

The context already has renderer-owned state that this renderer cannot claim safely.

RendererStateDrift

Renderer-owned Dear ImGui state changed while this renderer remained attached.

Fields

field: &'static str

DrawBufferTooLarge

Draw buffer length exceeds renderer index ranges.

Fields

buffer: &'static str

DrawBufferOffsetOverflow

Draw buffer offset overflowed while accumulating draw lists.

Fields

buffer: &'static str

DrawCommandIndexRangeOutOfBounds

A draw command addresses indices outside its parent draw list.

Fields

start: usize

end: usize

len: usize

DrawCommandVertexOutOfBounds

A draw command references a vertex outside its parent draw list.

Fields

index: usize

len: usize

RawDrawCallbackUnsupported

Native raw draw callbacks cannot be invoked by this target.

BufferCreationFailed(String)

Buffer creation failed

TextureCreationFailed(String)

Texture creation failed

PipelineCreationFailed(String)

Pipeline creation failed

ShaderCompilationFailed(String)

Shader compilation failed

Wgpu(Error)

WGPU error

InvalidTextureId(TextureId)

Invalid texture ID

TextureIdExhausted

The process-wide renderer texture identifier space is exhausted.

ExternalTextureNotFound(TextureId)

An external texture handle does not belong to this renderer or was already removed.

ManagedTextureMissing(SnapshotTextureId)

A managed update arrived after the renderer lost its matching GPU resource.

ManagedTextureLayoutMismatch

A managed identity was reused with incompatible dimensions.

Fields

texture: SnapshotTextureId

expected: [u32; 2]

actual: [u32; 2]

RendererConsumer(RendererConsumerError)

Context-owned renderer consumer state rejected the operation.

FrameCapture(SnapshotError)

Managed frame finalization or texture-request capture failed.

ContextAttachment(ContextAttachmentError)

Context attachment registration rejected the renderer’s deferred-drop cleanup hook.

TextureFeedback(TextureFeedbackError)

A request was completed with the wrong feedback kind.

Trait Implementations

impl Debug for RendererError

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

Formats the value using the given formatter.

impl Display for RendererError

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

Formats the value using the given formatter.

impl Error for RendererError

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<ContextAttachmentError> for RendererError

fn from(source: ContextAttachmentError) -> Self

Converts to this type from the input type.

impl From<Error> for RendererError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<RendererConsumerError> for RendererError

fn from(source: RendererConsumerError) -> Self

Converts to this type from the input type.

impl From<SnapshotError> for RendererError

fn from(source: SnapshotError) -> Self

Converts to this type from the input type.

impl From<TextureFeedbackError> for RendererError

fn from(source: TextureFeedbackError) -> Self

Converts to this type from the input type.