Trait GlDisplay

Help

pub trait GlDisplay: Sealed {
    type WindowSurface: GlSurface<WindowSurface>;
    type PixmapSurface: GlSurface<PixmapSurface>;
    type PbufferSurface: GlSurface<PbufferSurface>;
    type Config: GlConfig;
    type NotCurrentContext: NotCurrentGlContext;

    // Required methods
    unsafe fn find_configs(
        &self,
        template: ConfigTemplate,
    ) -> Result<Box<dyn Iterator<Item = Self::Config> + '_>>;
    unsafe fn create_context(
        &self,
        config: &Self::Config,
        context_attributes: &ContextAttributes,
    ) -> Result<Self::NotCurrentContext>;
    unsafe fn create_window_surface(
        &self,
        config: &Self::Config,
        surface_attributes: &SurfaceAttributes<WindowSurface>,
    ) -> Result<Self::WindowSurface>;
    unsafe fn create_pbuffer_surface(
        &self,
        config: &Self::Config,
        surface_attributes: &SurfaceAttributes<PbufferSurface>,
    ) -> Result<Self::PbufferSurface>;
    unsafe fn create_pixmap_surface(
        &self,
        config: &Self::Config,
        surface_attributes: &SurfaceAttributes<PixmapSurface>,
    ) -> Result<Self::PixmapSurface>;
    fn get_proc_address(&self, addr: &CStr) -> *const c_void;
    fn version_string(&self) -> String;
    fn supported_features(&self) -> DisplayFeatures;
}

Expand description

A trait to group common display operations.

Required Associated Types§

Source

type WindowSurface: GlSurface<WindowSurface>

A window surface created by the display.

Source

type PixmapSurface: GlSurface<PixmapSurface>

A pixmap surface created by the display.

Source

type PbufferSurface: GlSurface<PbufferSurface>

A pbuffer surface created by the display.

Source

type Config: GlConfig

A config that is used by the display.

Source

type NotCurrentContext: NotCurrentGlContext

A context that is being used by the display.

Required Methods§

Source

unsafe fn find_configs( &self, template: ConfigTemplate, ) -> Result<Box<dyn Iterator<Item = Self::Config> + '_>>

Find configurations matching the given template.

§Safety

Some platforms use RawWindowHandle to pick configs, so it must point to a valid object if it was passed on crate::config::ConfigTemplate.

Source

unsafe fn create_context( &self, config: &Self::Config, context_attributes: &ContextAttributes, ) -> Result<Self::NotCurrentContext>

Create the graphics platform context.

§Safety

Some platforms use RawWindowHandle for context creation, so it must point to a valid object.

§Platform-specific

Wayland: this call may latch the underlying back buffer of the currently active context (will do with mesa drivers), meaning that all resize operations will apply to it after the next GlSurface::swap_buffers. To workaround this behavior the current context should be made not current.

Source