Struct MetalPlatformSurface 

pub struct MetalPlatformSurface { /* private fields */ }

The Metal render surface of a top-level.

The surface is shared with the thread that renders (IPlatformRenderSurface: Send + Sync). What it holds of the native side is the native top-level, which only the UI thread may use (see SurfaceTopLevel): the render target is created on the UI thread, as in the reference, and the native side refuses anything else (TopLevelImpl::CreateMetalRenderTarget in native/FerroUI.Native/src/OSX/TopLevelImpl.mm returns COR_E_INVALIDOPERATION off the main thread).

Trait Implementations

impl IMetalPlatformSurface for MetalPlatformSurface

fn create_metal_render_target( &self, device: Rc<dyn IMetalDevice>, ) -> Rc<dyn IMetalPlatformSurfaceRenderTarget>

Panics

Panics when called off the UI thread or when the top-level is disposed (the render target is not ready) and when device is not a device of this backend.

impl IPlatformRenderSurface for MetalPlatformSurface

fn is_ready(&self) -> bool

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

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 as_any(&self) -> &dyn Any

Lets the backend recover the concrete surface type.

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

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

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).