Trait Connection 

pub trait Connection: Sized {
    type Adapter;
    type Device;
    type NativeWidget;

    // Required methods
    fn new() -> Result<Self, Error>;
    fn gl_api(&self) -> GLApi;
    fn create_adapter(&self) -> Result<Self::Adapter, Error>;
    fn create_hardware_adapter(&self) -> Result<Self::Adapter, Error>;
    fn create_low_power_adapter(&self) -> Result<Self::Adapter, Error>;
    fn create_software_adapter(&self) -> Result<Self::Adapter, Error>;
    fn create_device(
        &self,
        adapter: &Self::Adapter,
    ) -> Result<Self::Device, Error>;
    fn from_display_handle(handle: DisplayHandle<'_>) -> Result<Self, Error>;
    unsafe fn create_native_widget_from_ptr(
        &self,
        raw: *mut c_void,
        size: Size2D<i32>,
    ) -> Self::NativeWidget;
    fn create_native_widget_from_window_handle(
        &self,
        window: WindowHandle<'_>,
        size: Size2D<i32>,
    ) -> Result<Self::NativeWidget, Error>;
}

Methods relating to display server connections.

Required Associated Types

type Adapter

The adapter type associated with this connection.

type Device

The device type associated with this connection.

type NativeWidget

The native widget type associated with this connection.

Required Methods

fn new() -> Result<Self, Error>

Connects to the default display.

fn gl_api(&self) -> GLApi

Returns the OpenGL API flavor that this connection supports (OpenGL or OpenGL ES).

fn create_adapter(&self) -> Result<Self::Adapter, Error>

Returns the “best” adapter on this system, preferring high-performance hardware adapters.

This is an alias for Connection::create_hardware_adapter().

fn create_hardware_adapter(&self) -> Result<Self::Adapter, Error>

Returns the “best” adapter on this system, preferring high-performance hardware adapters.

fn create_low_power_adapter(&self) -> Result<Self::Adapter, Error>

Returns the “best” adapter on this system, preferring low-power hardware adapters.

fn create_software_adapter(&self) -> Result<Self::Adapter, Error>

Returns the “best” adapter on this system, preferring software adapters.

fn create_device(&self, adapter: &Self::Adapter) -> Result<Self::Device, Error>

Opens a device.

fn from_display_handle(handle: DisplayHandle<'_>) -> Result<Self, Error>

Opens the display connection corresponding to the given DisplayHandle.

unsafe fn create_native_widget_from_ptr( &self, raw: *mut c_void, size: Size2D<i32>, ) -> Self::NativeWidget

Creates a native widget from a raw pointer

fn create_native_widget_from_window_handle( &self, window: WindowHandle<'_>, size: Size2D<i32>, ) -> Result<Self::NativeWidget, Error>

Create a native widget type from the given WindowHandle.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl Connection for surfman::mesa_surfaceless::connection::Connection

type Adapter = Adapter

type Device = Device

type NativeWidget = NativeWidget

impl Connection for surfman::wayland::connection::Connection

type Adapter = Adapter

type Device = Device

type NativeWidget = NativeWidget

impl Connection for surfman::x11::connection::Connection

type Adapter = Adapter

type Device = Device

type NativeWidget = NativeWidget

impl<Def, Alt> Connection for surfman::multi::connection::Connection<Def, Alt>

where Def: DeviceInterface, Alt: DeviceInterface, Def::Connection: ConnectionInterface<Device = Def>, Alt::Connection: ConnectionInterface<Device = Alt>,

type Adapter = Adapter<Def, Alt>

type Device = Device<Def, Alt>

type NativeWidget = NativeWidget<Def, Alt>