libmars 0.6.2

Library to build window managers and accompanying utilities
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155

extern crate x11;

use std::fmt::{Display, Formatter, Result};
use x11::xlib;
use std::ffi::*;

use crate::*;

enum_with_values! {
    #[derive(Clone, Copy, Debug, PartialEq, Eq)]
    vis pub enum X11Atom {
        // ICCCM
        UTF8String,
        WMClass,
        WMDeleteWindow,
        WMIconName,
        WMIconSize,
        WMName,
        WMNormalHints,
        WMProtocols,
        WMState,

        // EWMH
        NetActiveWindow,
        NetClientList,
        NetClientListStacking,
        NetCloseWindow,
        NetCurrentDesktop,
        NetDesktopGeometry,
        NetDesktopNames,
        NetDesktopViewport,
        NetNumberOfDesktops,
        NetSupported,
        NetSupportingWMCheck,
        NetSystemTray,
        NetSystemTrayOpcode,
        NetSystemTrayOrientation,
        NetWMDesktop,
        NetWMName,
        NetWMState,
        NetWMStateFullscreen,
        NetWMWindowType,
        NetWMWindowTypeDesktop,
        NetWMWindowTypeDialog,
        NetWMWindowTypeDock,
        NetWMWindowTypeMenu,
        NetWMWindowTypeNotification,
        NetWMWindowTypeSplash,
        NetWorkarea,

        // Motif
        MotifWMHints,

        // XEMBED
        Manager,
        Xembed,
        XembedInfo,

        // TODO add custom hints for pinned, tiled
        // MARS (custom)
        MarsCenter,
        MarsStatus,
        MarsWMStateTiled
    }
}

impl Display for X11Atom {
    fn fmt(&self, f: &mut Formatter<'_>) -> Result {
        let string = match self {
            X11Atom::UTF8String => "UTF8_STRING",
            X11Atom::WMClass => "WM_CLASS",
            X11Atom::WMDeleteWindow => "WM_DELETE_WINDOW",
            X11Atom::WMIconName => "WM_ICON_NAME",
            X11Atom::WMIconSize => "WM_ICON_SIZE",
            X11Atom::WMProtocols => "WM_PROTOCOLS",
            X11Atom::WMName => "WM_NAME",
            X11Atom::WMNormalHints => "WM_NORMAL_HINTS",
            X11Atom::WMState => "WM_STATE",

            X11Atom::NetActiveWindow => "_NET_ACTIVE_WINDOW",
            X11Atom::NetClientList => "_NET_CLIENT_LIST",
            X11Atom::NetClientListStacking => "_NET_CLIENT_LIST_STACKING",
            X11Atom::NetCloseWindow => "_NET_CLOSE_WINDOW",
            X11Atom::NetCurrentDesktop => "_NET_CURRENT_DESKTOP",
            X11Atom::NetDesktopGeometry => "_NET_DESKTOP_GEOMETRY",
            X11Atom::NetDesktopNames => "_NET_DESKTOP_NAMES",
            X11Atom::NetDesktopViewport => "_NET_DESKTOP_VIEWPORT",
            X11Atom::NetNumberOfDesktops => "_NET_NUMBER_OF_DESKTOPS",
            X11Atom::NetSupported => "_NET_SUPPORTED",
            X11Atom::NetSupportingWMCheck => "_NET_SUPPORTING_WM_CHECK",
            X11Atom::NetSystemTray => "_NET_SYSTEM_TRAY_S0",
            X11Atom::NetSystemTrayOpcode => "_NET_SYSTEM_TRAY_OPCODE",
            X11Atom::NetSystemTrayOrientation => "_NET_SYSTEM_TRAY_ORIENTATION",
            X11Atom::NetWMDesktop => "_NET_WM_DESKTOP",
            X11Atom::NetWMName => "_NET_WM_NAME",
            X11Atom::NetWMState => "_NET_WM_STATE",
            X11Atom::NetWMStateFullscreen => "_NET_WM_STATE_FULLSCREEN",
            X11Atom::NetWMWindowType => "_NET_WM_WINDOW_TYPE",
            X11Atom::NetWMWindowTypeDock => "_NET_WM_WINDOW_TYPE_DOCK",
            X11Atom::NetWMWindowTypeDesktop => "_NET_WM_WINDOW_TYPE_DESKTOP",
            X11Atom::NetWMWindowTypeDialog => "_NET_WM_WINDOW_TYPE_DIALOG",
            X11Atom::NetWMWindowTypeMenu => "_NET_WM_WINDOW_TYPE_MENU",
            X11Atom::NetWMWindowTypeNotification => "_NET_WM_WINDOW_TYPE_NOTIFICATION",
            X11Atom::NetWMWindowTypeSplash => "_NET_WM_WINDOW_TYPE_SPLASH",
            X11Atom::NetWorkarea => "_NET_WORKAREA",

            X11Atom::MotifWMHints => "_MOTIF_WM_HINTS",

            X11Atom::Manager => "MANAGER",
            X11Atom::Xembed => "_XEMBED",
            X11Atom::XembedInfo => "_XEMBED_INFO",

            X11Atom::MarsCenter => "_MARS_CENTER",
            X11Atom::MarsStatus => "_MARS_STATUS",
            X11Atom::MarsWMStateTiled => "_MARS_WM_STATE_TILED",
        };
        write!(f, "{}", string)
    }
}

impl X11Atom {
    pub fn from_xlib_atom(display: *mut xlib::Display, atom: xlib::Atom) -> Option<X11Atom> {
        let name = unsafe {
            let raw_string = xlib::XGetAtomName(display, atom);
            // FIXME use CStr and XFree instead
            CString::from_raw(raw_string).into_string().unwrap()
        };
        for atom in Self::VALUES {
            if atom.to_string() == name {
                return Some(*atom);
            }
        }
        None
    }

    pub fn to_xlib_atom(&self, display: *mut xlib::Display) -> xlib::Atom {
        let atom_name = CString::new(self.to_string()).unwrap().into_raw();
        unsafe {
            xlib::XInternAtom(display, atom_name, xlib::False)
        }
    }
}

pub fn atom_name(display: *mut xlib::Display, atom: xlib::Atom) -> Option<String> {
    unsafe {
        let name_ptr = xlib::XGetAtomName(display, atom);
        if name_ptr.is_null() {
            None
        } else {
            let name = CStr::from_ptr(name_ptr).to_string_lossy().to_string();
            xlib::XFree(name_ptr as *mut c_void);
            Some(name)
        }
    }
}