Struct WindowRenderingContext

pub struct WindowRenderingContext {
    size: Cell<PhysicalSize<u32>>,
    surfman_context: SurfmanRenderingContext,
}

A RenderingContext that uses the surfman library to render to a raw-window-handle identified window. surfman will attempt to create an OpenGL context and surface for this window. This is a simple implementation of the RenderingContext crate, but by default it paints to the entire window surface.

If you would like to paint to only a portion of the window, consider using OffscreenRenderingContext by calling WindowRenderingContext::offscreen_context.

Fields

size: Cell<PhysicalSize<u32>>

surfman_context: SurfmanRenderingContext

Implementations

impl WindowRenderingContext

pub fn new( display_handle: DisplayHandle<'_>, window_handle: WindowHandle<'_>, size: PhysicalSize<u32>, ) -> Result<WindowRenderingContext, Error>

pub fn offscreen_context( self: &Rc<WindowRenderingContext>, size: PhysicalSize<u32>, ) -> OffscreenRenderingContext

pub fn take_window(&self) -> Result<(), Error>

Stop rendering to the window that was used to create this WindowRenderingContext or last set with Self::set_window.

TODO: This should be removed once WebViews can replace their RenderingContexts.

pub fn set_window( &self, window_handle: WindowHandle<'_>, size: PhysicalSize<u32>, ) -> Result<(), Error>

Replace the window that this WindowRenderingContext renders to and give it a new size.

TODO: This should be removed once WebViews can replace their RenderingContexts.

pub fn surfman_details( &self, ) -> (RefMut<'_, Device<Device<Device, Device>, Device>>, RefMut<'_, Context<Device<Device, Device>, Device>>)

Trait Implementations

impl RenderingContext for WindowRenderingContext

fn prepare_for_rendering(&self)

Prepare this RenderingContext to be rendered upon by Servo. For instance, by binding a framebuffer to the current OpenGL context.

fn read_to_image( &self, source_rectangle: Box2D<i32, DevicePixel>, ) -> Option<ImageBuffer<Rgba<u8>, Vec<u8>>>

Read the contents of this [Renderingcontext] into an in-memory image. If the image cannot be read (for instance, if no rendering has taken place yet), then None is returned.

fn size(&self) -> PhysicalSize<u32>

Get the current size of this RenderingContext.

fn resize(&self, size: PhysicalSize<u32>)

Resizes the rendering surface to the given size.

fn present(&self)

Presents the rendered frame to the screen. In a double-buffered context, this would swap buffers.

fn make_current(&self) -> Result<(), Error>

Makes the context the current OpenGL context for this thread. After calling this function, it is valid to use OpenGL rendering commands.

fn gleam_gl_api(&self) -> Rc<dyn Gl>

Returns the gleam version of the OpenGL or GLES API.

fn glow_gl_api(&self) -> Arc<Context>

Returns the OpenGL or GLES API.

fn create_texture( &self, surface: Surface<Device<Device, Device>, Device>, ) -> Option<(SurfaceTexture<Device<Device, Device>, Device>, u32, Size2D<i32, UnknownUnit>)>

Creates a texture from a given surface and returns the surface texture, the OpenGL texture object, and the size of the surface. Default to None.

fn destroy_texture( &self, surface_texture: SurfaceTexture<Device<Device, Device>, Device>, ) -> Option<Surface<Device<Device, Device>, Device>>

Destroys the texture and returns the surface. Default to None.

fn connection(&self) -> Option<Connection<Device<Device, Device>, Device>>

The connection to the display server for WebGL. Default to None.

fn size2d(&self) -> Size2D<u32, DevicePixel>

Get the current size of this RenderingContext as Size2D.