Trait Compositor 

pub trait Compositor: Sized {
    type Renderer;
    type Surface;

    // Required methods
    fn new(
        settings: Settings,
        display: impl Display + Clone,
        compatible_window: impl Window + Clone,
        shell: Shell,
    ) -> impl Future<Output = Result<Self, Error>>;
    fn create_renderer(&self, settings: Settings) -> Self::Renderer;
    fn create_surface(
        &mut self,
        window: impl Window + Clone,
        width: u32,
        height: u32,
    ) -> Self::Surface;
    fn configure_surface(
        &mut self,
        surface: &mut Self::Surface,
        width: u32,
        height: u32,
    );
    fn information(&self) -> Information;
    fn present(
        &mut self,
        renderer: &mut Self::Renderer,
        surface: &mut Self::Surface,
        viewport: &Viewport,
        background_color: Color,
        on_pre_present: impl FnOnce(),
    ) -> Result<(), SurfaceError>;
    fn screenshot(
        &mut self,
        renderer: &mut Self::Renderer,
        viewport: &Viewport,
        background_color: Color,
    ) -> Vec<u8> ;

    // Provided methods
    fn load_font(&mut self, font: Cow<'static, [u8]>) -> Result<(), Error> { ... }
    fn list_fonts(&mut self) -> Result<Vec<Family>, Error> { ... }
}

A graphics compositor that can draw to windows.

Required Associated Types

type Renderer

The iced renderer of the backend.

type Surface

The surface of the backend.

Required Methods

fn new( settings: Settings, display: impl Display + Clone, compatible_window: impl Window + Clone, shell: Shell, ) -> impl Future<Output = Result<Self, Error>>

Creates a new Compositor with the given [backend::Settings].

fn create_renderer(&self, settings: Settings) -> Self::Renderer

Creates a Self::Renderer for the Compositor.

fn create_surface( &mut self, window: impl Window + Clone, width: u32, height: u32, ) -> Self::Surface

Crates a new Surface for the given window.

fn configure_surface( &mut self, surface: &mut Self::Surface, width: u32, height: u32, )

Configures a new Surface with the given dimensions.

fn information(&self) -> Information

Returns Information used by this Compositor.

fn present( &mut self, renderer: &mut Self::Renderer, surface: &mut Self::Surface, viewport: &Viewport, background_color: Color, on_pre_present: impl FnOnce(), ) -> Result<(), SurfaceError>

Presents the Renderer primitives to the next frame of the given Surface.

fn screenshot( &mut self, renderer: &mut Self::Renderer, viewport: &Viewport, background_color: Color, ) -> Vec<u8>

Screenshots the current Renderer primitives to an offscreen texture, and returns the bytes of the texture ordered as RGBA in the sRGB color space.

Provided Methods

fn load_font(&mut self, font: Cow<'static, [u8]>) -> Result<(), Error>

Loads a font from its bytes.

fn list_fonts(&mut self) -> Result<Vec<Family>, Error>

Lists all the available font families.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl Compositor for ()

Available on debug-assertions enabled only.

type Renderer = ()

type Surface = ()

async fn new( _settings: Settings, _display: impl Display, _compatible_window: impl Window + Clone, _shell: Shell, ) -> Result<Self, Error>

fn create_renderer(&self, _settings: Settings) -> Self::Renderer

fn create_surface( &mut self, _window: impl Window + Clone, _width: u32, _height: u32, ) -> Self::Surface

fn configure_surface( &mut self, _surface: &mut Self::Surface, _width: u32, _height: u32, )

fn load_font(&mut self, _font: Cow<'static, [u8]>) -> Result<(), Error>

fn list_fonts(&mut self) -> Result<Vec<Family>, Error>

fn information(&self) -> Information

fn present( &mut self, _renderer: &mut Self::Renderer, _surface: &mut Self::Surface, _viewport: &Viewport, _background_color: Color, _on_pre_present: impl FnOnce(), ) -> Result<(), SurfaceError>

fn screenshot( &mut self, _renderer: &mut Self::Renderer, _viewport: &Viewport, _background_color: Color, ) -> Vec<u8>

Implementors