Enum tetra::error::TetraError

#[non_exhaustive]
pub enum TetraError {
    PlatformError(String),
    FailedToLoadAsset {
        reason: Error,
        path: PathBuf,
    },
    InvalidColor,
    InvalidTexture(ImageError),
    InvalidShader(String),
    InvalidFont,
    InvalidSound(DecoderError),
    NotEnoughData {
        expected: usize,
        actual: usize,
    },
    NoAudioDevice,
    FailedToChangeDisplayMode(String),
    TessellationError(TessellationError),
}

The types of error that can occur in a Tetra game.

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.

PlatformError(String)

Returned when the underlying platform returns an unexpected error. This usually isn’t something your game can reasonably be expected to recover from.

FailedToLoadAsset

Fields

reason: Error

The underlying reason for the error.

path: PathBuf

The path to the asset that failed to load.

Returned when your game fails to load an asset. This is usually caused by an incorrect file path, or some form of permission issues.

InvalidColor

Returned when a color is invalid.

InvalidTexture(ImageError)

Returned when a texture’s data is invalid.

InvalidShader(String)

Returned when a shader fails to compile.

InvalidFont

Returned when a font could not be read.

InvalidSound(DecoderError)

Returned when a sound cannot be decoded.

NotEnoughData

Fields

expected: usize

The number of bytes that were expected.

actual: usize

The number of bytes that were provided.

Returned when not enough data is provided to fill a buffer. This may happen if you’re creating a texture from raw data and you don’t provide enough data.

NoAudioDevice

Returned when trying to play back audio without an available device.

FailedToChangeDisplayMode(String)

Returned when your game tried to change the display settings (e.g. fullscreen, vsync) but was unable to do so.

TessellationError(TessellationError)

Returned when a shape cannot be tessellated.

Trait Implementations

impl Debug for TetraError

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

Formats the value using the given formatter.

impl Display for TetraError

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

Formats the value using the given formatter.

impl Error for TetraError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

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