summaryrefslogtreecommitdiffstats
path: root/graphics/src/window
diff options
context:
space:
mode:
Diffstat (limited to 'graphics/src/window')
-rw-r--r--graphics/src/window/compositor.rs88
-rw-r--r--graphics/src/window/gl_compositor.rs71
2 files changed, 0 insertions, 159 deletions
diff --git a/graphics/src/window/compositor.rs b/graphics/src/window/compositor.rs
deleted file mode 100644
index db4ba45d..00000000
--- a/graphics/src/window/compositor.rs
+++ /dev/null
@@ -1,88 +0,0 @@
-//! A compositor is responsible for initializing a renderer and managing window
-//! surfaces.
-use crate::{Color, Error, Viewport};
-
-use raw_window_handle::{HasRawDisplayHandle, HasRawWindowHandle};
-use thiserror::Error;
-
-/// A graphics compositor that can draw to windows.
-pub trait Compositor: Sized {
- /// The settings of the backend.
- type Settings: Default;
-
- /// The iced renderer of the backend.
- type Renderer: iced_native::Renderer;
-
- /// The surface of the backend.
- type Surface;
-
- /// Creates a new [`Compositor`].
- fn new<W: HasRawWindowHandle + HasRawDisplayHandle>(
- settings: Self::Settings,
- compatible_window: Option<&W>,
- ) -> Result<(Self, Self::Renderer), Error>;
-
- /// Crates a new [`Surface`] for the given window.
- ///
- /// [`Surface`]: Self::Surface
- fn create_surface<W: HasRawWindowHandle + HasRawDisplayHandle>(
- &mut self,
- window: &W,
- ) -> Self::Surface;
-
- /// Configures a new [`Surface`] with the given dimensions.
- ///
- /// [`Surface`]: Self::Surface
- fn configure_surface(
- &mut self,
- surface: &mut Self::Surface,
- width: u32,
- height: u32,
- );
-
- /// Returns [`Information`] used by this [`Compositor`].
- fn fetch_information(&self) -> Information;
-
- /// Presents the [`Renderer`] primitives to the next frame of the given [`Surface`].
- ///
- /// [`Renderer`]: Self::Renderer
- /// [`Surface`]: Self::Surface
- fn present<T: AsRef<str>>(
- &mut self,
- renderer: &mut Self::Renderer,
- surface: &mut Self::Surface,
- viewport: &Viewport,
- background_color: Color,
- overlay: &[T],
- ) -> Result<(), SurfaceError>;
-}
-
-/// Result of an unsuccessful call to [`Compositor::present`].
-#[derive(Clone, PartialEq, Eq, Debug, Error)]
-pub enum SurfaceError {
- /// A timeout was encountered while trying to acquire the next frame.
- #[error(
- "A timeout was encountered while trying to acquire the next frame"
- )]
- Timeout,
- /// The underlying surface has changed, and therefore the surface must be updated.
- #[error(
- "The underlying surface has changed, and therefore the surface must be updated."
- )]
- Outdated,
- /// The swap chain has been lost and needs to be recreated.
- #[error("The surface has been lost and needs to be recreated")]
- Lost,
- /// There is no more memory left to allocate a new frame.
- #[error("There is no more memory left to allocate a new frame")]
- OutOfMemory,
-}
-
-/// Contains informations about the graphics (e.g. graphics adapter, graphics backend).
-#[derive(Debug)]
-pub struct Information {
- /// Contains the graphics adapter.
- pub adapter: String,
- /// Contains the graphics backend.
- pub backend: String,
-}
diff --git a/graphics/src/window/gl_compositor.rs b/graphics/src/window/gl_compositor.rs
deleted file mode 100644
index a45a7ca1..00000000
--- a/graphics/src/window/gl_compositor.rs
+++ /dev/null
@@ -1,71 +0,0 @@
-//! A compositor is responsible for initializing a renderer and managing window
-//! surfaces.
-use crate::compositor::Information;
-use crate::{Color, Error, Size, Viewport};
-
-use core::ffi::c_void;
-
-/// A basic OpenGL compositor.
-///
-/// A compositor is responsible for initializing a renderer and managing window
-/// surfaces.
-///
-/// For now, this compositor only deals with a single global surface
-/// for drawing. However, the trait will most likely change in the near future
-/// to handle multiple surfaces at once.
-///
-/// If you implement an OpenGL renderer, you can implement this trait to ease
-/// integration with existing windowing shells, like `iced_glutin`.
-pub trait GLCompositor: Sized {
- /// The renderer of the [`GLCompositor`].
- ///
- /// This should point to your renderer type, which could be a type alias
- /// of the [`Renderer`] provided in this crate with with a specific
- /// [`Backend`].
- ///
- /// [`Renderer`]: crate::Renderer
- /// [`Backend`]: crate::Backend
- type Renderer: iced_native::Renderer;
-
- /// The settings of the [`GLCompositor`].
- ///
- /// It's up to you to decide the configuration supported by your renderer!
- type Settings: Default;
-
- /// Creates a new [`GLCompositor`] and [`Renderer`] with the given
- /// [`Settings`] and an OpenGL address loader function.
- ///
- /// # Safety
- /// The `loader_function` should resolve to valid OpenGL bindings.
- ///
- /// [`Renderer`]: crate::Renderer
- /// [`Backend`]: crate::Backend
- /// [`Settings`]: Self::Settings
- #[allow(unsafe_code)]
- unsafe fn new(
- settings: Self::Settings,
- loader_function: impl FnMut(&str) -> *const c_void,
- ) -> Result<(Self, Self::Renderer), Error>;
-
- /// Returns the amount of samples that should be used when configuring
- /// an OpenGL context for this [`GLCompositor`].
- fn sample_count(settings: &Self::Settings) -> u32;
-
- /// Resizes the viewport of the [`GLCompositor`].
- fn resize_viewport(&mut self, physical_size: Size<u32>);
-
- /// Returns [`Information`] used by this [`GLCompositor`].
- fn fetch_information(&self) -> Information;
-
- /// Presents the primitives of the [`Renderer`] to the next frame of the
- /// [`GLCompositor`].
- ///
- /// [`Renderer`]: crate::Renderer
- fn present<T: AsRef<str>>(
- &mut self,
- renderer: &mut Self::Renderer,
- viewport: &Viewport,
- background_color: Color,
- overlay: &[T],
- );
-}