Enum SwapBuffersError

pub enum SwapBuffersError {
    AlreadySwapped,
    ContextLost(Box<dyn Error>),
    TemporaryFailure(Box<dyn Error>),
}

Error that can happen when swapping buffers.

Variants

AlreadySwapped

The buffers have already been swapped.

This error can be returned when swap_buffers has been called multiple times without any modification in between.

ContextLost(Box<dyn Error>)

The corresponding context has been lost and needs to be recreated.

All the objects associated to it (textures, buffers, programs, etc.) need to be recreated from scratch. Underlying resources like native surfaces might also need to be recreated.

Operations will have no effect. Functions that read textures, buffers, etc. will return uninitialized data instead.

TemporaryFailure(Box<dyn Error>)

A temporary condition caused to rendering to fail.

Depending on the underlying error this might require fixing internal state of the rendering backend, but failures mapped to TemporaryFailure are always recoverable without re-creating the entire stack, as is represented by ContextLost.

Proceed after investigating the source to reschedule another full rendering step or just this page_flip at a later time. If the root cause cannot be discovered and subsequent renderings also fail, it is advised to fallback to recreation.

Trait Implementations

impl Debug for SwapBuffersError

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

Formats the value using the given formatter.

impl Display for SwapBuffersError

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

Formats the value using the given formatter.

impl Error for SwapBuffersError

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<Error> for SwapBuffersError

fn from(err: Error) -> SwapBuffersError

Converts to this type from the input type.

impl From<Error> for SwapBuffersError

fn from(err: Error) -> SwapBuffersError

Converts to this type from the input type.

impl From<Gles2Error> for SwapBuffersError

fn from(err: Gles2Error) -> SwapBuffersError

Converts to this type from the input type.

impl From<MakeCurrentError> for SwapBuffersError

fn from(err: MakeCurrentError) -> GraphicsSwapBuffersError

Converts to this type from the input type.

impl From<SwapBuffersError> for SwapBuffersError

fn from(value: SwapBuffersError) -> Self

Converts to this type from the input type.