Struct CuX11Backend 

pub struct CuX11Backend { /* private fields */ }

Implementations

impl CuX11Backend

pub fn connect() -> Result<Self, String>

Connect to the X server named by DISPLAY and negotiate XTEST (required for any injection). XFixes is optional and only gates cursor compositing in screenshots.

Trait Implementations

impl CuBackend for CuX11Backend

fn name(&self) -> &'static str

fn fb_size(&self) -> Result<(i32, i32), String>

fn key(&self, scancode: u32, pressed: bool)

fn mouse_move(&self, x: f64, y: f64)

fn button(&self, btn: CuButton, pressed: bool)

fn scroll(&self, dx: f64, dy: f64)

fn screenshot_png(&self, display: u32) -> Result<Vec<u8>, String>

PNG of one display’s framebuffer; 0 = the primary. Unknown ids are an error.

fn cursor_pos(&self) -> Result<(f64, f64), String>

fn resolve_keysyms(&self, keysyms: &[u32]) -> Vec<(u32, u32)>

Resolve keysyms against the backend’s ACTIVE keymap: one (keycode, shift level) per input keysym, (0, 0) where the keymap cannot produce it. Level bit 0 = Shift, bit 1 = AltGr — the order xkb two/four-level key types use. Wayland resolves through the compositor’s keymap policy (overlay-binding what the base lacks); X11 through the server’s own GetKeyboardMapping.

fn altgr_keycode(&self) -> u32

Keycode synthesized around AltGr-level hits (level bit 1). The default is the pc105 right-Alt position the compositor’s seat keymap binds to ISO_Level3_Shift; the X11 backend overrides it with the level-3 modifier key found in the server’s keymap (0 = none, in which case resolve_keysyms reports no AltGr levels).

fn with_transient_keysyms( &self, keysyms: &[u32], seq: &mut dyn FnMut(&HashMap<u32, u32>), )

Run seq with every keysym in keysyms (which resolve_keysyms could not place) made temporarily typeable, when the backend can arrange that; seq receives keysym -> keycode for the transient bindings (empty when none could be arranged, in which case those keysyms simply stay untypeable). Wayland’s resolve_keysyms already overlay-binds anything the base keymap lacks, so the default runs seq with no bindings; the X11 backend overrides this with a grab-atomic spare-keycode remap.

fn display_fb_size(&self, display: u32) -> Result<(i32, i32), String>

One display’s framebuffer size; 0 = the primary. Unknown ids are an error. The X11 backend serves only the root (display 0); Wayland resolves any live output id.

impl Drop for CuX11Backend

fn drop(&mut self)

Closing the connection can race the server’s client teardown against still-buffered fake-input requests (observed as lost button releases); one round trip forces the server to consume everything sent on this connection before it goes away.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.