Enum SurfaceTarget

#[non_exhaustive]
pub enum SurfaceTarget<'window> {
    Window(Box<dyn WindowHandle + 'window>),
}

The window/canvas/surface/swap-chain/etc. a surface is attached to, for use with safe 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 SurfaceTargetUnsafe for unsafe 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.

Window(Box<dyn WindowHandle + 'window>)

Window handle producer.

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.

Errors

• On WebGL2: surface creation returns an error if the browser does not support WebGL2, or declines to provide GPU access (such as due to a resource shortage).

Panics

• On macOS/Metal: will panic if not called on the main thread.
• On web: will panic if the raw_window_handle does not properly refer to a canvas element.

Trait Implementations

impl<'a, T> From<T> for SurfaceTarget<'a>

where T: WindowHandle + 'a,

fn from(window: T) -> Self

Converts to this type from the input type.