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.

Tuple Fields of PlatformError

0: String

FailedToLoadAsset

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

Fields of FailedToLoadAsset

reason: Error

The underlying reason for the error.

path: PathBuf

The path to the asset that failed to load.

InvalidColor

Returned when a color is invalid.

InvalidTexture(ImageError)

Returned when a texture’s data is invalid.

Tuple Fields of InvalidTexture

0: ImageError

InvalidShader(String)

Returned when a shader fails to compile.

Tuple Fields of InvalidShader

0: String

InvalidFont

Returned when a font could not be read.

InvalidSound(DecoderError)

Returned when a sound cannot be decoded.

Tuple Fields of InvalidSound

0: DecoderError

NotEnoughData

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.

Fields of NotEnoughData

expected: usize

The number of bytes that were expected.

actual: usize

The number of bytes that were provided.

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.

Tuple Fields of FailedToChangeDisplayMode

0: String

TessellationError(TessellationError)

Returned when a shape cannot be tessellated.

Tuple Fields of TessellationError

0: TessellationError

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