softbuffer 0.2.0

Cross-platform software buffer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

use raw_window_handle::{RawDisplayHandle, RawWindowHandle};
use std::error::Error;
use thiserror::Error;

#[derive(Error, Debug)]
#[non_exhaustive]
pub enum SoftBufferError {
    #[error(
        "The provided window returned an unsupported platform: {human_readable_window_platform_name}, {human_readable_display_platform_name}."
    )]
    UnsupportedPlatform {
        human_readable_window_platform_name: &'static str,
        human_readable_display_platform_name: &'static str,
        window_handle: RawWindowHandle,
        display_handle: RawDisplayHandle,
    },

    #[error("The provided window handle is null.")]
    IncompleteWindowHandle,

    #[error("The provided display handle is null.")]
    IncompleteDisplayHandle,

    #[error("Platform error")]
    PlatformError(Option<String>, Option<Box<dyn Error>>),
}

#[allow(unused)] // This isn't used on all platforms
pub(crate) fn unwrap<T, E: std::error::Error + 'static>(
    res: Result<T, E>,
    str: &str,
) -> Result<T, SoftBufferError> {
    match res {
        Ok(t) => Ok(t),
        Err(e) => Err(SoftBufferError::PlatformError(
            Some(str.into()),
            Some(Box::new(e)),
        )),
    }
}