Enum WinitPlatformError 

#[non_exhaustive]
pub enum WinitPlatformError {
    Attachment(ContextAttachmentError),
    PlatformAttachmentRelease(ContextPlatformAttachmentReleaseError),
    Context(ContextBindingError),
    PlatformWindowTeardown(ContextPlatformWindowTeardownError),
    ContextMismatch,
    PlatformStateOccupied {
        field: &'static str,
    },
    PlatformStateReplaced {
        field: &'static str,
    },
    WindowNotAttached,
    WindowMismatch,
    RuntimeAlreadyAttached,
    RuntimeConfigurationLocked,
    AggregateCallbackHooksUnavailable,
    PlatformCallbackOccupied {
        callback: &'static str,
    },
    PlatformCapabilityOccupied {
        flag: &'static str,
    },
    PlatformCallbackReplaced {
        callback: &'static str,
    },
    RendererShutdownRequired {
        field: &'static str,
    },
    ForeignPlatformUserData,
    ViewportOwnershipLost {
        viewport_id: u32,
        field: &'static str,
    },
    NoMonitors,
    InvalidMonitorGeometry {
        monitor: usize,
        reason: &'static str,
    },
    InvalidViewportGeometry {
        operation: &'static str,
        reason: &'static str,
    },
    CustomHiDpiModeUnsupported,
    WaylandUnsupported,
    UnsupportedWindowSystem {
        target: &'static str,
    },
    UnsupportedViewportFlag {
        flag: &'static str,
        operation: &'static str,
    },
    MonitorCountOverflow,
    MonitorStorageAllocationFailed,
    EventLoopUnavailable,
    WindowCreation {
        message: String,
    },
    WindowOperation {
        operation: &'static str,
        message: String,
    },
    CallbackPanicked {
        callback: &'static str,
    },
    RuntimeDetached,
}

Failure to attach or operate the Winit platform backend.

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.

Attachment(ContextAttachmentError)

The Dear ImGui Context rejected the platform attachment.

PlatformAttachmentRelease(ContextPlatformAttachmentReleaseError)

The Context rejected release of the active platform attachment generation.

Context(ContextBindingError)

The originating Dear ImGui Context can no longer be entered normally.

PlatformWindowTeardown(ContextPlatformWindowTeardownError)

Dear ImGui rejected an explicit platform-window teardown transaction.

ContextMismatch

The supplied Context is not the Context owned by this platform backend.

PlatformStateOccupied

Another platform backend already owns a required global field.

Fields

field: &'static str

PlatformStateReplaced

A field claimed by this platform backend changed while it remained attached.

Fields

field: &'static str

WindowNotAttached

No main window has been attached to the platform backend.

WindowMismatch

The supplied window is not the platform backend’s attached main window.

RuntimeAlreadyAttached

Multi-viewport support is already attached to this platform owner.

RuntimeConfigurationLocked

A configuration mutation would invalidate the active multi-viewport coordinate contract.

AggregateCallbackHooksUnavailable

The build artifact lacks the aggregate callback bridge required by this backend.

PlatformCallbackOccupied

Another platform backend already owns one of the required callback slots.

Fields

callback: &'static str

PlatformCapabilityOccupied

Another platform backend already advertises a capability owned by this runtime.

Fields

flag: &'static str

PlatformCallbackReplaced

A slot in the captured platform callback table changed while the runtime remained attached.

Fields

callback: &'static str

RendererShutdownRequired

Platform teardown was requested before the renderer released its viewport callback.

Fields

field: &'static str

ForeignPlatformUserData

A viewport already has platform data owned by another backend.

ViewportOwnershipLost

A live viewport stopped matching the Winit platform data registered for it.

Fields

viewport_id: u32

Dear ImGui viewport identifier whose native platform state drifted.

field: &'static str

Native platform field whose value no longer matches Winit’s registration.

NoMonitors

Winit did not expose any monitor geometry that can back Dear ImGui viewports.

InvalidMonitorGeometry

Winit exposed monitor geometry that violates Dear ImGui’s platform contract.

Fields

monitor: usize

reason: &'static str

InvalidViewportGeometry

Dear ImGui supplied viewport geometry that cannot be represented by Winit.

Fields

operation: &'static str

reason: &'static str

CustomHiDpiModeUnsupported

Custom single-window coordinate scaling is not implemented for platform viewports.

WaylandUnsupported

Wayland cannot provide the desktop-space positioning required by Dear ImGui viewports.

UnsupportedWindowSystem

The target has no supported native desktop window-system contract.

Fields

target: &'static str

UnsupportedViewportFlag

A requested viewport flag cannot be implemented faithfully for this operation.

Fields

flag: &'static str

operation: &'static str

MonitorCountOverflow

The monitor count cannot be represented by Dear ImGui’s native vector.

MonitorStorageAllocationFailed

Dear ImGui’s allocator could not reserve monitor storage.

EventLoopUnavailable

Dear ImGui requested a new viewport outside a scoped Winit event-loop entry.

WindowCreation

Winit failed to create a secondary viewport window.

Fields

message: String

WindowOperation

A fallible operation on a secondary Winit window failed.

Fields

operation: &'static str

message: String

CallbackPanicked

A Rust platform callback panicked; the panic was contained at the C ABI boundary.

Fields

callback: &'static str

RuntimeDetached

The owning runtime has already shut down or entered a terminal fault.

Trait Implementations

impl Clone for WinitPlatformError

fn clone(&self) -> WinitPlatformError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WinitPlatformError

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

Formats the value using the given formatter.

impl Display for WinitPlatformError

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

Formats the value using the given formatter.

impl Eq for WinitPlatformError

impl Error for WinitPlatformError

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 WinitPlatformError

fn from(source: ContextAttachmentError) -> Self

Converts to this type from the input type.

impl From<ContextBindingError> for WinitPlatformError

fn from(source: ContextBindingError) -> Self

Converts to this type from the input type.

impl From<ContextPlatformAttachmentReleaseError> for WinitPlatformError

fn from(source: ContextPlatformAttachmentReleaseError) -> Self

Converts to this type from the input type.

impl From<ContextPlatformWindowTeardownError> for WinitPlatformError

fn from(source: ContextPlatformWindowTeardownError) -> Self

Converts to this type from the input type.

impl PartialEq for WinitPlatformError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WinitPlatformError