Expand description
Surface presentation configuration: present modes, alpha compositing, and color-space types (HDR and wide-gamut output).
This module is re-exported flatly from wgpu-types; the user-facing color
space and HDR primer lives in the wgpu crate’s top-level docs.
Structs§
- Display
Chromaticity - CIE 1931 xy chromaticity of a display’s primaries and white point. Each
coordinate is
[x, y]; a coordinate the platform omits isNone. - Display
Coarse Range - Coarse, boolean dynamic-range and gamut signal.
- Display
HdrInfo - HDR and luminance characteristics of the display backing a
Surface, as reported by the platform at query time. - Display
Headroom - Relative EDR headroom (Apple): unitless multipliers over current SDR white,
where
1.0means no headroom. Moves with brightness, ambient light, battery, and which display the window is on. Apple exposes no absolute-nit equivalent, so this is separate fromDisplayLuminanceand can’t be converted to nits. - Display
Luminance - Absolute luminance levels in nits (cd/m²). Populated only on Windows (via
DXGI);
Noneon every other platform. - Presentation
Timestamp - Nanosecond timestamp used by the presentation engine.
- Surface
Capabilities - Defines the capabilities of a given surface and adapter.
- Surface
Color Spaces - A set of
SurfaceColorSpaces supported by a surface for a particular texture format. - Surface
Configuration - Configures a
Surfacefor presentation. - Surface
Format Capabilities - A texture format supported by a surface, together with the color spaces in which the surface can present it.
Enums§
- Composite
Alpha Mode - Specifies how the alpha channel of the textures should be handled during compositing.
- Display
Gamut - Coarse gamut classification, mirroring CSS
color-gamut. - Present
Mode - Timing and queueing with which frames are actually displayed to the user.
- Surface
Color Space - The color space in which the presentation engine interprets the values written to a surface texture.
- Surface
Status - Status of the received surface image.