Struct gbm::Device

impl<T: AsFd> 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>

Allocate a new surface object

pub fn create_surface_with_modifiers<U: 'static>(
 &self,
 width: u32,
 height: u32,
 format: Format,
 modifiers: impl Iterator<Item = Modifier>
) -> IoResult<Surface>

Allocate a new surface object with explicit modifiers

pub fn create_surface_with_modifiers2<U: 'static>(
 &self,
 width: u32,
 height: u32,
 format: Format,
 modifiers: impl Iterator<Item = Modifier>,
 usage: BufferObjectFlags
) -> IoResult<Surface>

Allocate a new surface object with explicit modifiers and flags

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

Allocate a buffer object for the given dimensions

pub fn create_buffer_object_with_modifiers<U: 'static>(
 &self,
 width: u32,
 height: u32,
 format: Format,
 modifiers: impl Iterator<Item = Modifier>
) -> IoResult<BufferObject>

Allocate a buffer object for the given dimensions with explicit modifiers

pub fn create_buffer_object_with_modifiers2<U: 'static>(
 &self,
 width: u32,
 height: u32,
 format: Format,
 modifiers: impl Iterator<Item = Modifier>,
 usage: BufferObjectFlags
) -> IoResult<BufferObject>

Allocate a buffer object for the given dimensions with explicit modifiers and flags

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

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 enables 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>

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 enables 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.

Safety

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>

Create a GBM buffer object from a dma buffer

This function imports a foreign dma buffer from an open file descriptor and creates a new GBM buffer object for it. This enables 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 fn import_buffer_object_from_dma_buf_with_modifiers<U: 'static>(
 &self,
 len: u32,
 buffers: [RawFd; 4],
 width: u32,
 height: u32,
 format: Format,
 usage: BufferObjectFlags,
 strides: [i32; 4],
 offsets: [i32; 4],
 modifier: Modifier
) -> IoResult<BufferObject>

Create a GBM buffer object from a dma buffer with explicit modifiers

This function imports a foreign dma buffer from an open file descriptor and creates a new GBM buffer object for it. This enables 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: AsFd> AsFd for Device<T>

fn as_fd(&self) -> BorrowedFd<'_>

Borrows the file descriptor. Read more

impl<T: AsFd> AsRaw<gbm_device> for Device<T>

fn as_raw(&self) -> *const gbm_device

Receive a raw pointer representing this type.

impl<T: AsFd + Clone> Clone for Device<T>

fn clone(&self) -> Device<T>

Returns a copy of the value. Read more

1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

impl<T: AsFd> Debug for Device<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

impl<T: AsFd> Deref for Device<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: AsFd> DerefMut for Device<T>

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

Mutably dereferences the value.

impl<T: DrmDevice + AsFd> Device for Device<T>

fn acquire_master_lock(&self) -> Result<(), SystemError>

Acquires the DRM Master lock for this process. Read more

fn release_master_lock(&self) -> Result<(), SystemError>

Releases the DRM Master lock for another process to use.

fn generate_auth_token(&self) -> Result<AuthToken, SystemError>

👎Deprecated: Consider opening a render node instead.

Generates an AuthToken for this process.

fn authenticate_auth_token(&self, token: AuthToken) -> Result<(), SystemError>

Authenticates an AuthToken from another process.

fn set_client_capability(
 &self,
 cap: ClientCapability,
 enable: bool
) -> Result<(), SystemError>

Requests the driver to expose or hide certain capabilities. See ClientCapability for more information.

fn get_bus_id(&self) -> Result<OsString, SystemError>

Gets the [BusID] of this device.

fn authenticated(&self) -> Result<bool, SystemError>

Check to see if our AuthToken has been authenticated by the DRM Master

fn get_driver_capability(
&self,
cap: DriverCapability
) -> Result<u64, SystemError>

Gets the value of a capability.

fn get_driver(&self) -> Result<Driver, SystemError>

Possible errors: Read more

fn wait_vblank(
 &self,
 target_sequence: VblankWaitTarget,
 flags: VblankWaitFlags,
 high_crtc: u32,
 user_data: usize
) -> Result<VblankWaitReply, SystemError>

Waits for a vblank.

impl<T: DrmControlDevice + AsFd> Device for Device<T>

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

Gets the set of resource handles that this device currently controls

fn plane_handles(&self) -> Result<Vec<Handle, Global>, SystemError>

Gets the set of plane handles that this device currently has

fn get_connector(
 &self,
 handle: Handle,
 force_probe: bool
) -> Result<Info, SystemError>

Returns information about a specific connector

fn get_encoder(&self, handle: Handle) -> Result<Info, SystemError>

Returns information about a specific encoder

fn get_crtc(&self, handle: Handle) -> Result<Info, SystemError>

Returns information about a specific CRTC

fn set_crtc(
 &self,
 handle: Handle,
 framebuffer: Option<Handle>,
 pos: (u32, u32),
 conns: &[Handle],
 mode: Option<Mode>
) -> Result<(), SystemError>

Set CRTC state

fn get_framebuffer(&self, handle: Handle) -> Result<Info, SystemError>

Returns information about a specific framebuffer

fn get_planar_framebuffer(
&self,
handle: Handle
) -> Result<PlanarInfo, SystemError>

Returns information about a specific framebuffer (with modifiers)

fn add_framebuffer(
 &self,
 buffer: &B,
 depth: u32,
 bpp: u32
) -> Result<Handle, SystemError>where
 B: Buffer + ?Sized,

Add a new framebuffer

fn add_planar_framebuffer(
 &self,
 planar_buffer: &B,
 modifiers: &[Option<DrmModifier>; 4],
 flags: u32
) -> Result<Handle, SystemError>where
 B: PlanarBuffer + ?Sized,

Add framebuffer (with modifiers)

fn dirty_framebuffer(
 &self,
 handle: Handle,
 clips: &[drm_clip_rect]
) -> Result<(), SystemError>

Mark parts of a framebuffer dirty

fn destroy_framebuffer(&self, handle: Handle) -> Result<(), SystemError>

Destroy a framebuffer

fn get_plane(&self, handle: Handle) -> Result<Info, SystemError>

Returns information about a specific plane

fn set_plane(
 &self,
 handle: Handle,
 crtc: Handle,
 framebuffer: Option<Handle>,
 flags: u32,
 crtc_rect: (i32, i32, u32, u32),
 src_rect: (u32, u32, u32, u32)
) -> Result<(), SystemError>

Set plane state. Read more

fn get_property(&self, handle: Handle) -> Result<Info, SystemError>

Returns information about a specific property.

fn set_property<T>(
 &self,
 handle: T,
 prop: Handle,
 value: u64
) -> Result<(), SystemError>where
 T: ResourceHandle,

Sets a property for a specific resource.

fn create_property_blob<T>(
&self,
data: &T
) -> Result<Value<'static>, SystemError>

Create a property blob value from a given data blob

fn get_property_blob(&self, blob: u64) -> Result<Vec<u8, Global>, SystemError>

Get a property blob’s data

fn destroy_property_blob(&self, blob: u64) -> Result<(), SystemError>

Destroy a given property blob value

fn get_modes(&self, handle: Handle) -> Result<Vec<Mode, Global>, SystemError>

Returns the set of Modes that a particular connector supports.

fn get_properties<T>(&self, handle: T) -> Result<PropertyValueSet, SystemError>where
T: ResourceHandle,

Gets a list of property handles and values for this resource.

fn get_gamma(
 &self,
 crtc: Handle,
 red: &mut [u16],
 green: &mut [u16],
 blue: &mut [u16]
) -> Result<(), SystemError>

Receive the currently set gamma ramp of a crtc

fn set_gamma(
 &self,
 crtc: Handle,
 red: &[u16],
 green: &[u16],
 blue: &[u16]
) -> Result<(), SystemError>

Set a gamma ramp for the given crtc

fn open_buffer(&self, name: Name) -> Result<Handle, SystemError>

Open a GEM buffer handle by name

fn close_buffer(&self, handle: Handle) -> Result<(), SystemError>

Close a GEM buffer handle

fn create_dumb_buffer(
 &self,
 size: (u32, u32),
 format: DrmFourcc,
 bpp: u32
) -> Result<DumbBuffer, SystemError>

Create a new dumb buffer with a given size and pixel format

fn map_dumb_buffer<'a>(
&self,
buffer: &'a mut DumbBuffer
) -> Result<DumbMapping<'a>, SystemError>

Map the buffer for access

fn destroy_dumb_buffer(&self, buffer: DumbBuffer) -> Result<(), SystemError>

Free the memory resources of a dumb buffer

fn set_cursor(
 &self,
 crtc: Handle,
 buffer: Option<&B>
) -> Result<(), SystemError>where
 B: Buffer + ?Sized,

👎Deprecated: Usage of deprecated ioctl set_cursor: use a cursor plane instead

Sets a hardware-cursor on the given crtc with the image of a given buffer Read more

fn set_cursor2(
 &self,
 crtc: Handle,
 buffer: Option<&B>,
 hotspot: (i32, i32)
) -> Result<(), SystemError>where
 B: Buffer + ?Sized,

👎Deprecated: Usage of deprecated ioctl set_cursor2: use a cursor plane instead

Sets a hardware-cursor on the given crtc with the image of a given buffer and a hotspot marking the click point of the cursor. Read more

fn move_cursor(&self, crtc: Handle, pos: (i32, i32)) -> Result<(), SystemError>

👎Deprecated: Usage of deprecated ioctl move_cursor: use a cursor plane instead

Moves a set cursor on a given crtc

fn atomic_commit(
 &self,
 flags: AtomicCommitFlags,
 req: AtomicModeReq
) -> Result<(), SystemError>

Request an atomic commit with given flags and property-value pair for a list of objects.

fn prime_fd_to_buffer(&self, fd: i32) -> Result<Handle, SystemError>

Convert a prime file descriptor to a GEM buffer handle

fn buffer_to_prime_fd(
 &self,
 handle: Handle,
 flags: u32
) -> Result<i32, SystemError>

Convert a prime file descriptor to a GEM buffer handle

fn page_flip(
 &self,
 handle: Handle,
 framebuffer: Handle,
 flags: PageFlipFlags,
 target_sequence: Option<PageFlipTarget>
) -> Result<(), SystemError>

Queue a page flip on the given crtc

fn receive_events(&self) -> Result<Events, SystemError>where
Self: Sized,

Receive pending events

Auto Trait Implementations§

impl<T> !UnwindSafe for Device<T>

Blanket Implementations§

impl<T> Any for Twhere
T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> AsFilelike for Twhere
T: AsFd,

fn as_filelike(&self) -> BorrowedFd<'_>

Borrows the reference. Read more

fn as_filelike_view<Target>(&self) -> FilelikeView<'_, Target>where
Target: FilelikeViewType,

Return a borrowing view of a resource which dereferences to a &Target. Read more

impl<T> AsSocketlike for Twhere
T: AsFd,

fn as_socketlike(&self) -> BorrowedFd<'_>

Borrows the reference.

fn as_socketlike_view<Target>(&self) -> SocketlikeView<'_, Target>where
Target: SocketlikeViewType,

Return a borrowing view of a resource which dereferences to a &Target. Read more

impl<T> Borrow<T> for Twhere
T: ?Sized,

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for Twhere
T: ?Sized,

const: unstable · source§

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

Mutably borrows from an owned value. Read more

impl<T> Downcast for Twhere
T: Any,

fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.

impl<T> From<T> for T

const: unstable · source§

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into for Twhere
U: From<T>,

const: unstable · source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> ToOwned for Twhere
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom for Twhere
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source§

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

impl<T, U> TryInto for Twhere
U: TryFrom<T>,