smithay 0.7.0

Smithay is a library for writing wayland compositors.
Documentation 
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

//! Implementation for ExportFramebuffer and related utilizies for dumb buffers

use thiserror::Error;

use super::{ExportBuffer, ExportFramebuffer};
use crate::backend::{
    allocator::dumb::DumbBuffer,
    drm::{
        dumb::{framebuffer_from_dumb_buffer, DumbFramebuffer},
        error::AccessError,
        DrmDeviceFd,
    },
};

/// Possible errors for attaching a [`framebuffer::Handle`](::drm::control::framebuffer::Handle)
#[derive(Error, Debug)]
pub enum Error {
    /// The buffer is not supported
    #[error("Unsupported buffer supplied")]
    Unsupported,
    /// Failed to add a framebuffer for the dumb buffer
    #[error("failed to add a framebuffer for the dumb buffer")]
    Drm(AccessError),
}

impl ExportFramebuffer<DumbBuffer> for DrmDeviceFd {
    type Framebuffer = DumbFramebuffer;
    type Error = Error;

    #[profiling::function]
    fn add_framebuffer(
        &self,
        _drm: &DrmDeviceFd,
        buffer: ExportBuffer<'_, DumbBuffer>,
        use_opaque: bool,
    ) -> Result<Option<Self::Framebuffer>, Self::Error> {
        match buffer {
            #[cfg(feature = "wayland_frontend")]
            ExportBuffer::Wayland(_) => return Err(Error::Unsupported),
            ExportBuffer::Allocator(buffer) => framebuffer_from_dumb_buffer(self, buffer, use_opaque)
                .map_err(Error::Drm)
                .map(Some),
        }
    }

    #[inline]
    fn can_add_framebuffer(&self, buffer: &ExportBuffer<'_, DumbBuffer>) -> bool {
        match buffer {
            #[cfg(feature = "wayland_frontend")]
            ExportBuffer::Wayland(_) => false,
            ExportBuffer::Allocator(_) => true,
        }
    }
}