2022-06-28 21:57:26 +02:00
|
|
|
;;; pip-frame.el --- Display and manage a PIP frame -*- lexical-binding: t -*-
|
2022-05-06 23:13:52 +02:00
|
|
|
|
|
|
|
;; Copyright (C) 2022 Milan Zamazal <pdm@zamazal.org>
|
|
|
|
|
2022-06-28 21:57:26 +02:00
|
|
|
;; Author: Milan Zamazal <pdm@zamazal.org>
|
2022-07-04 19:01:55 +02:00
|
|
|
;; Version: 1
|
2022-06-29 21:22:18 +02:00
|
|
|
;; Package-Requires: ((emacs "25.1"))
|
2022-06-28 21:57:26 +02:00
|
|
|
;; Keywords: frames
|
|
|
|
;; URL: https://git.zamazal.org/pdm/pip-frame
|
|
|
|
|
2022-05-06 23:13:52 +02:00
|
|
|
;; COPYRIGHT NOTICE
|
|
|
|
;;
|
|
|
|
;; This program 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.
|
|
|
|
;;
|
|
|
|
;; This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
2022-06-28 21:41:13 +02:00
|
|
|
;;; Commentary:
|
|
|
|
;;
|
2022-05-06 23:13:52 +02:00
|
|
|
;; Display a floating Emacs frame with selected buffers.
|
|
|
|
;; Similar to PIP on screens. Probably most useful in EXWM.
|
|
|
|
;;
|
|
|
|
;; Use `M-x pip-frame-add-buffer' to create the frame and add
|
|
|
|
;; additional buffers to it and remove the buffers with
|
|
|
|
;; `M-x pip-frame-remove-buffer' or close the whole frame with
|
|
|
|
;; `M-x pip-frame-delete-frame'.
|
|
|
|
|
2022-07-04 18:59:25 +02:00
|
|
|
;;; Code:
|
|
|
|
|
2022-07-05 13:23:23 +02:00
|
|
|
(require 'cl-lib)
|
|
|
|
|
2022-05-06 23:13:52 +02:00
|
|
|
(defgroup pip-frame ()
|
2022-06-28 22:06:47 +02:00
|
|
|
"Display PIP frame."
|
|
|
|
:group 'frames)
|
2022-05-06 23:13:52 +02:00
|
|
|
|
|
|
|
(defcustom pip-frame-scale 4
|
|
|
|
"How many times to shrink the PIP frame relative to the display size."
|
|
|
|
:type 'number
|
|
|
|
:group 'pip-frame)
|
|
|
|
|
|
|
|
(defcustom pip-frame-font-scale 2
|
|
|
|
"How many times to reduce the font size in the PIP frame."
|
|
|
|
:type 'number
|
|
|
|
:group 'pip-frame)
|
|
|
|
|
|
|
|
(defcustom pip-frame-move-step 0.1
|
|
|
|
"Movement step relative to the display size in the given direction.
|
|
|
|
|
|
|
|
Usually, the value should be larger than 0 and much smaller than 1."
|
|
|
|
:type 'number
|
|
|
|
:group 'pip-frame)
|
|
|
|
|
|
|
|
(defcustom pip-frame-parameters
|
|
|
|
'((left . 0.9)
|
2022-06-15 19:43:30 +02:00
|
|
|
(top . 0.9)
|
2022-06-29 19:26:01 +02:00
|
|
|
(tab-bar-lines . 0)
|
2022-06-15 19:43:30 +02:00
|
|
|
(minibuffer . nil))
|
2022-05-06 23:13:52 +02:00
|
|
|
"Alist of frame parameters to use for the PIP frame.
|
|
|
|
The frame size is determined automatically using `pip-frame-scale'
|
|
|
|
custom option but it can be overriden here."
|
|
|
|
:type '(alist :key-type symbol :value-type sexp)
|
|
|
|
:group 'pip-frame)
|
|
|
|
|
|
|
|
(defcustom pip-frame-face-attributes '()
|
|
|
|
"Alist of face attributes to modify `default' face in the PIP frame."
|
|
|
|
:type '(alist :key-type symbol :value-type sexp)
|
|
|
|
:group 'pip-frame)
|
|
|
|
|
2022-05-16 07:59:32 +02:00
|
|
|
(defcustom pip-frame-temporary-buffer-seconds 10
|
|
|
|
"Number of seconds to keep a buffer displayed temporarily by default."
|
|
|
|
:type 'number
|
|
|
|
:group 'pip-frame)
|
|
|
|
|
2022-05-06 23:13:52 +02:00
|
|
|
(defvar pip-frame--name "PIP-frame")
|
|
|
|
|
|
|
|
(defun pip-frame--get-frame (&optional no-error)
|
|
|
|
(let ((frame (cl-find pip-frame--name (frame-list)
|
2022-06-28 21:41:32 +02:00
|
|
|
:key (lambda (f) (frame-parameter f 'name)))))
|
2022-05-06 23:13:52 +02:00
|
|
|
(or frame
|
|
|
|
(unless no-error
|
|
|
|
(error "No PIP frame")))))
|
|
|
|
|
2022-05-16 07:21:41 +02:00
|
|
|
(defun pip-frame--make-frame (buffer)
|
2022-05-06 23:13:52 +02:00
|
|
|
(let ((frame (make-frame `((name . ,pip-frame--name)
|
|
|
|
(unsplittable . t)
|
|
|
|
,@pip-frame-parameters
|
|
|
|
(width . ,(/ 1.0 pip-frame-scale))
|
|
|
|
(height . ,(/ 1.0 pip-frame-scale)))))
|
|
|
|
(frame-inhibit-implied-resize t)
|
|
|
|
(face-height (round (/ (face-attribute 'default :height) pip-frame-font-scale))))
|
|
|
|
(set-face-attribute 'default frame :height face-height)
|
2022-06-28 21:44:26 +02:00
|
|
|
(dolist (p pip-frame-face-attributes)
|
|
|
|
(set-face-attribute 'default frame (car p) (cdr p)))
|
2022-05-16 07:21:41 +02:00
|
|
|
(set-window-buffer (car (window-list frame)) buffer)
|
2022-05-06 23:13:52 +02:00
|
|
|
frame))
|
|
|
|
|
|
|
|
(defun pip-frame-delete-frame ()
|
2022-05-16 07:10:16 +02:00
|
|
|
"Delete the PIP frame."
|
2022-05-06 23:13:52 +02:00
|
|
|
(interactive)
|
|
|
|
(delete-frame (pip-frame--get-frame)))
|
|
|
|
|
|
|
|
(defun pip-frame--buffers ()
|
|
|
|
(mapcar #'window-buffer (window-list (pip-frame--get-frame))))
|
|
|
|
|
2022-05-16 07:59:32 +02:00
|
|
|
(defun pip-frame--add-additional-buffer (buffer temporary)
|
|
|
|
(let ((windows (window-list (pip-frame--get-frame))))
|
|
|
|
(unless (and temporary
|
|
|
|
(cl-find buffer windows :key #'window-buffer :test #'eq))
|
2022-06-28 21:41:32 +02:00
|
|
|
(let* ((sizes (mapcar (lambda (w)
|
|
|
|
(let ((width (window-body-width w t))
|
|
|
|
(height (window-body-height w t)))
|
|
|
|
(cons (+ (* width width) (* height height))
|
|
|
|
w)))
|
2022-05-16 07:59:32 +02:00
|
|
|
windows))
|
|
|
|
(largest (cdr (cl-first (cl-sort sizes #'> :key #'car))))
|
|
|
|
(side (if (> (window-body-width largest t)
|
|
|
|
(* 2 (window-body-height largest t)))
|
|
|
|
'right
|
|
|
|
'below))
|
|
|
|
(new-window (split-window largest nil side)))
|
|
|
|
(set-window-buffer new-window buffer)))))
|
|
|
|
|
|
|
|
(defvar pip-frame--buffer-timers '())
|
|
|
|
|
|
|
|
(defun pip-frame--make-buffer-temporary (buffer seconds)
|
|
|
|
(when (eq seconds t)
|
|
|
|
(setq seconds pip-frame-temporary-buffer-seconds))
|
|
|
|
(let ((timer (run-with-timer seconds nil #'pip-frame-remove-buffer buffer)))
|
|
|
|
(setq pip-frame--buffer-timers (cons (cons buffer timer)
|
|
|
|
pip-frame--buffer-timers))))
|
|
|
|
|
|
|
|
(defun pip-frame--delete-buffer-timer (buffer)
|
|
|
|
(let ((timer (alist-get buffer pip-frame--buffer-timers)))
|
|
|
|
(when timer
|
|
|
|
(cancel-timer timer)
|
|
|
|
(setq pip-frame--buffer-timers
|
|
|
|
(assq-delete-all buffer pip-frame--buffer-timers)))))
|
|
|
|
|
2022-05-06 23:13:52 +02:00
|
|
|
;;;###autoload
|
2022-05-16 07:59:32 +02:00
|
|
|
(defun pip-frame-add-buffer (&optional buffer-or-name temporary)
|
2022-05-16 07:21:41 +02:00
|
|
|
"Add a buffer to the PIP frame.
|
2022-05-16 07:10:16 +02:00
|
|
|
If there is no PIP frame then create one.
|
2022-05-16 07:21:41 +02:00
|
|
|
If BUFFER-OR-NAME is specified, add the given buffer to the frame,
|
|
|
|
otherwise add the current buffer.
|
2022-05-16 07:59:32 +02:00
|
|
|
If TEMPORARY is given, display the buffer in the PIP frame for that
|
|
|
|
many seconds and then remove it from the frame. If t, display it for
|
|
|
|
`pip-frame-temporary-buffer-seconds'.
|
|
|
|
A buffer can be added and displayed multiple times in the frame. If
|
|
|
|
TEMPORARY is non-nil, the buffer is not displayed again if it is
|
|
|
|
already present."
|
2022-05-06 23:13:52 +02:00
|
|
|
(interactive)
|
2022-05-16 07:21:41 +02:00
|
|
|
(let ((frame (pip-frame--get-frame t))
|
|
|
|
(buffer (get-buffer (or buffer-or-name (current-buffer)))))
|
2022-05-06 23:13:52 +02:00
|
|
|
(if frame
|
2022-05-16 07:59:32 +02:00
|
|
|
(progn
|
|
|
|
(when temporary
|
|
|
|
(pip-frame--delete-buffer-timer buffer))
|
|
|
|
(pip-frame--add-additional-buffer buffer temporary))
|
|
|
|
(pip-frame--make-frame buffer))
|
|
|
|
(when temporary
|
|
|
|
(pip-frame--make-buffer-temporary buffer temporary))))
|
|
|
|
|
|
|
|
(defun pip-frame-remove-buffer (buffer-or-name)
|
|
|
|
"Remove buffer named BUFFER-OR-NAME from the PIP frame.
|
|
|
|
If it is the last buffer in the PIP frame, delete the frame.
|
|
|
|
If the buffer is not present in the PIP frame, do nothing."
|
2022-05-06 23:13:52 +02:00
|
|
|
(interactive (list (completing-read "Remove PIP buffer: "
|
|
|
|
(mapcar #'buffer-name (pip-frame--buffers))
|
|
|
|
nil t)))
|
2022-08-02 21:14:04 +02:00
|
|
|
(if-let ((frame (pip-frame--get-frame t))
|
|
|
|
(windows (window-list frame))
|
|
|
|
(buffer (get-buffer buffer-or-name))
|
|
|
|
(windows-to-delete (cl-remove buffer windows
|
|
|
|
:key #'window-buffer
|
|
|
|
:test-not #'eq)))
|
|
|
|
(if (= (length windows-to-delete) (length windows))
|
|
|
|
(pip-frame-delete-frame)
|
|
|
|
(seq-do #'delete-window windows-to-delete))))
|
2022-05-06 23:13:52 +02:00
|
|
|
|
|
|
|
(defun pip-frame--move (x y)
|
|
|
|
(let ((frame (pip-frame--get-frame)))
|
|
|
|
(set-frame-parameter frame 'left (+ (frame-parameter frame 'left) x))
|
|
|
|
(set-frame-parameter frame 'top (+ (frame-parameter frame 'top) y))))
|
|
|
|
|
|
|
|
(defun pip-frame--move-step (vertical)
|
|
|
|
(if (integerp pip-frame-move-step)
|
|
|
|
pip-frame-move-step
|
|
|
|
(let ((workarea (cdr (assoc 'workarea (cl-first (display-monitor-attributes-list))))))
|
|
|
|
(round (* pip-frame-move-step (nth (if vertical 3 2) workarea))))))
|
|
|
|
|
|
|
|
(defun pip-frame-move-left ()
|
2022-07-04 18:59:25 +02:00
|
|
|
"Move the PIP frame left."
|
2022-05-06 23:13:52 +02:00
|
|
|
(interactive)
|
|
|
|
(pip-frame--move (- (pip-frame--move-step nil)) 0))
|
|
|
|
|
|
|
|
(defun pip-frame-move-right ()
|
2022-07-04 18:59:25 +02:00
|
|
|
"Move the PIP frame right."
|
2022-05-06 23:13:52 +02:00
|
|
|
(interactive)
|
|
|
|
(pip-frame--move (pip-frame--move-step nil) 0))
|
|
|
|
|
|
|
|
(defun pip-frame-move-up ()
|
2022-07-04 18:59:25 +02:00
|
|
|
"Move the PIP frame up."
|
2022-05-06 23:13:52 +02:00
|
|
|
(interactive)
|
|
|
|
(pip-frame--move 0 (- (pip-frame--move-step t))))
|
|
|
|
|
|
|
|
(defun pip-frame-move-down ()
|
2022-07-04 18:59:25 +02:00
|
|
|
"Move the PIP frame down."
|
2022-05-06 23:13:52 +02:00
|
|
|
(interactive)
|
|
|
|
(pip-frame--move 0 (pip-frame--move-step t)))
|
|
|
|
|
|
|
|
(defvar pip-frame-move-map
|
|
|
|
(let ((map (make-sparse-keymap)))
|
|
|
|
(define-key map (kbd "<left>") 'pip-frame-move-left)
|
|
|
|
(define-key map (kbd "<right>") 'pip-frame-move-right)
|
|
|
|
(define-key map (kbd "<up>") 'pip-frame-move-up)
|
|
|
|
(define-key map (kbd "<down>") 'pip-frame-move-down)
|
|
|
|
map))
|
|
|
|
|
|
|
|
(defun pip-frame-move ()
|
2022-05-16 07:10:16 +02:00
|
|
|
"Move PIP frame interactively.
|
|
|
|
Use arrow keys to move the frame around.
|
|
|
|
Any other key stops this command and executes its own command."
|
2022-05-06 23:13:52 +02:00
|
|
|
(interactive)
|
|
|
|
(message "Use arrow keys to move the frame, any other key to quit")
|
|
|
|
(set-transient-map pip-frame-move-map t))
|
|
|
|
|
|
|
|
(provide 'pip-frame)
|
2022-06-29 21:22:32 +02:00
|
|
|
|
2022-07-06 10:10:46 +02:00
|
|
|
;; Local Variables:
|
|
|
|
;; checkdoc-force-docstrings-flag: nil
|
|
|
|
;; End:
|
|
|
|
|
2022-06-29 21:22:32 +02:00
|
|
|
;;; pip-frame.el ends here
|