whitebreadx 0.1.0

A breadx library that provides a wrapper for libxcb and libX11.
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

//               Copyright John Nunley, 2022.
// Distributed under the Boost Software License, Version 1.0.
//       (See accompanying file LICENSE or copy at
//         https://www.boost.org/LICENSE_1_0.txt)

#![cfg(feature = "xlib")]

use crate::{sync::Lazy, xcb_ffi::Connection};
use libc::{c_char, c_int};

#[cfg(feature = "dl")]
mod dynamic_link;
#[cfg(not(feature = "dl"))]
mod static_link;

/// FFI with `libX11`, using either static or dynamic linking.
///
/// # Safety
///
/// This trait is unsafe because it is not guaranteed that the underlying
/// library is safe.
#[allow(non_snake_case)]
pub(crate) unsafe trait X11Ffi {
    unsafe fn XOpenDisplay(&self, display: *const c_char) -> *mut XDisplay;
    unsafe fn XCloseDisplay(&self, display: *mut XDisplay) -> c_int;
    unsafe fn XDefaultScreen(&self, display: *mut XDisplay) -> c_int;
    unsafe fn XGetXCBConnection(&self, display: *mut XDisplay) -> *mut Connection;
    unsafe fn XInitThreads(&self) -> c_int;
}

#[repr(C)]
pub(crate) struct XDisplay {
    _opaque_type: [u8; 0],
}

#[cfg(not(feature = "dl"))]
type Impl = static_link::StaticLink;
#[cfg(feature = "dl")]
type Impl = dynamic_link::DynamicLink;

static XLIB: Lazy<Impl> = Lazy::new(|| {
    cfg_if::cfg_if! {
        if #[cfg(not(feature = "dl"))] {
            static_link::StaticLink
        } else {
            dynamic_link::DynamicLink::load()
        }
    }
});

pub(crate) fn xlib() -> &'static Impl {
    &*XLIB
}