1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
// surfman/surfman/src/connection.rs
//
//! The abstract interface that all connections conform to.
use crate::Error;
use crate::GLApi;
use euclid::default::Size2D;
use std::os::raw::c_void;
/// Methods relating to display server connections.
pub trait Connection: Sized {
/// The adapter type associated with this connection.
type Adapter;
/// The device type associated with this connection.
type Device;
/// The native type associated with this connection.
type NativeConnection;
/// The native device type associated with this connection.
type NativeDevice;
/// The native widget type associated with this connection.
type NativeWidget;
/// Connects to the default display.
fn new() -> Result<Self, Error>;
/// Returns the native connection corresponding to this connection.
fn native_connection(&self) -> Self::NativeConnection;
/// Returns the OpenGL API flavor that this connection supports (OpenGL or OpenGL ES).
fn gl_api(&self) -> GLApi;
/// Returns the "best" adapter on this system, preferring high-performance hardware adapters.
///
/// This is an alias for `Connection::create_hardware_adapter()`.
fn create_adapter(&self) -> Result<Self::Adapter, Error>;
/// Returns the "best" adapter on this system, preferring high-performance hardware adapters.
fn create_hardware_adapter(&self) -> Result<Self::Adapter, Error>;
/// Returns the "best" adapter on this system, preferring low-power hardware adapters.
fn create_low_power_adapter(&self) -> Result<Self::Adapter, Error>;
/// Returns the "best" adapter on this system, preferring software adapters.
fn create_software_adapter(&self) -> Result<Self::Adapter, Error>;
/// Opens a device.
fn create_device(&self, adapter: &Self::Adapter) -> Result<Self::Device, Error>;
/// Wraps an existing native device type in a device.
unsafe fn create_device_from_native_device(
&self,
native_device: Self::NativeDevice,
) -> Result<Self::Device, Error>;
/// Opens the display connection corresponding to the given raw display handle.
#[cfg(feature = "sm-raw-window-handle")]
fn from_raw_display_handle(
raw_handle: raw_window_handle::RawDisplayHandle,
) -> Result<Self, Error>;
/// Creates a native widget from a raw pointer
unsafe fn create_native_widget_from_ptr(
&self,
raw: *mut c_void,
size: Size2D<i32>,
) -> Self::NativeWidget;
/// Create a native widget type from the given `raw_window_handle::RawWindowHandle`.
#[cfg(feature = "sm-raw-window-handle")]
fn create_native_widget_from_raw_window_handle(
&self,
window: raw_window_handle::RawWindowHandle,
size: Size2D<i32>,
) -> Result<Self::NativeWidget, Error>;
}