1 ;;; cedit.el --- a speed reading mode
3 ;; Copyright (C) 2014 zk_phi
5 ;; This program is free software; you can redistribute it and/or modify
6 ;; it under the terms of the GNU General Public License as published by
7 ;; the Free Software Foundation; either version 2 of the License, or
8 ;; (at your option) any later version.
10 ;; This program is distributed in the hope that it will be useful,
11 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
12 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 ;; GNU General Public License for more details.
15 ;; You should have received a copy of the GNU General Public License
16 ;; along with this program; if not, write to the Free Software
17 ;; Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
20 ;; URL: http://hins11.yu-yake.com/
25 ;; Put this script into a "load-path"ed directory, and load it in your
30 ;; Then you may run spray with "M-x spray-mode". Binding some keys may
33 ;; (global-set-key (kbd "<f6>") 'spray-mode)
35 ;; For more informations, see Readme.org.
39 ;; 0.0.1 add spray-set-margins
45 ;; * customizable vars
47 (defvar spray-wpm 400 "words/min")
48 (defvar spray-height 400 "height of characters")
50 (defvar spray-mode-map
51 (let ((km (make-sparse-keymap)))
52 (define-key km (kbd "SPC") 'spray-start/stop)
53 (define-key km (kbd "h") 'spray-backward-word)
54 (define-key km (kbd "l") 'spray-forward-word)
55 (define-key km (kbd "<left>") 'spray-backward-word)
56 (define-key km (kbd "<right>") 'spray-forward-word)
58 "keymap for spray-mode buffers")
62 (make-face 'spray-base-face)
63 (set-face-attribute 'spray-base-face nil
64 :background (face-background 'default)
65 :foreground (face-foreground 'default))
67 (make-face 'spray-orp-face)
68 (set-face-attribute 'spray-orp-face nil
70 :overline (face-foreground 'default)
71 :underline (face-foreground 'default))
75 (defvar spray--margin-string "")
76 (defvar spray--base-overlay nil)
77 (defvar spray--orp-overlay nil)
78 (defvar spray--running nil)
79 (defvar spray--delay 0)
80 (defvar spray--saved-cursor-type nil)
81 (defvar spray--saved-buffer-face nil)
82 (defvar spray--saved-restriction nil)
84 ;; * utility functions
86 (defun spray-set-margins (left above)
87 "add margins before/above the spray text. each arguments can be
88 an integer or a float value."
89 (setq spray--margin-string
90 (propertize " " 'display `((space-width ,left) (height ,(1+ above))))))
95 (define-minor-mode spray-mode
98 :keymap spray-mode-map
100 (setq spray--base-overlay (make-overlay (point-min) (point-max))
101 spray--orp-overlay (make-overlay 0 0)
102 spray--saved-cursor-type cursor-type
103 spray--saved-restriction (and (buffer-narrowed-p)
104 (cons (point-min) (point-max)))
105 spray--saved-buffer-face (and (boundp 'buffer-face-mode)
107 buffer-face-mode-face))
108 (setq cursor-type nil)
109 (let ((buffer-face-mode-face `(:height ,spray-height)))
110 (buffer-face-mode 1))
111 (overlay-put spray--base-overlay 'priority 100)
112 (overlay-put spray--base-overlay 'face 'spray-base-face)
113 (overlay-put spray--orp-overlay 'priority 101)
114 (overlay-put spray--orp-overlay 'face 'spray-orp-face)
115 (add-hook 'pre-command-hook 'spray--pre-command-handler)
116 (spray-start/stop 1))
118 (setq cursor-type spray--saved-cursor-type)
119 (if spray--saved-restriction
120 (narrow-to-region (car spray--saved-restriction)
121 (cdr spray--saved-restriction))
123 (buffer-face-mode -1)
124 (if spray--saved-buffer-face
125 (let ((buffer-face-mode-face spray--saved-buffer-face))
126 (buffer-face-mode 1)))
127 (delete-overlay spray--base-overlay)
128 (delete-overlay spray--orp-overlay)
129 (remove-hook 'pre-command-hook 'spray--pre-command-handler)
130 (spray-start/stop -1))))
132 (defun spray--pre-command-handler ()
133 (unless (memq this-command
134 '(spray-forward-word spray-backward-word spray-start/stop))
137 (defun spray--word-at-point ()
138 (skip-chars-backward "^\s\t\n")
140 (len (skip-chars-forward "^\s\t\n"))
142 (orp (+ beg (cl-case len
148 (setq spray--delay (+ (if (> len 9) 1 0)
149 (if (looking-at "\n[\s\t\n]") 3 0)
150 (cl-case (char-before)
154 (move-overlay spray--orp-overlay (1- orp) orp)
155 (move-overlay spray--base-overlay beg end)
156 (overlay-put spray--base-overlay 'before-string
157 (concat spray--margin-string
158 (make-string (- 5 (- orp beg)) ?\s)))
159 (narrow-to-region beg end)))
161 (defun spray--update ()
162 (cond ((not (zerop spray--delay))
163 (setq spray--delay (1- spray--delay))
164 (when (= spray--delay 2)
165 (narrow-to-region (point) (point))))
170 (skip-chars-forward "\s\t\n")
171 (spray--word-at-point)))))
173 ;; * interactive commands
175 (defun spray-start/stop (&optional switch)
177 (cond ((and (memql switch '(nil 1))
178 (not spray--running))
180 (run-with-timer 0 (/ 60.0 spray-wpm) 'spray--update)))
181 ((memql switch '(nil -1))
182 (cancel-timer spray--running)
183 (setq spray--running nil))
187 (defun spray-forward-word ()
189 (when spray--running (spray-start/stop -1))
191 (skip-chars-forward "\s\t\n")
192 (spray--word-at-point))
194 (defun spray-backward-word ()
196 (when spray--running (spray-start/stop -1))
198 (skip-chars-backward "^\s\t\n")
199 (skip-chars-backward "\s\t\n")
200 (spray--word-at-point))
206 ;;; spray.el ends here