#[non_exhaustive]pub enum RawDisplayHandle {
Show 13 variants
UiKit(UiKitDisplayHandle),
AppKit(AppKitDisplayHandle),
Orbital(OrbitalDisplayHandle),
Ohos(OhosDisplayHandle),
Xlib(XlibDisplayHandle),
Xcb(XcbDisplayHandle),
Wayland(WaylandDisplayHandle),
Drm(DrmDisplayHandle),
Gbm(GbmDisplayHandle),
Windows(WindowsDisplayHandle),
Web(WebDisplayHandle),
Android(AndroidDisplayHandle),
Haiku(HaikuDisplayHandle),
}
Expand description
A display server handle for a particular windowing system.
The display usually represents a connection to some display server, but it is not necessarily tied to a particular window. Some APIs can use the display handle without ever creating a window handle (e.g. offscreen rendering, headless event handling).
Each variant contains a struct with fields specific to that windowing system
(e.g. XlibDisplayHandle
contains a Display connection to an X Server,
WaylandDisplayHandle
uses wl_display to connect to a compositor). Not all windowing
systems have a separate display handle (or they haven’t been implemented yet) and their variants
contain empty structs.
§Variant Availability
Note that all variants are present on all targets (none are disabled behind
#[cfg]
s), but see the “Availability Hints” section on each variant for
some hints on where this variant might be expected.
Note that these “Availability Hints” are not normative. That is to say, a
HasDisplayHandle
implementor is completely allowed to return something
unexpected. (For example, it’s legal for someone to return a
RawDisplayHandle::Xlib
on macOS, it would just be weird, and probably
requires something like XQuartz be used).
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
UiKit(UiKitDisplayHandle)
A raw display handle for UIKit (Apple’s non-macOS windowing library).
§Availability Hints
This variant is likely to be used on iOS, tvOS, (in theory) watchOS, and
Mac Catalyst ($arch-apple-ios-macabi
targets, which can notably use
UIKit or AppKit), as these are the targets that (currently) support
UIKit.
AppKit(AppKitDisplayHandle)
A raw display handle for AppKit.
§Availability Hints
This variant is likely to be used on macOS, although Mac Catalyst
($arch-apple-ios-macabi
targets, which can notably use UIKit or
AppKit) can also use it despite being target_os = "ios"
.
Orbital(OrbitalDisplayHandle)
A raw display handle for the Redox operating system.
§Availability Hints
This variant is used by the Orbital Windowing System in the Redox operating system.
Ohos(OhosDisplayHandle)
A raw display handle for OpenHarmony OS NDK
§Availability Hints
This variant is used on OpenHarmony OS (target_env = "ohos"
).
Xlib(XlibDisplayHandle)
A raw display handle for Xlib.
§Availability Hints
This variant is likely to show up anywhere someone manages to get X11 working that Xlib can be built for, which is to say, most (but not all) Unix systems.
Xcb(XcbDisplayHandle)
A raw display handle for Xcb.
§Availability Hints
This variant is likely to show up anywhere someone manages to get X11 working that XCB can be built for, which is to say, most (but not all) Unix systems.
Wayland(WaylandDisplayHandle)
A raw display handle for Wayland.
§Availability Hints
This variant should be expected anywhere Wayland works, which is currently some subset of unix systems.
Drm(DrmDisplayHandle)
A raw display handle for the Linux Kernel Mode Set/Direct Rendering Manager
§Availability Hints
This variant is used on Linux when neither X nor Wayland are available
Gbm(GbmDisplayHandle)
A raw display handle for the Linux Generic Buffer Manager.
§Availability Hints
This variant is present regardless of windowing backend and likely to be used with EGL_MESA_platform_gbm or EGL_KHR_platform_gbm.
Windows(WindowsDisplayHandle)
Web(WebDisplayHandle)
A raw display handle for the Web.
§Availability Hints
This variant is used on Wasm or asm.js targets when targeting the Web/HTML5.
Android(AndroidDisplayHandle)
Haiku(HaikuDisplayHandle)
Trait Implementations§
source§impl AsRef<RawDisplayHandle> for DisplayHandle<'_>
impl AsRef<RawDisplayHandle> for DisplayHandle<'_>
source§fn as_ref(&self) -> &RawDisplayHandle
fn as_ref(&self) -> &RawDisplayHandle
source§impl Borrow<RawDisplayHandle> for DisplayHandle<'_>
impl Borrow<RawDisplayHandle> for DisplayHandle<'_>
source§fn borrow(&self) -> &RawDisplayHandle
fn borrow(&self) -> &RawDisplayHandle
source§impl Clone for RawDisplayHandle
impl Clone for RawDisplayHandle
source§fn clone(&self) -> RawDisplayHandle
fn clone(&self) -> RawDisplayHandle
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for RawDisplayHandle
impl Debug for RawDisplayHandle
source§impl From<AndroidDisplayHandle> for RawDisplayHandle
impl From<AndroidDisplayHandle> for RawDisplayHandle
source§fn from(value: AndroidDisplayHandle) -> Self
fn from(value: AndroidDisplayHandle) -> Self
source§impl From<AppKitDisplayHandle> for RawDisplayHandle
impl From<AppKitDisplayHandle> for RawDisplayHandle
source§fn from(value: AppKitDisplayHandle) -> Self
fn from(value: AppKitDisplayHandle) -> Self
source§impl From<DisplayHandle<'_>> for RawDisplayHandle
impl From<DisplayHandle<'_>> for RawDisplayHandle
source§fn from(handle: DisplayHandle<'_>) -> Self
fn from(handle: DisplayHandle<'_>) -> Self
source§impl From<DrmDisplayHandle> for RawDisplayHandle
impl From<DrmDisplayHandle> for RawDisplayHandle
source§fn from(value: DrmDisplayHandle) -> Self
fn from(value: DrmDisplayHandle) -> Self
source§impl From<GbmDisplayHandle> for RawDisplayHandle
impl From<GbmDisplayHandle> for RawDisplayHandle
source§fn from(value: GbmDisplayHandle) -> Self
fn from(value: GbmDisplayHandle) -> Self
source§impl From<HaikuDisplayHandle> for RawDisplayHandle
impl From<HaikuDisplayHandle> for RawDisplayHandle
source§fn from(value: HaikuDisplayHandle) -> Self
fn from(value: HaikuDisplayHandle) -> Self
source§impl From<OhosDisplayHandle> for RawDisplayHandle
impl From<OhosDisplayHandle> for RawDisplayHandle
source§fn from(value: OhosDisplayHandle) -> Self
fn from(value: OhosDisplayHandle) -> Self
source§impl From<OrbitalDisplayHandle> for RawDisplayHandle
impl From<OrbitalDisplayHandle> for RawDisplayHandle
source§fn from(value: OrbitalDisplayHandle) -> Self
fn from(value: OrbitalDisplayHandle) -> Self
source§impl From<UiKitDisplayHandle> for RawDisplayHandle
impl From<UiKitDisplayHandle> for RawDisplayHandle
source§fn from(value: UiKitDisplayHandle) -> Self
fn from(value: UiKitDisplayHandle) -> Self
source§impl From<WaylandDisplayHandle> for RawDisplayHandle
impl From<WaylandDisplayHandle> for RawDisplayHandle
source§fn from(value: WaylandDisplayHandle) -> Self
fn from(value: WaylandDisplayHandle) -> Self
source§impl From<WebDisplayHandle> for RawDisplayHandle
impl From<WebDisplayHandle> for RawDisplayHandle
source§fn from(value: WebDisplayHandle) -> Self
fn from(value: WebDisplayHandle) -> Self
source§impl From<WindowsDisplayHandle> for RawDisplayHandle
impl From<WindowsDisplayHandle> for RawDisplayHandle
source§fn from(value: WindowsDisplayHandle) -> Self
fn from(value: WindowsDisplayHandle) -> Self
source§impl From<XcbDisplayHandle> for RawDisplayHandle
impl From<XcbDisplayHandle> for RawDisplayHandle
source§fn from(value: XcbDisplayHandle) -> Self
fn from(value: XcbDisplayHandle) -> Self
source§impl From<XlibDisplayHandle> for RawDisplayHandle
impl From<XlibDisplayHandle> for RawDisplayHandle
source§fn from(value: XlibDisplayHandle) -> Self
fn from(value: XlibDisplayHandle) -> Self
source§impl Hash for RawDisplayHandle
impl Hash for RawDisplayHandle
source§impl PartialEq for RawDisplayHandle
impl PartialEq for RawDisplayHandle
source§fn eq(&self, other: &RawDisplayHandle) -> bool
fn eq(&self, other: &RawDisplayHandle) -> bool
self
and other
values to be equal, and is used
by ==
.