Enum SurfaceTargetUnsafe

#[non_exhaustive]
pub enum SurfaceTargetUnsafe {
    RawHandle {
        raw_display_handle: RawDisplayHandle,
        raw_window_handle: RawWindowHandle,
    },
}

The window/canvas/surface/swap-chain/etc. a surface is attached to, for use with unsafe surface creation.

This is either a window or an actual web canvas depending on the platform and enabled features. Refer to the individual variants for more information.

See also SurfaceTarget for safe variants.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

RawHandle

Raw window & display handle.

If the specified display and window handle are not supported by any of the backends, then the surface will not be supported by any adapters.

Safety

• raw_window_handle & raw_display_handle must be valid objects to create a surface upon.
• raw_window_handle & raw_display_handle must remain valid until after the returned Surface is dropped.

Fields

raw_display_handle: RawDisplayHandle

Raw display handle, underlying display must outlive the surface created from this.

raw_window_handle: RawWindowHandle

Raw display handle, underlying window must outlive the surface created from this.

Implementations

impl SurfaceTargetUnsafe

pub unsafe fn from_window<T>(window: &T) -> Result<Self, HandleError>

where T: HasDisplayHandle + HasWindowHandle,

Creates a SurfaceTargetUnsafe::RawHandle from a window.

Safety

• window must outlive the resulting surface target (and subsequently the surface created for this target).