a6cfe3f22d
* exwm-input.el (exwm-input-prefix-keys): Remove ?\C-c. (exwm-input--on-KeyPress-line-mode): * exwm-core.el (): Detect keys in `exwm-mode-map' in line-mode.
983 lines
42 KiB
EmacsLisp
983 lines
42 KiB
EmacsLisp
;;; exwm-input.el --- Input Module for EXWM -*- lexical-binding: t -*-
|
||
|
||
;; Copyright (C) 2015-2018 Free Software Foundation, Inc.
|
||
|
||
;; Author: Chris Feng <chris.w.feng@gmail.com>
|
||
|
||
;; This file is part of GNU Emacs.
|
||
|
||
;; GNU Emacs is free software: you can redistribute it and/or modify
|
||
;; it under the terms of the GNU General Public License as published by
|
||
;; the Free Software Foundation, either version 3 of the License, or
|
||
;; (at your option) any later version.
|
||
|
||
;; GNU Emacs is distributed in the hope that it will be useful,
|
||
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
;; GNU General Public License for more details.
|
||
|
||
;; You should have received a copy of the GNU General Public License
|
||
;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|
||
|
||
;;; Commentary:
|
||
|
||
;; This module deals with key/mouse matters, including:
|
||
;; + Input focus,
|
||
;; + Key/Button event handling,
|
||
;; + Key events filtering and simulation.
|
||
|
||
;; Todo:
|
||
;; + Pointer simulation mode (e.g. 'C-c 1'/'C-c 2' for single/double click,
|
||
;; move with arrow keys).
|
||
;; + Simulation keys to mimic Emacs key bindings for text edit (redo, select,
|
||
;; cancel, clear, etc). Some of them are not present on common keyboard
|
||
;; (keycode = 0). May need to use XKB extension.
|
||
|
||
;;; Code:
|
||
|
||
(require 'xcb-keysyms)
|
||
(require 'exwm-core)
|
||
|
||
(defgroup exwm-input nil
|
||
"Input."
|
||
:version "25.3"
|
||
:group 'exwm)
|
||
|
||
(defcustom exwm-input-prefix-keys
|
||
'(?\C-x ?\C-u ?\C-h ?\M-x ?\M-` ?\M-& ?\M-:)
|
||
"List of prefix keys EXWM should forward to Emacs when in line-mode.
|
||
|
||
The point is to make keys like 'C-x C-f' forwarded to Emacs in line-mode.
|
||
There is no need to add prefix keys for global/simulation keys or those
|
||
defined in `exwm-mode-map' here."
|
||
:type '(repeat key-sequence)
|
||
:get (lambda (symbol)
|
||
(mapcar #'vector (default-value symbol)))
|
||
:set (lambda (symbol value)
|
||
(set symbol (mapcar (lambda (i)
|
||
(if (sequencep i)
|
||
(aref i 0)
|
||
i))
|
||
value))))
|
||
|
||
(defcustom exwm-input-move-event 's-down-mouse-1
|
||
"Emacs event to start moving a window."
|
||
:type 'key-sequence
|
||
:get (lambda (symbol)
|
||
(let ((value (default-value symbol)))
|
||
(if (mouse-event-p value)
|
||
value
|
||
(vector value))))
|
||
:set (lambda (symbol value)
|
||
(set symbol (if (sequencep value)
|
||
(aref value 0)
|
||
value))))
|
||
|
||
(defcustom exwm-input-resize-event 's-down-mouse-3
|
||
"Emacs event to start resizing a window."
|
||
:type 'key-sequence
|
||
:get (lambda (symbol)
|
||
(let ((value (default-value symbol)))
|
||
(if (mouse-event-p value)
|
||
value
|
||
(vector value))))
|
||
:set (lambda (symbol value)
|
||
(set symbol (if (sequencep value)
|
||
(aref value 0)
|
||
value))))
|
||
|
||
(defcustom exwm-input-line-mode-passthrough nil
|
||
"Non-nil makes 'line-mode' forwards all events to Emacs."
|
||
:type 'boolean)
|
||
|
||
;; Input focus update requests should be accumulated for a short time
|
||
;; interval so that only the last one need to be processed. This not
|
||
;; improves the overall performance, but avoids the problem of input
|
||
;; focus loop, which is a result of the interaction with Emacs frames.
|
||
;;
|
||
;; FIXME: The time interval is hard to decide and perhaps machine-dependent.
|
||
;; A value too small can cause redundant updates of input focus,
|
||
;; and even worse, dead loops. OTOH a large value would bring
|
||
;; laggy experience.
|
||
(defconst exwm-input--update-focus-interval 0.01
|
||
"Time interval (in seconds) for accumulating input focus update requests.")
|
||
|
||
(defvar exwm-input--during-command nil
|
||
"Indicate whether between `pre-command-hook' and `post-command-hook'.")
|
||
|
||
(defvar exwm-input--global-keys nil "Global key bindings.")
|
||
|
||
(defvar exwm-input--global-prefix-keys nil
|
||
"List of prefix keys of global key bindings.")
|
||
|
||
(defvar exwm-input--line-mode-cache nil "Cache for incomplete key sequence.")
|
||
|
||
(defvar exwm-input--local-simulation-keys nil
|
||
"Whether simulation keys are local.")
|
||
|
||
(defvar exwm-input--simulation-keys nil "Simulation keys in line-mode.")
|
||
|
||
(defvar exwm-input--temp-line-mode nil
|
||
"Non-nil indicates it's in temporary line-mode for char-mode.")
|
||
|
||
(defvar exwm-input--timestamp-atom nil)
|
||
|
||
(defvar exwm-input--timestamp-callback nil)
|
||
|
||
(defvar exwm-input--timestamp-window nil)
|
||
|
||
(defvar exwm-input--update-focus-defer-timer nil "Timer for polling the lock.")
|
||
|
||
(defvar exwm-input--update-focus-lock nil
|
||
"Lock for solving input focus update contention.")
|
||
|
||
(defvar exwm-input--update-focus-timer nil
|
||
"Timer for deferring the update of input focus.")
|
||
|
||
(defvar exwm-input--update-focus-window nil "The (Emacs) window to be focused.
|
||
This value should always be overwritten.")
|
||
|
||
(defvar exwm-workspace--current)
|
||
(declare-function exwm-floating--do-moveresize "exwm-floating.el"
|
||
(data _synthetic))
|
||
(declare-function exwm-floating--start-moveresize "exwm-floating.el"
|
||
(id &optional type))
|
||
(declare-function exwm-floating--stop-moveresize "exwm-floating.el"
|
||
(&rest _args))
|
||
(declare-function exwm-layout--iconic-state-p "exwm-layout.el" (&optional id))
|
||
(declare-function exwm-layout--show "exwm-layout.el" (id &optional window))
|
||
(declare-function exwm-workspace--client-p "exwm-workspace.el"
|
||
(&optional frame))
|
||
(declare-function exwm-workspace--minibuffer-own-frame-p "exwm-workspace.el")
|
||
(declare-function exwm-workspace--workspace-p "exwm-workspace.el" (workspace))
|
||
(declare-function exwm-workspace-switch "exwm-workspace.el"
|
||
(frame-or-index &optional force))
|
||
|
||
(defun exwm-input--set-focus (id)
|
||
"Set input focus to window ID in a proper way."
|
||
(when (exwm--id->buffer id)
|
||
(with-current-buffer (exwm--id->buffer id)
|
||
(cond
|
||
((and (not exwm--hints-input)
|
||
(memq xcb:Atom:WM_TAKE_FOCUS exwm--protocols))
|
||
(when (= (frame-parameter nil 'exwm-id)
|
||
(slot-value (xcb:+request-unchecked+reply exwm--connection
|
||
(make-instance 'xcb:GetInputFocus))
|
||
'focus))
|
||
(exwm--log "Focus on #x%x with WM_TAKE_FOCUS" id)
|
||
(exwm-input--update-timestamp
|
||
(lambda (timestamp id)
|
||
(let ((event (make-instance 'xcb:icccm:WM_TAKE_FOCUS
|
||
:window id
|
||
:time timestamp)))
|
||
(setq event (xcb:marshal event exwm--connection))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:icccm:SendEvent
|
||
:destination id
|
||
:event event))
|
||
(exwm-input--set-active-window id)
|
||
(xcb:flush exwm--connection)))
|
||
id)))
|
||
(t
|
||
(exwm--log "Focus on #x%x with SetInputFocus" id)
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:SetInputFocus
|
||
:revert-to xcb:InputFocus:Parent
|
||
:focus id
|
||
:time xcb:Time:CurrentTime))
|
||
(exwm-input--set-active-window id)
|
||
(xcb:flush exwm--connection))))))
|
||
|
||
(defun exwm-input--update-timestamp (callback &rest args)
|
||
"Fetch the latest timestamp from the server and feed it to CALLBACK.
|
||
|
||
ARGS are additional arguments to CALLBACK."
|
||
(setq exwm-input--timestamp-callback (cons callback args))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:ChangeProperty
|
||
:mode xcb:PropMode:Replace
|
||
:window exwm-input--timestamp-window
|
||
:property exwm-input--timestamp-atom
|
||
:type xcb:Atom:CARDINAL
|
||
:format 32
|
||
:data-len 0
|
||
:data nil))
|
||
(xcb:flush exwm--connection))
|
||
|
||
(defun exwm-input--on-PropertyNotify (data _synthetic)
|
||
"Handle PropertyNotify events."
|
||
(when exwm-input--timestamp-callback
|
||
(let ((obj (make-instance 'xcb:PropertyNotify)))
|
||
(xcb:unmarshal obj data)
|
||
(when (= exwm-input--timestamp-window
|
||
(slot-value obj 'window))
|
||
(apply (car exwm-input--timestamp-callback)
|
||
(slot-value obj 'time)
|
||
(cdr exwm-input--timestamp-callback))
|
||
(setq exwm-input--timestamp-callback nil)))))
|
||
|
||
(defun exwm-input--on-EnterNotify (data _synthetic)
|
||
"Handle EnterNotify events."
|
||
(let ((evt (make-instance 'xcb:EnterNotify))
|
||
buffer window frame frame-xid edges fake-evt)
|
||
(xcb:unmarshal evt data)
|
||
(with-slots (time root event root-x root-y event-x event-y state) evt
|
||
(setq buffer (exwm--id->buffer event)
|
||
window (get-buffer-window buffer t))
|
||
(when (and buffer window (not (eq window (selected-window))))
|
||
(setq frame (window-frame window)
|
||
frame-xid (frame-parameter frame 'exwm-id))
|
||
(unless (eq frame exwm-workspace--current)
|
||
(if (exwm-workspace--workspace-p frame)
|
||
;; The X window is on another workspace.
|
||
(exwm-workspace-switch frame)
|
||
(with-current-buffer buffer
|
||
(when (and (eq major-mode 'exwm-mode)
|
||
(not (eq exwm--frame exwm-workspace--current)))
|
||
;; The floating X window is on another workspace.
|
||
(exwm-workspace-switch exwm--frame)))))
|
||
;; Send a fake MotionNotify event to Emacs.
|
||
(setq edges (window-inside-pixel-edges window)
|
||
fake-evt (make-instance 'xcb:MotionNotify
|
||
:detail 0
|
||
:time time
|
||
:root root
|
||
:event frame-xid
|
||
:child xcb:Window:None
|
||
:root-x root-x
|
||
:root-y root-y
|
||
:event-x (+ event-x (elt edges 0))
|
||
:event-y (+ event-y (elt edges 1))
|
||
:state state
|
||
:same-screen 1))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:SendEvent
|
||
:propagate 0
|
||
:destination frame-xid
|
||
:event-mask xcb:EventMask:NoEvent
|
||
:event (xcb:marshal fake-evt exwm--connection)))
|
||
(xcb:flush exwm--connection)))))
|
||
|
||
(defun exwm-input--on-keysyms-update ()
|
||
(let ((exwm-input--global-prefix-keys nil))
|
||
(exwm-input--update-global-prefix-keys)))
|
||
|
||
(defun exwm-input--on-buffer-list-update ()
|
||
"Run in `buffer-list-update-hook' to track input focus."
|
||
(when (and (not (eq this-command #'handle-switch-frame))
|
||
(not (exwm-workspace--client-p))
|
||
;; The following conditions filter out events relating to temp
|
||
;; buffers.
|
||
(eq (current-buffer) (window-buffer))
|
||
(not (string-prefix-p " *temp*"
|
||
(buffer-name (car (last (buffer-list)))))))
|
||
(redirect-frame-focus (selected-frame) nil)
|
||
(setq exwm-input--update-focus-window (selected-window))
|
||
(exwm-input--update-focus-defer)))
|
||
|
||
(defun exwm-input--update-focus-defer ()
|
||
"Defer updating input focus."
|
||
(when exwm-input--update-focus-defer-timer
|
||
(cancel-timer exwm-input--update-focus-defer-timer))
|
||
(if exwm-input--update-focus-lock
|
||
(setq exwm-input--update-focus-defer-timer
|
||
(exwm--defer 0 #'exwm-input--update-focus-defer))
|
||
(setq exwm-input--update-focus-defer-timer nil)
|
||
(when exwm-input--update-focus-timer
|
||
(cancel-timer exwm-input--update-focus-timer))
|
||
(setq exwm-input--update-focus-timer
|
||
;; Attempt to accumulate successive events close enough.
|
||
(run-with-timer exwm-input--update-focus-interval
|
||
nil
|
||
#'exwm-input--update-focus-commit
|
||
exwm-input--update-focus-window))))
|
||
|
||
(defun exwm-input--update-focus-commit (window)
|
||
"Commit updating input focus."
|
||
(setq exwm-input--update-focus-lock t)
|
||
(unwind-protect
|
||
(exwm-input--update-focus window)
|
||
(setq exwm-input--update-focus-lock nil)))
|
||
|
||
(defun exwm-input--update-focus (window)
|
||
"Update input focus."
|
||
(when (window-live-p window)
|
||
(with-current-buffer (window-buffer window)
|
||
(if (eq major-mode 'exwm-mode)
|
||
(if (not (eq exwm--frame exwm-workspace--current))
|
||
(progn
|
||
(set-frame-parameter exwm--frame 'exwm-selected-window window)
|
||
(exwm--defer 0 #'exwm-workspace-switch exwm--frame))
|
||
(exwm--log "Set focus on #x%x" exwm--id)
|
||
(when exwm--floating-frame
|
||
;; Adjust stacking orders of the floating X window.
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:ConfigureWindow
|
||
:window exwm--id
|
||
:value-mask xcb:ConfigWindow:StackMode
|
||
:stack-mode xcb:StackMode:TopIf))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:ConfigureWindow
|
||
:window (frame-parameter exwm--floating-frame
|
||
'exwm-container)
|
||
:value-mask (logior
|
||
xcb:ConfigWindow:Sibling
|
||
xcb:ConfigWindow:StackMode)
|
||
:sibling exwm--id
|
||
:stack-mode xcb:StackMode:Below))
|
||
;; This floating X window might be hide by `exwm-floating-hide'.
|
||
(when (exwm-layout--iconic-state-p)
|
||
(exwm-layout--show exwm--id window))
|
||
(xcb:flush exwm--connection))
|
||
(exwm-input--set-focus exwm--id))
|
||
(when (eq (selected-window) window)
|
||
(exwm--log "Focus on %s" window)
|
||
(if (and (exwm-workspace--workspace-p (selected-frame))
|
||
(not (eq (selected-frame) exwm-workspace--current)))
|
||
;; The focus is on another workspace (e.g. it got clicked)
|
||
;; so switch to it.
|
||
(progn
|
||
(set-frame-parameter (selected-frame) 'exwm-selected-window
|
||
window)
|
||
(exwm--defer 0 #'exwm-workspace-switch (selected-frame)))
|
||
;; The focus is still on the current workspace.
|
||
(if (not (and (exwm-workspace--minibuffer-own-frame-p)
|
||
(minibufferp)))
|
||
(x-focus-frame (window-frame window))
|
||
;; X input focus should be set on the previously selected
|
||
;; frame.
|
||
(x-focus-frame (window-frame (minibuffer-selected-window))))
|
||
(exwm-input--set-active-window)
|
||
(xcb:flush exwm--connection)))))))
|
||
|
||
(defun exwm-input--on-minibuffer-setup ()
|
||
"Run in `minibuffer-setup-hook' to set input focus."
|
||
(unless (exwm-workspace--client-p)
|
||
;; Set input focus on the Emacs frame
|
||
(x-focus-frame (window-frame (minibuffer-selected-window)))))
|
||
|
||
(defun exwm-input--set-active-window (&optional id)
|
||
"Set _NET_ACTIVE_WINDOW."
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:ewmh:set-_NET_ACTIVE_WINDOW
|
||
:window exwm--root
|
||
:data (or id xcb:Window:None))))
|
||
|
||
(defun exwm-input--on-ButtonPress (data _synthetic)
|
||
"Handle ButtonPress event."
|
||
(let ((obj (make-instance 'xcb:ButtonPress))
|
||
(mode xcb:Allow:SyncPointer)
|
||
button-event window buffer frame)
|
||
(xcb:unmarshal obj data)
|
||
(with-slots (detail time event state) obj
|
||
(setq button-event (xcb:keysyms:keysym->event exwm--connection
|
||
detail state)
|
||
window (get-buffer-window (exwm--id->buffer event) t)
|
||
buffer (window-buffer window))
|
||
(cond ((and (eq button-event exwm-input-move-event)
|
||
;; Either an undecorated or a floating X window.
|
||
(with-current-buffer buffer
|
||
(or (not (eq major-mode 'exwm-mode))
|
||
exwm--floating-frame)))
|
||
;; Move
|
||
(exwm-floating--start-moveresize
|
||
event xcb:ewmh:_NET_WM_MOVERESIZE_MOVE))
|
||
((and (eq button-event exwm-input-resize-event)
|
||
(with-current-buffer buffer
|
||
(or (not (eq major-mode 'exwm-mode))
|
||
exwm--floating-frame)))
|
||
;; Resize
|
||
(exwm-floating--start-moveresize event))
|
||
(t
|
||
;; Click to focus
|
||
(unless (eq window (selected-window))
|
||
(setq frame (window-frame window))
|
||
(unless (eq frame exwm-workspace--current)
|
||
(if (exwm-workspace--workspace-p frame)
|
||
;; The X window is on another workspace
|
||
(exwm-workspace-switch frame)
|
||
(with-current-buffer buffer
|
||
(when (and (eq major-mode 'exwm-mode)
|
||
(not (eq exwm--frame
|
||
exwm-workspace--current)))
|
||
;; The floating X window is on another workspace
|
||
(exwm-workspace-switch exwm--frame)))))
|
||
;; It has been reported that the `window' may have be deleted
|
||
(if (window-live-p window)
|
||
(select-window window)
|
||
(setq window
|
||
(get-buffer-window (exwm--id->buffer event) t))
|
||
(when window (select-window window))))
|
||
;; The event should be replayed
|
||
(setq mode xcb:Allow:ReplayPointer))))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:AllowEvents :mode mode :time xcb:Time:CurrentTime))
|
||
(xcb:flush exwm--connection)))
|
||
|
||
(defun exwm-input--on-KeyPress (data _synthetic)
|
||
"Handle KeyPress event."
|
||
(let ((obj (make-instance 'xcb:KeyPress)))
|
||
(xcb:unmarshal obj data)
|
||
(if (eq major-mode 'exwm-mode)
|
||
(funcall exwm--on-KeyPress obj data)
|
||
(exwm-input--on-KeyPress-char-mode obj))))
|
||
|
||
(defun exwm-input--on-CreateNotify (data _synthetic)
|
||
"Handle CreateNotify events."
|
||
(let ((evt (make-instance 'xcb:CreateNotify)))
|
||
(xcb:unmarshal evt data)
|
||
(with-slots (window) evt
|
||
(exwm-input--grab-global-prefix-keys window))))
|
||
|
||
(defun exwm-input--update-global-prefix-keys ()
|
||
"Update `exwm-input--global-prefix-keys'."
|
||
(when exwm--connection
|
||
(let ((original exwm-input--global-prefix-keys))
|
||
(setq exwm-input--global-prefix-keys nil)
|
||
(dolist (i exwm-input--global-keys)
|
||
(cl-pushnew (elt i 0) exwm-input--global-prefix-keys))
|
||
(unless (equal original exwm-input--global-prefix-keys)
|
||
(apply #'exwm-input--grab-global-prefix-keys
|
||
(slot-value (xcb:+request-unchecked+reply exwm--connection
|
||
(make-instance 'xcb:QueryTree
|
||
:window exwm--root))
|
||
'children))))))
|
||
|
||
(defun exwm-input--grab-global-prefix-keys (&rest xwins)
|
||
(let ((req (make-instance 'xcb:GrabKey
|
||
:owner-events 0
|
||
:grab-window nil
|
||
:modifiers nil
|
||
:key nil
|
||
:pointer-mode xcb:GrabMode:Async
|
||
:keyboard-mode xcb:GrabMode:Async))
|
||
keysym keycode)
|
||
(dolist (k exwm-input--global-prefix-keys)
|
||
(setq keysym (xcb:keysyms:event->keysym exwm--connection k)
|
||
keycode (xcb:keysyms:keysym->keycode exwm--connection
|
||
(car keysym)))
|
||
(setf (slot-value req 'modifiers) (cdr keysym)
|
||
(slot-value req 'key) keycode)
|
||
(dolist (xwin xwins)
|
||
(setf (slot-value req 'grab-window) xwin)
|
||
(xcb:+request exwm--connection req)
|
||
;; Also grab this key with num-lock mask set.
|
||
(when (/= 0 xcb:keysyms:num-lock-mask)
|
||
(setf (slot-value req 'modifiers)
|
||
(logior (cdr keysym) xcb:keysyms:num-lock-mask))
|
||
(xcb:+request exwm--connection req))))
|
||
(xcb:flush exwm--connection)))
|
||
|
||
(defun exwm-input--set-key (key command)
|
||
(global-set-key key command)
|
||
(cl-pushnew key exwm-input--global-keys))
|
||
|
||
(defcustom exwm-input-global-keys nil
|
||
"Global keys.
|
||
|
||
It is an alist of the form (key . command), meaning giving KEY (a key
|
||
sequence) a global binding as COMMAND.
|
||
|
||
Notes:
|
||
* Setting the value directly (rather than customizing it) after EXWM
|
||
finishes initialization has no effect."
|
||
:type '(alist :key-type key-sequence :value-type function)
|
||
:set (lambda (symbol value)
|
||
(when (boundp symbol)
|
||
(dolist (i (symbol-value symbol))
|
||
(global-unset-key (car i))))
|
||
(set symbol value)
|
||
(setq exwm-input--global-keys nil)
|
||
(dolist (i value)
|
||
(exwm-input--set-key (car i) (cdr i)))
|
||
(when exwm--connection
|
||
(exwm-input--update-global-prefix-keys))))
|
||
|
||
;;;###autoload
|
||
(defun exwm-input-set-key (key command)
|
||
"Set a global key binding.
|
||
|
||
The new key binding only takes effect in real time when this command is
|
||
called interactively, and is lost when this session ends unless it's
|
||
specifically saved in the Customize interface for `exwm-input-global-keys'.
|
||
|
||
In configuration you should customize or set `exwm-input-global-keys'
|
||
instead."
|
||
(interactive "KSet key globally: \nCSet key %s to command: ")
|
||
(setq exwm-input-global-keys (append exwm-input-global-keys
|
||
(list (cons key command))))
|
||
(exwm-input--set-key key command)
|
||
(when (called-interactively-p 'any)
|
||
(exwm-input--update-global-prefix-keys)))
|
||
|
||
;; Putting (t . EVENT) into `unread-command-events' does not really work
|
||
;; as documented for Emacs < 27.
|
||
(eval-and-compile
|
||
(if (< emacs-major-version 27)
|
||
(defsubst exwm-input--unread-event (event)
|
||
(setq unread-command-events
|
||
(append unread-command-events (list event))))
|
||
(defsubst exwm-input--unread-event (event)
|
||
(setq unread-command-events
|
||
(append unread-command-events `((t . ,event)))))))
|
||
|
||
(cl-defun exwm-input--translate (key)
|
||
(let (translation)
|
||
(dolist (map (list input-decode-map
|
||
local-function-key-map
|
||
key-translation-map))
|
||
(setq translation (lookup-key map key))
|
||
(if (functionp translation)
|
||
(cl-return-from exwm-input--translate (funcall translation nil))
|
||
(when (vectorp translation)
|
||
(cl-return-from exwm-input--translate translation)))))
|
||
key)
|
||
|
||
(defun exwm-input--cache-event (event)
|
||
"Cache EVENT."
|
||
(setq exwm-input--line-mode-cache
|
||
(vconcat exwm-input--line-mode-cache (vector event)))
|
||
;; Attempt to translate this key sequence.
|
||
(setq exwm-input--line-mode-cache
|
||
(exwm-input--translate exwm-input--line-mode-cache))
|
||
;; When the key sequence is complete.
|
||
(unless (keymapp (key-binding exwm-input--line-mode-cache))
|
||
(setq exwm-input--line-mode-cache nil)
|
||
(when exwm-input--temp-line-mode
|
||
(setq exwm-input--temp-line-mode nil)
|
||
(exwm-input--release-keyboard)))
|
||
(exwm-input--unread-event event))
|
||
|
||
(defun exwm-input--on-KeyPress-line-mode (key-press raw-data)
|
||
"Parse X KeyPress event to Emacs key event and then feed the command loop."
|
||
(with-slots (detail state) key-press
|
||
(let ((keysym (xcb:keysyms:keycode->keysym exwm--connection detail state))
|
||
event mode)
|
||
(when (and (/= 0 (car keysym))
|
||
(setq event (xcb:keysyms:keysym->event
|
||
exwm--connection (car keysym)
|
||
(logand state (lognot (cdr keysym)))))
|
||
(or exwm-input-line-mode-passthrough
|
||
exwm-input--during-command
|
||
;; Forward the event when there is an incomplete key
|
||
;; sequence or when the minibuffer is active.
|
||
exwm-input--line-mode-cache
|
||
(eq (active-minibuffer-window) (selected-window))
|
||
;;
|
||
(memq event exwm-input--global-prefix-keys)
|
||
(memq event exwm-input-prefix-keys)
|
||
(assq event (cdr exwm-mode-map))
|
||
(gethash event exwm-input--simulation-keys)))
|
||
(setq mode xcb:Allow:AsyncKeyboard)
|
||
(exwm-input--cache-event event))
|
||
(unless mode
|
||
(if (= 0 (logand #x6000 state)) ;Check the 13~14 bits.
|
||
;; Not an XKB state; just replay it.
|
||
(setq mode xcb:Allow:ReplayKeyboard)
|
||
;; An XKB state; sent it with SendEvent.
|
||
;; FIXME: Can this also be replayed?
|
||
;; FIXME: KeyRelease events are lost.
|
||
(setq mode xcb:Allow:AsyncKeyboard)
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:SendEvent
|
||
:propagate 0
|
||
:destination (slot-value key-press 'event)
|
||
:event-mask xcb:EventMask:NoEvent
|
||
:event raw-data)))
|
||
;; Make Emacs aware of this event when defining keyboard macros.
|
||
(when (and defining-kbd-macro event)
|
||
(set-transient-map '(keymap (t . (lambda () (interactive)))))
|
||
(exwm-input--unread-event event)))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:AllowEvents
|
||
:mode mode
|
||
:time xcb:Time:CurrentTime))
|
||
(xcb:flush exwm--connection))))
|
||
|
||
(defun exwm-input--on-KeyPress-char-mode (key-press &optional _raw-data)
|
||
"Handle KeyPress event in char-mode."
|
||
(with-slots (detail state) key-press
|
||
(let ((keysym (xcb:keysyms:keycode->keysym exwm--connection detail state))
|
||
event)
|
||
(when (and (/= 0 (car keysym))
|
||
(setq event (xcb:keysyms:keysym->event
|
||
exwm--connection (car keysym)
|
||
(logand state (lognot (cdr keysym))))))
|
||
(if (not (eq major-mode 'exwm-mode))
|
||
(exwm-input--unread-event event)
|
||
;; Grab keyboard temporarily.
|
||
(setq exwm-input--temp-line-mode t)
|
||
(exwm-input--grab-keyboard)
|
||
(exwm-input--cache-event event)))))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:AllowEvents
|
||
:mode xcb:Allow:AsyncKeyboard
|
||
:time xcb:Time:CurrentTime))
|
||
(xcb:flush exwm--connection))
|
||
|
||
(defun exwm-input--update-mode-line (id)
|
||
"Update the propertized `mode-line-process' for window ID."
|
||
(let (help-echo cmd mode)
|
||
(cl-case exwm--on-KeyPress
|
||
((exwm-input--on-KeyPress-line-mode)
|
||
(setq mode "line"
|
||
help-echo "mouse-1: Switch to char-mode"
|
||
cmd `(lambda ()
|
||
(interactive)
|
||
(exwm-input-release-keyboard ,id))))
|
||
((exwm-input--on-KeyPress-char-mode)
|
||
(setq mode "char"
|
||
help-echo "mouse-1: Switch to line-mode"
|
||
cmd `(lambda ()
|
||
(interactive)
|
||
(exwm-input-grab-keyboard ,id)))))
|
||
(with-current-buffer (exwm--id->buffer id)
|
||
(setq mode-line-process
|
||
`(": "
|
||
(:propertize ,mode
|
||
help-echo ,help-echo
|
||
mouse-face mode-line-highlight
|
||
local-map
|
||
(keymap
|
||
(mode-line
|
||
keymap
|
||
(down-mouse-1 . ,cmd)))))))))
|
||
|
||
(defun exwm-input--grab-keyboard (&optional id)
|
||
"Grab all key events on window ID."
|
||
(unless id (setq id (exwm--buffer->id (window-buffer))))
|
||
(when id
|
||
(when (xcb:+request-checked+request-check exwm--connection
|
||
(make-instance 'xcb:GrabKey
|
||
:owner-events 0
|
||
:grab-window id
|
||
:modifiers xcb:ModMask:Any
|
||
:key xcb:Grab:Any
|
||
:pointer-mode xcb:GrabMode:Async
|
||
:keyboard-mode xcb:GrabMode:Sync))
|
||
(exwm--log "Failed to grab keyboard for #x%x" id))
|
||
(with-current-buffer (exwm--id->buffer id)
|
||
(setq exwm--on-KeyPress #'exwm-input--on-KeyPress-line-mode))))
|
||
|
||
(defun exwm-input--release-keyboard (&optional id)
|
||
"Ungrab all key events on window ID."
|
||
(unless id (setq id (exwm--buffer->id (window-buffer))))
|
||
(when id
|
||
(when (xcb:+request-checked+request-check exwm--connection
|
||
(make-instance 'xcb:UngrabKey
|
||
:key xcb:Grab:Any
|
||
:grab-window id
|
||
:modifiers xcb:ModMask:Any))
|
||
(exwm--log "Failed to release keyboard for #x%x" id))
|
||
(exwm-input--grab-global-prefix-keys id)
|
||
(with-current-buffer (exwm--id->buffer id)
|
||
(setq exwm--on-KeyPress #'exwm-input--on-KeyPress-char-mode))))
|
||
|
||
;;;###autoload
|
||
(defun exwm-input-grab-keyboard (&optional id)
|
||
"Switch to line-mode."
|
||
(interactive (list (when (derived-mode-p 'exwm-mode)
|
||
(exwm--buffer->id (window-buffer)))))
|
||
(when id
|
||
(with-current-buffer (exwm--id->buffer id)
|
||
(exwm-input--grab-keyboard id)
|
||
(setq exwm--keyboard-grabbed t)
|
||
(exwm-input--update-mode-line id)
|
||
(force-mode-line-update))))
|
||
|
||
;;;###autoload
|
||
(defun exwm-input-release-keyboard (&optional id)
|
||
"Switch to char-mode."
|
||
(interactive (list (when (derived-mode-p 'exwm-mode)
|
||
(exwm--buffer->id (window-buffer)))))
|
||
(when id
|
||
(with-current-buffer (exwm--id->buffer id)
|
||
(exwm-input--release-keyboard id)
|
||
(setq exwm--keyboard-grabbed nil)
|
||
(exwm-input--update-mode-line id)
|
||
(force-mode-line-update))))
|
||
|
||
;;;###autoload
|
||
(defun exwm-input-toggle-keyboard (&optional id)
|
||
"Toggle between 'line-mode' and 'char-mode'."
|
||
(interactive (list (when (derived-mode-p 'exwm-mode)
|
||
(exwm--buffer->id (window-buffer)))))
|
||
(when id
|
||
(with-current-buffer (exwm--id->buffer id)
|
||
(if exwm--keyboard-grabbed
|
||
(exwm-input-release-keyboard id)
|
||
(exwm-reset)))))
|
||
|
||
(defun exwm-input--fake-key (event)
|
||
"Fake a key event equivalent to Emacs event EVENT."
|
||
(let* ((keysym (xcb:keysyms:event->keysym exwm--connection event))
|
||
keycode id)
|
||
(when (= 0 (car keysym))
|
||
(user-error "[EXWM] Invalid key: %s" (single-key-description event)))
|
||
(setq keycode (xcb:keysyms:keysym->keycode exwm--connection
|
||
(car keysym)))
|
||
(when (/= 0 keycode)
|
||
(setq id (exwm--buffer->id (window-buffer (selected-window))))
|
||
(dolist (class '(xcb:KeyPress xcb:KeyRelease))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:SendEvent
|
||
:propagate 0 :destination id
|
||
:event-mask xcb:EventMask:NoEvent
|
||
:event (xcb:marshal
|
||
(make-instance class
|
||
:detail keycode
|
||
:time xcb:Time:CurrentTime
|
||
:root exwm--root :event id
|
||
:child 0
|
||
:root-x 0 :root-y 0
|
||
:event-x 0 :event-y 0
|
||
:state (cdr keysym)
|
||
:same-screen 1)
|
||
exwm--connection)))))
|
||
(xcb:flush exwm--connection)))
|
||
|
||
;;;###autoload
|
||
(cl-defun exwm-input-send-next-key (times)
|
||
"Send next key to client window.
|
||
|
||
EXWM will prompt for the key to send. This command can be prefixed to send
|
||
multiple keys."
|
||
(interactive "p")
|
||
(unless (derived-mode-p 'exwm-mode)
|
||
(cl-return-from 'exwm-input-send-next-key))
|
||
(when (> times 12) (setq times 12))
|
||
(let (key keys)
|
||
(dotimes (i times)
|
||
;; Skip events not from keyboard
|
||
(let ((exwm-input-line-mode-passthrough t))
|
||
(catch 'break
|
||
(while t
|
||
(setq key (read-key (format "Send key: %s (%d/%d)"
|
||
(key-description keys)
|
||
(1+ i) times)))
|
||
(unless (listp key) (throw 'break nil)))))
|
||
(setq keys (vconcat keys (vector key)))
|
||
(exwm-input--fake-key key))))
|
||
|
||
(defun exwm-input--set-simulation-keys (simulation-keys &optional no-refresh)
|
||
"Set simulation keys."
|
||
(unless no-refresh
|
||
;; Clear keymaps and the hash table.
|
||
(when (hash-table-p exwm-input--simulation-keys)
|
||
(maphash (lambda (key _value)
|
||
(when (sequencep key)
|
||
(if exwm-input--local-simulation-keys
|
||
(local-unset-key key)
|
||
(define-key exwm-mode-map key nil))))
|
||
exwm-input--simulation-keys)
|
||
(clrhash exwm-input--simulation-keys))
|
||
;; Update the hash table.
|
||
(setq exwm-input--simulation-keys (make-hash-table :test #'equal)))
|
||
(dolist (i simulation-keys)
|
||
(let ((original (vconcat (car i)))
|
||
(simulated (cdr i)))
|
||
(setq simulated (if (sequencep simulated)
|
||
(append simulated nil)
|
||
(list simulated)))
|
||
;; The key stored is a key sequence (vector).
|
||
;; The value stored is a list of key events.
|
||
(puthash original simulated exwm-input--simulation-keys)
|
||
;; Also mark the prefix key as used.
|
||
(puthash (aref original 0) t exwm-input--simulation-keys)))
|
||
;; Update keymaps.
|
||
(maphash (lambda (key _value)
|
||
(when (sequencep key)
|
||
(if exwm-input--local-simulation-keys
|
||
(local-set-key key #'exwm-input-send-simulation-key)
|
||
(define-key exwm-mode-map key
|
||
#'exwm-input-send-simulation-key))))
|
||
exwm-input--simulation-keys))
|
||
|
||
(defun exwm-input-set-simulation-keys (simulation-keys)
|
||
"Please customize or set `exwm-input-simulation-keys' instead."
|
||
(declare (obsolete nil "26"))
|
||
(exwm-input--set-simulation-keys simulation-keys))
|
||
|
||
(defcustom exwm-input-simulation-keys nil
|
||
"Simulation keys.
|
||
|
||
It is an alist of the form (original-key . simulated-key), where both
|
||
original-key and simulated-key are key sequences. Original-key is what you
|
||
type to an X window in line-mode which then gets translated to simulated-key
|
||
by EXWM and forwarded to the X window.
|
||
|
||
Notes:
|
||
* Setting the value directly (rather than customizing it) after EXWM
|
||
finishes initialization has no effect.
|
||
* Original-keys consist of multiple key events are only supported in Emacs
|
||
27 and later.
|
||
* A minority of applications do not accept simulated keys by default. It's
|
||
required to customize them to accept events sent by SendEvent.
|
||
* The predefined examples in the Customize interface are not guaranteed to
|
||
work for all applications. This can be tweaked on a per application basis
|
||
with `exwm-input-set-local-simulation-keys'."
|
||
:type '(alist :key-type (choice (key-sequence :tag "Original"))
|
||
:value-type (choice (key-sequence :tag "Move left" [left])
|
||
(key-sequence :tag "Move right" [right])
|
||
(key-sequence :tag "Move up" [up])
|
||
(key-sequence :tag "Move down" [down])
|
||
(key-sequence :tag "Move to BOL" [home])
|
||
(key-sequence :tag "Move to EOL" [end])
|
||
(key-sequence :tag "Page up" [prior])
|
||
(key-sequence :tag "Page down" [next])
|
||
(key-sequence :tag "Copy" [C-c])
|
||
(key-sequence :tag "Paste" [C-v])
|
||
(key-sequence :tag "Delete" [delete])
|
||
(key-sequence :tag "Delete to EOL"
|
||
[S-end delete])
|
||
(key-sequence :tag "User-defined")))
|
||
:set (lambda (symbol value)
|
||
(set symbol value)
|
||
(exwm-input--set-simulation-keys value)))
|
||
|
||
(cl-defun exwm-input--read-keys (prompt stop-key)
|
||
(let ((cursor-in-echo-area t)
|
||
keys key)
|
||
(while (not (eq key stop-key))
|
||
(setq key (read-key (format "%s (terminate with %s): %s"
|
||
prompt
|
||
(key-description (vector stop-key))
|
||
(key-description keys)))
|
||
keys (vconcat keys (vector key))))
|
||
(substring keys 0 -1)))
|
||
|
||
;;;###autoload
|
||
(defun exwm-input-set-simulation-key (original-key simulated-key)
|
||
"Set a simulation key.
|
||
|
||
The simulation key takes effect in real time, but is lost when this session
|
||
ends unless it's specifically saved in the Customize interface for
|
||
`exwm-input-simulation-keys'."
|
||
(interactive
|
||
(let (original simulated)
|
||
(setq original (exwm-input--read-keys "Original keys" ?\C-g))
|
||
(when original
|
||
(setq simulated (exwm-input--read-keys
|
||
(format "Simulate %s as" (key-description original))
|
||
?\C-g)))
|
||
(list original simulated)))
|
||
(when (and original-key simulated-key)
|
||
(let ((entry `((,original-key . ,simulated-key))))
|
||
(setq exwm-input-simulation-keys (append exwm-input-simulation-keys
|
||
entry))
|
||
(exwm-input--set-simulation-keys entry t))))
|
||
|
||
(defun exwm-input--unset-simulation-keys ()
|
||
"Clear simulation keys and key bindings defined."
|
||
(when (hash-table-p exwm-input--simulation-keys)
|
||
(maphash (lambda (key _value)
|
||
(when (sequencep key)
|
||
(define-key exwm-mode-map key nil)))
|
||
exwm-input--simulation-keys)
|
||
(clrhash exwm-input--simulation-keys)))
|
||
|
||
(defun exwm-input-set-local-simulation-keys (simulation-keys)
|
||
"Set buffer-local simulation keys.
|
||
|
||
SIMULATION-KEYS is an alist of the form (original-key . simulated-key),
|
||
where both ORIGINAL-KEY and SIMULATED-KEY are key sequences."
|
||
(make-local-variable 'exwm-input--simulation-keys)
|
||
(use-local-map (copy-keymap exwm-mode-map))
|
||
(let ((exwm-input--local-simulation-keys t))
|
||
(exwm-input--set-simulation-keys simulation-keys)))
|
||
|
||
;;;###autoload
|
||
(cl-defun exwm-input-send-simulation-key (times)
|
||
"Fake a key event according to the last input key sequence."
|
||
(interactive "p")
|
||
(unless (derived-mode-p 'exwm-mode)
|
||
(cl-return-from 'exwm-input-send-simulation-key))
|
||
(let ((keys (gethash (this-single-command-keys)
|
||
exwm-input--simulation-keys)))
|
||
(dotimes (_ times)
|
||
(dolist (key keys)
|
||
(exwm-input--fake-key key)))))
|
||
|
||
(defun exwm-input--on-pre-command ()
|
||
"Run in `pre-command-hook'."
|
||
(setq exwm-input--during-command t))
|
||
|
||
(defun exwm-input--on-post-command ()
|
||
"Run in `post-command-hook'."
|
||
(setq exwm-input--during-command nil))
|
||
|
||
(defun exwm-input--init ()
|
||
"Initialize the keyboard module."
|
||
;; Refresh keyboard mapping
|
||
(xcb:keysyms:init exwm--connection #'exwm-input--on-keysyms-update)
|
||
;; Create the X window and intern the atom used to fetch timestamp.
|
||
(setq exwm-input--timestamp-window (xcb:generate-id exwm--connection))
|
||
(xcb:+request exwm--connection
|
||
(make-instance 'xcb:CreateWindow
|
||
:depth 0
|
||
:wid exwm-input--timestamp-window
|
||
:parent exwm--root
|
||
:x -1
|
||
:y -1
|
||
:width 1
|
||
:height 1
|
||
:border-width 0
|
||
:class xcb:WindowClass:CopyFromParent
|
||
:visual 0
|
||
:value-mask xcb:CW:EventMask
|
||
:event-mask xcb:EventMask:PropertyChange))
|
||
(let ((atom "_TIME"))
|
||
(setq exwm-input--timestamp-atom
|
||
(slot-value (xcb:+request-unchecked+reply exwm--connection
|
||
(make-instance 'xcb:InternAtom
|
||
:only-if-exists 0
|
||
:name-len (length atom)
|
||
:name atom))
|
||
'atom)))
|
||
;; Initialize global keys.
|
||
(dolist (i exwm-input-global-keys)
|
||
(exwm-input--set-key (car i) (cdr i)))
|
||
;; Initialize simulation keys.
|
||
(when exwm-input-simulation-keys
|
||
(exwm-input--set-simulation-keys exwm-input-simulation-keys))
|
||
;; Attach event listeners
|
||
(xcb:+event exwm--connection 'xcb:PropertyNotify
|
||
#'exwm-input--on-PropertyNotify)
|
||
(xcb:+event exwm--connection 'xcb:CreateNotify #'exwm-input--on-CreateNotify)
|
||
(xcb:+event exwm--connection 'xcb:KeyPress #'exwm-input--on-KeyPress)
|
||
(xcb:+event exwm--connection 'xcb:ButtonPress #'exwm-input--on-ButtonPress)
|
||
(xcb:+event exwm--connection 'xcb:ButtonRelease
|
||
#'exwm-floating--stop-moveresize)
|
||
(xcb:+event exwm--connection 'xcb:MotionNotify
|
||
#'exwm-floating--do-moveresize)
|
||
(when mouse-autoselect-window
|
||
(xcb:+event exwm--connection 'xcb:EnterNotify
|
||
#'exwm-input--on-EnterNotify))
|
||
;; The input focus should be set on the frame when minibuffer is active.
|
||
(add-hook 'minibuffer-setup-hook #'exwm-input--on-minibuffer-setup)
|
||
;; Control `exwm-input--during-command'
|
||
(add-hook 'pre-command-hook #'exwm-input--on-pre-command)
|
||
(add-hook 'post-command-hook #'exwm-input--on-post-command)
|
||
;; Update focus when buffer list updates
|
||
(add-hook 'buffer-list-update-hook #'exwm-input--on-buffer-list-update))
|
||
|
||
(defun exwm-input--post-init ()
|
||
"The second stage in the initialization of the input module."
|
||
(exwm-input--update-global-prefix-keys))
|
||
|
||
(defun exwm-input--exit ()
|
||
"Exit the input module."
|
||
(exwm-input--unset-simulation-keys)
|
||
(remove-hook 'pre-command-hook #'exwm-input--on-pre-command)
|
||
(remove-hook 'post-command-hook #'exwm-input--on-post-command)
|
||
(remove-hook 'buffer-list-update-hook #'exwm-input--on-buffer-list-update)
|
||
(when exwm-input--update-focus-defer-timer
|
||
(cancel-timer exwm-input--update-focus-defer-timer))
|
||
(when exwm-input--update-focus-timer
|
||
(cancel-timer exwm-input--update-focus-timer)))
|
||
|
||
|
||
|
||
(provide 'exwm-input)
|
||
|
||
;;; exwm-input.el ends here
|