23 releases (breaking)

new 0.18.0 Dec 3, 2024
0.16.1 Nov 21, 2024
0.15.0 Apr 19, 2024
0.14.2 Feb 15, 2024
0.1.0 Aug 24, 2016

#23 in Memory management

Download history 15118/week @ 2024-08-17 15177/week @ 2024-08-24 16907/week @ 2024-08-31 14935/week @ 2024-09-07 15347/week @ 2024-09-14 16872/week @ 2024-09-21 20867/week @ 2024-09-28 20452/week @ 2024-10-05 19863/week @ 2024-10-12 18928/week @ 2024-10-19 17442/week @ 2024-10-26 19870/week @ 2024-11-02 7759/week @ 2024-11-09 8050/week @ 2024-11-16 8299/week @ 2024-11-23 6806/week @ 2024-11-30

34,534 downloads per month
Used in 12 crates (3 directly)

MIT license

60KB
1.5K SLoC

Safe libgbm bindings for rust

The Generic Buffer Manager

This module provides an abstraction that the caller can use to request a buffer from the underlying memory management system for the platform.

This allows the creation of portable code whilst still allowing access to the underlying memory manager.

This library is best used in combination with drm-rs, provided through the drm-support feature.

Usage

Add to your Cargo.toml

gbm = "0.18.0"

Example

use drm::control::{self, crtc, framebuffer};
use gbm::{BufferObjectFlags, Device, Format};

// ... init your drm device ...
let drm = init_drm_device();

// init a GBM device
let gbm = Device::new(drm).unwrap();

// create a buffer
let mut bo = gbm
    .create_buffer_object::<()>(
        1280,
        720,
        Format::Argb8888,
        BufferObjectFlags::SCANOUT | BufferObjectFlags::WRITE,
    )
    .unwrap();

// write something to it (usually use import or egl rendering instead)
let buffer = {
    let mut buffer = Vec::new();
    for i in 0..1280 {
        for _ in 0..720 {
            buffer.push(if i % 2 == 0 { 0 } else { 255 });
        }
    }
    buffer
};
bo.write(&buffer).unwrap();

// create a framebuffer from our buffer
let fb = gbm.add_framebuffer(&bo, 32, 32).unwrap();

// display it (and get a crtc, mode and connector before)
gbm.set_crtc(crtc_handle, Some(fb), (0, 0), &[con], Some(mode))
    .unwrap();

Dependencies

~0.1–9MB
~93K SLoC