Struct TopLevelFramebufferSurface 

pub struct TopLevelFramebufferSurface { /* private fields */ }

The software (framebuffer) render surface of a top-level.

The surface is shared with the thread that renders. The rule of the reference is kept: the render target is created on the UI thread only (the first show and every resize are rendered by the UI thread), and the frames of the render thread reuse it.

Trait Implementations

impl IFramebufferPlatformSurface for TopLevelFramebufferSurface

fn create_framebuffer_render_target(&self) -> Rc<dyn IFramebufferRenderTarget>

Panics

Panics when called off the UI thread or when the top-level has no native render target (it is closed): the render target is not ready.

impl IPlatformRenderSurface for TopLevelFramebufferSurface

fn is_ready(&self) -> bool

Deviation (DEVIATIONS.md, Native backend): the reference throws RenderTargetNotReadyException from CreateFramebufferRenderTarget off the UI thread and the composition target catches it; here the surface answers that it is not ready (off the UI thread, and once the top-level is disposed), which the composition target treats the same way, without a panic to catch.

fn as_framebuffer_surface(&self) -> Option<&dyn IFramebufferPlatformSurface>

The surface as a framebuffer surface, if it is one.

fn as_any(&self) -> &dyn Any

Lets the backend recover the concrete surface type.

fn try_get_surface_kind(&self, _kind: TypeId) -> Option<Rc<dyn Any>>

The surface viewed as a surface kind defined outside this crate: for TypeId::of::<dyn IFoo>() the result holds an Rc<dyn IFoo>.

fn text_rendering_parameters(&self) -> Option<PlatformTextRenderingParameters>

The text rendering settings of the platform for this surface, when the platform knows them: the render backend asks for them every frame (they follow the settings of the system and the display the surface is on). A backend asks every surface of a top-level and takes the first answer; None from all of them gives the defaults of the backend (docs/porting/text-rendering.md).