A `Context` is created with a display handle, and a `Surface` is created with a `&Context` and a window handle. Thus multiple windows can be created from the same context without duplicating anything that can be shared. This API is broadly similar to `wgpu` or `glutin`. On Wayland, the `Context` contains the `EventQueue`, which is shared between windows, and the `WlShm` global. On X11, `Context::new` checks for the availability of XShm, and contains a bool representing that as well as the `XCBConnection`. The shared context data is stored within the window in an `Arc`. On other platforms, the display isn't used and `Context` is empty. This does however test that the display handle has the right type on those platforms and fail otherwise. Previously the code didn't test that. Closes https://github.com/rust-windowing/softbuffer/issues/37.
46 lines
1.4 KiB
Rust
46 lines
1.4 KiB
Rust
use raw_window_handle::{RawDisplayHandle, RawWindowHandle};
|
|
use std::error::Error;
|
|
use thiserror::Error;
|
|
|
|
#[derive(Error, Debug)]
|
|
#[non_exhaustive]
|
|
pub enum SoftBufferError {
|
|
#[error(
|
|
"The provided display returned an unsupported platform: {human_readable_display_platform_name}."
|
|
)]
|
|
UnsupportedDisplayPlatform {
|
|
human_readable_display_platform_name: &'static str,
|
|
display_handle: RawDisplayHandle,
|
|
},
|
|
#[error(
|
|
"The provided window returned an unsupported platform: {human_readable_window_platform_name}, {human_readable_display_platform_name}."
|
|
)]
|
|
UnsupportedWindowPlatform {
|
|
human_readable_window_platform_name: &'static str,
|
|
human_readable_display_platform_name: &'static str,
|
|
window_handle: RawWindowHandle,
|
|
},
|
|
|
|
#[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)),
|
|
)),
|
|
}
|
|
}
|