Expand description
Control and use of display devices (e.g. monitors).
A Display
represents a display device, which is usually a monitor but can also be something
else that can display graphical content. You do not create Display
objects yourself, but
you get them from the physical device instead. To get a list of all available displays on the
system, you can call PhysicalDevice::display_properties
.
A display plane is a single layer within a display device or graphics stack that a surface can be created from. Depending on the setup used by the system, there may be one fixed display plane for each display, multiple display planes for each display, or even a pool of display planes that multiple displays can make use of.
Creating surfaces that render directly to a display
- Choose the
Display
that you want to render to. - Get display plane properties with
PhysicalDevice::display_plane_properties
, and choose a display plane index that is supported with the chosen display. - Choose a
DisplayMode
, which is the combination of a display, a resolution and a refresh rate. You can enumerate the modes available on a display withDisplay::display_mode_properties
, or create your own mode. A display can show multiple planes in a stacking fashion. - Create a
Surface
object withSurface::from_display_plane
, and pass the chosenDisplayMode
and display plane index.
Structs
- A display device connected to a physical device.
- Represents a mode on a specific display.
- Parameters to create a new
DisplayMode
. - A set of
DisplayPlaneAlpha
values. - The capabilities of a display plane.
- The properties of a display plane.
- The properties of a display.
Enums
- The alpha blending mode to use for a display mode.