Struct gbm::Device

pub struct Device<T: AsRawFd + 'static> { /* private fields */ }

An open GBM device

Implementations

impl Device<FdWrapper>

pub unsafe fn new_from_fd(fd: RawFd) -> IoResult<Device<FdWrapper>>

Open a GBM device from a given unix file descriptor.

The file descriptor passed in is used by the backend to communicate with platform for allocating the memory. For allocations using DRI this would be the file descriptor returned when opening a device such as /dev/dri/card0.

Unsafety

The lifetime of the resulting device depends on the ownership of the file descriptor. Closing the file descriptor before dropping the Device will lead to undefined behavior.

impl<T: AsRawFd + 'static> Device<T>

pub fn new(fd: T) -> IoResult<Device<T>>

Open a GBM device from a given open DRM device.

The underlying file descriptor passed in is used by the backend to communicate with platform for allocating the memory. For allocations using DRI this would be the file descriptor returned when opening a device such as /dev/dri/card0.

pub fn backend_name(&self) -> &str

Get the backend name

pub fn is_format_supported(
    &self,
    format: Format,
    usage: BufferObjectFlags
) -> bool

Test if a format is supported for a given set of usage flags

pub fn create_surface<U: 'static>(
    &self,
    width: u32,
    height: u32,
    format: Format,
    usage: BufferObjectFlags
) -> IoResult<Surface<U>>

Allocate a new surface object

pub fn create_buffer_object<U: 'static>(
    &self,
    width: u32,
    height: u32,
    format: Format,
    usage: BufferObjectFlags
) -> IoResult<BufferObject<U>>

Allocate a buffer object for the given dimensions

pub fn import_buffer_object_from_wayland<U: 'static>(
    &self,
    buffer: &WlBuffer,
    usage: BufferObjectFlags
) -> IoResult<BufferObject<U>>

Create a gbm buffer object from a wayland buffer

This function imports a foreign WlBuffer object and creates a new gbm buffer object for it. This enabled using the foreign object with a display API such as KMS.

The gbm bo shares the underlying pixels but its life-time is independent of the foreign object.

pub unsafe fn import_buffer_object_from_egl<U: 'static>(
    &self,
    buffer: EGLImage,
    usage: BufferObjectFlags
) -> IoResult<BufferObject<U>>

Create a gbm buffer object from an egl buffer

This function imports a foreign EGLImage object and creates a new gbm buffer object for it. This enabled using the foreign object with a display API such as KMS.

The gbm bo shares the underlying pixels but its life-time is independent of the foreign object.

Unsafety

The given EGLImage is a raw pointer. Passing null or an invalid EGLImage will cause undefined behavior.

pub fn import_buffer_object_from_dma_buf<U: 'static>(
    &self,
    buffer: RawFd,
    width: u32,
    height: u32,
    stride: u32,
    format: Format,
    usage: BufferObjectFlags
) -> IoResult<BufferObject<U>>

Create a gbm buffer object from an dma buffer

This function imports a foreign dma buffer from an open file descriptor and creates a new gbm buffer object for it. This enabled using the foreign object with a display API such as KMS.

The gbm bo shares the underlying pixels but its life-time is independent of the foreign object.

Trait Implementations

impl<T: AsRawFd + 'static> AsRaw<gbm_device> for Device<T>

fn as_raw(&self) -> *const gbm_device

Receive a raw pointer representing this type.

impl<T: AsRawFd + 'static> AsRawFd for Device<T>

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl<T: AsRawFd + 'static> Deref for Device<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: AsRawFd + 'static> DerefMut for Device<T>

fn deref_mut(&mut self) -> &mut T

Mutably dereferences the value.

impl<T: DrmDevice + AsRawFd + 'static> Device for Device<T>

fn get_auth_token(&self) -> Result<AuthToken, Error>

Generates and returns a magic token unique to the current process.

fn set_client_cap(&self, cap: ClientCapability, set: bool) -> Result<(), Error>

Tells the DRM device whether we understand or do not understand a particular capability.

fn set_master(&self) -> Result<(), Error>

Attempts to acquire the DRM Master lock.

fn drop_master(&self) -> Result<(), Error>

Attempts to release the DRM Master lock.

impl<T: DrmControlDevice + AsRawFd + 'static> Device for Device<T>

fn resource_handles(&self) -> Result<ResourceHandles, Error>

See ResourceHandles::load_from_device

fn plane_handles(&self) -> Result<PlaneResourceHandles, Error>

See PlaneResourceHandles::load_from_device

fn resource_info<T>(
    &self,
    handle: <T as ResourceInfo>::Handle
) -> Result<T, Error>where
    T: ResourceInfo,

See ResourceInfo::load_from_device

fn set_crtc(
    &self,
    crtc: Handle,
    fb: Handle,
    cons: &[Handle],
    position: (u32, u32),
    mode: Option<Mode>
) -> Result<(), Error>

Attaches a framebuffer to a CRTC’s built-in plane, attaches the CRTC to a connector, and sets the CRTC’s mode to output the pixel data.

fn create_framebuffer<U>(&self, buffer: &U) -> Result<Info, Error>where
    U: Buffer + ?Sized,

Creates a framebuffer from a Buffer, returning framebuffer::Info.

impl<T: AsRawFd + 'static> Drop for Device<T>

fn drop(&mut self)

Executes the destructor for this type.