[bpt/emacs.git] / lisp / gnus / earcon.el

;;; earcon.el --- Sound effects for messages

;; Copyright (C) 1996, 2000, 2001, 2002, 2003, 2004,
;;   2005, 2006 Free Software Foundation, Inc.

;; Author: Steven L. Baur <steve@miranova.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 2, 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; see the file COPYING.  If not, write to the
;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
;; Boston, MA 02110-1301, USA.

;;; Commentary:
;; This file provides access to sound effects in Gnus.

;;; Code:

(eval-when-compile (require 'cl))
(require 'gnus)
(require 'gnus-audio)
(require 'gnus-art)

(defgroup earcon nil
  "Turn ** sounds ** into noise."
  :group 'gnus-visual)

(defcustom earcon-prefix "**"
  "*String denoting the start of an earcon."
  :type 'string
  :group 'earcon)

(defcustom earcon-suffix "**"
  "String denoting the end of an earcon."
  :type 'string
  :group 'earcon)

(defcustom earcon-regexp-alist
  '(("boring" 1 "Boring.au")
    ("evil[ \t]+laugh" 1 "Evil_Laugh.au")
    ("gag\\|puke" 1 "Puke.au")
    ("snicker" 1 "Snicker.au")
    ("meow" 1 "catmeow.wav")
    ("sob\\|boohoo" 1 "cry.wav")
    ("drum[ \t]*roll" 1 "drumroll.au")
    ("blast" 1 "explosion.au")
    ("flush\\|plonk!*" 1 "flush.au")
    ("kiss" 1 "kiss.wav")
    ("tee[ \t]*hee" 1 "laugh.au")
    ("shoot" 1 "shotgun.wav")
    ("yawn" 1 "snore.wav")
    ("cackle" 1 "witch.au")
    ("yell\\|roar" 1 "yell2.au")
    ("whoop-de-doo" 1 "whistle.au"))
  "*A list of regexps to map earcons to real sounds."
  :type '(repeat (list regexp
		       (integer :tag "Match")
		       (string :tag "Sound")))
  :group 'earcon)
(defvar earcon-button-marker-list nil)
(make-variable-buffer-local 'earcon-button-marker-list)

;;; FIXME!! clone of code from gnus-vis.el FIXME!!
(defun earcon-article-push-button (event)
  "Check text under the mouse pointer for a callback function.
If the text under the mouse pointer has a `earcon-callback' property,
call it with the value of the `earcon-data' text property."
  (interactive "e")
  (set-buffer (window-buffer (posn-window (event-start event))))
  (let* ((pos (posn-point (event-start event)))
	 (data (get-text-property pos 'earcon-data))
	 (fun (get-text-property pos 'earcon-callback)))
    (if fun (funcall fun data))))

(defun earcon-article-press-button ()
  "Check text at point for a callback function.
If the text at point has a `earcon-callback' property,
call it with the value of the `earcon-data' text property."
  (interactive)
  (let* ((data (get-text-property (point) 'earcon-data))
	 (fun (get-text-property (point) 'earcon-callback)))
    (if fun (funcall fun data))))

(defun earcon-article-prev-button (n)
  "Move point to N buttons backward.
If N is negative, move forward instead."
  (interactive "p")
  (earcon-article-next-button (- n)))

(defun earcon-article-next-button (n)
  "Move point to N buttons forward.
If N is negative, move backward instead."
  (interactive "p")
  (let ((function (if (< n 0) 'previous-single-property-change
		    'next-single-property-change))
	(inhibit-point-motion-hooks t)
	(backward (< n 0))
	(limit (if (< n 0) (point-min) (point-max))))
    (setq n (abs n))
    (while (and (not (= limit (point)))
		(> n 0))
      ;; Skip past the current button.
      (when (get-text-property (point) 'earcon-callback)
	(goto-char (funcall function (point) 'earcon-callback nil limit)))
      ;; Go to the next (or previous) button.
      (gnus-goto-char (funcall function (point) 'earcon-callback nil limit))
      ;; Put point at the start of the button.
      (when (and backward (not (get-text-property (point) 'earcon-callback)))
	(goto-char (funcall function (point) 'earcon-callback nil limit)))
      ;; Skip past intangible buttons.
      (when (get-text-property (point) 'intangible)
	(incf n))
      (decf n))
    (unless (zerop n)
      (gnus-message 5 "No more buttons"))
    n))

(defun earcon-article-add-button (from to fun &optional data)
  "Create a button between FROM and TO with callback FUN and data DATA."
  (and (boundp gnus-article-button-face)
       gnus-article-button-face
       (gnus-overlay-put (gnus-make-overlay from to)
			 'face gnus-article-button-face))
  (gnus-add-text-properties
   from to
   (nconc (and gnus-article-mouse-face
	       (list gnus-mouse-face-prop gnus-article-mouse-face))
	  (list 'gnus-callback fun)
	  (and data (list 'gnus-data data)))))

(defun earcon-button-entry ()
  ;; Return the first entry in `gnus-button-alist' matching this place.
  (let ((alist earcon-regexp-alist)
	(case-fold-search t)
	(entry nil))
    (while alist
      (setq entry (pop alist))
      (if (looking-at (car entry))
	  (setq alist nil)
	(setq entry nil)))
    entry))

(defun earcon-button-push (marker)
  ;; Push button starting at MARKER.
  (save-excursion
    (set-buffer gnus-article-buffer)
    (goto-char marker)
    (let* ((entry (earcon-button-entry))
	   (inhibit-point-motion-hooks t)
	   (fun 'gnus-audio-play)
	   (args (list (nth 2 entry))))
      (cond
       ((fboundp fun)
	(apply fun args))
       ((and (boundp fun)
	     (fboundp (symbol-value fun)))
	(apply (symbol-value fun) args))
       (t
	(gnus-message 1 "You must define `%S' to use this button"
		      (cons fun args)))))))

;;; FIXME!! clone of code from gnus-vis.el FIXME!!

;;;###interactive
(defun earcon-region (beg end)
  "Play Sounds in the region between point and mark."
  (interactive "r")
  (earcon-buffer (current-buffer) beg end))

;;;###interactive
(defun earcon-buffer (&optional buffer st nd)
  (interactive)
  (save-excursion
    ;; clear old markers.
    (if (boundp 'earcon-button-marker-list)
	(while earcon-button-marker-list
	  (set-marker (pop earcon-button-marker-list) nil))
      (setq earcon-button-marker-list nil))
    (and buffer (set-buffer buffer))
    (let ((buffer-read-only nil)
	  (inhibit-point-motion-hooks t)
	  (case-fold-search t)
	  (alist earcon-regexp-alist)
	  beg entry regexp)
      (goto-char (point-min))
      (setq beg (point))
      (while (setq entry (pop alist))
	(setq regexp (concat (regexp-quote earcon-prefix)
			     ".*\\("
			     (car entry)
			     "\\).*"
			     (regexp-quote earcon-suffix)))
	(goto-char beg)
	(while (re-search-forward regexp nil t)
	  (let* ((start (and entry (match-beginning 1)))
		 (end (and entry (match-end 1)))
		 (from (match-beginning 1)))
	    (earcon-article-add-button
	     start end 'earcon-button-push
	     (car (push (set-marker (make-marker) from)
			earcon-button-marker-list)))
	    (gnus-audio-play (caddr entry))))))))

;;;###autoload
(defun gnus-earcon-display ()
  "Play sounds in message buffers."
  (interactive)
  (save-excursion
    (set-buffer gnus-article-buffer)
    (goto-char (point-min))
    ;; Skip headers
    (unless (search-forward "\n\n" nil t)
      (goto-char (point-max)))
    (sit-for 0)
    (earcon-buffer (current-buffer) (point))))

;;;***

(provide 'earcon)

(run-hooks 'earcon-load-hook)

;;; arch-tag: 844dfeea-980c-4ed0-907f-a30bf139691c
;;; earcon.el ends here
Commit	Line	Data
23f87bed	1	;;; earcon.el --- Sound effects for messages
16409b0b	2
e84b4b86	3	;; Copyright (C) 1996, 2000, 2001, 2002, 2003, 2004,
88e6695f	4	;; 2005, 2006 Free Software Foundation, Inc.
eec82323 LMI	5
eec82323 LMI	6	;; Author: Steven L. Baur <steve@miranova.com>
16409b0b GM	7
	8	;; This file is part of GNU Emacs.
	9
eec82323 LMI	10	;; GNU Emacs is free software; you can redistribute it and/or modify
	11	;; it under the terms of the GNU General Public License as published by
	12	;; the Free Software Foundation; either version 2, or (at your option)
	13	;; any later version.
	14
	15	;; GNU Emacs is distributed in the hope that it will be useful,
	16	;; but WITHOUT ANY WARRANTY; without even the implied warranty of
	17	;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	18	;; GNU General Public License for more details.
	19
	20	;; You should have received a copy of the GNU General Public License
	21	;; along with GNU Emacs; see the file COPYING. If not, write to the
3a35cf56 LK	22	;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
3a35cf56 LK	23	;; Boston, MA 02110-1301, USA.
eec82323 LMI	24
	25	;;; Commentary:
	26	;; This file provides access to sound effects in Gnus.
	27
	28	;;; Code:
	29
7fb884d9	30	(eval-when-compile (require 'cl))
eec82323 LMI	31	(require 'gnus)
	32	(require 'gnus-audio)
	33	(require 'gnus-art)
eec82323 LMI	34
	35	(defgroup earcon nil
	36	"Turn sounds into noise."
	37	:group 'gnus-visual)
	38
eec82323	39	(defcustom earcon-prefix "**"
44a6ed57	40	"*String denoting the start of an earcon."
eec82323 LMI	41	:type 'string
	42	:group 'earcon)
	43
	44	(defcustom earcon-suffix "**"
	45	"String denoting the end of an earcon."
	46	:type 'string
	47	:group 'earcon)
	48
	49	(defcustom earcon-regexp-alist
	50	'(("boring" 1 "Boring.au")
	51	("evil[ \t]+laugh" 1 "Evil_Laugh.au")
	52	("gag\\\|puke" 1 "Puke.au")
	53	("snicker" 1 "Snicker.au")
23f87bed	54	("meow" 1 "catmeow.wav")
eec82323 LMI	55	("sob\\\|boohoo" 1 "cry.wav")
	56	("drum[ \t]*roll" 1 "drumroll.au")
	57	("blast" 1 "explosion.au")
	58	("flush\\\|plonk!*" 1 "flush.au")
	59	("kiss" 1 "kiss.wav")
	60	("tee[ \t]*hee" 1 "laugh.au")
	61	("shoot" 1 "shotgun.wav")
	62	("yawn" 1 "snore.wav")
	63	("cackle" 1 "witch.au")
	64	("yell\\\|roar" 1 "yell2.au")
	65	("whoop-de-doo" 1 "whistle.au"))
44a6ed57	66	"*A list of regexps to map earcons to real sounds."
eec82323 LMI	67	:type '(repeat (list regexp
	68	(integer :tag "Match")
	69	(string :tag "Sound")))
	70	:group 'earcon)
eec82323 LMI	71	(defvar earcon-button-marker-list nil)
	72	(make-variable-buffer-local 'earcon-button-marker-list)
	73
eec82323 LMI	74	;;; FIXME!! clone of code from gnus-vis.el FIXME!!
	75	(defun earcon-article-push-button (event)
	76	"Check text under the mouse pointer for a callback function.
	77	If the text under the mouse pointer has a `earcon-callback' property,
	78	call it with the value of the `earcon-data' text property."
	79	(interactive "e")
	80	(set-buffer (window-buffer (posn-window (event-start event))))
	81	(let* ((pos (posn-point (event-start event)))
23f87bed	82	(data (get-text-property pos 'earcon-data))
eec82323 LMI	83	(fun (get-text-property pos 'earcon-callback)))
	84	(if fun (funcall fun data))))
	85
	86	(defun earcon-article-press-button ()
	87	"Check text at point for a callback function.
	88	If the text at point has a `earcon-callback' property,
	89	call it with the value of the `earcon-data' text property."
	90	(interactive)
	91	(let* ((data (get-text-property (point) 'earcon-data))
	92	(fun (get-text-property (point) 'earcon-callback)))
	93	(if fun (funcall fun data))))
	94
	95	(defun earcon-article-prev-button (n)
	96	"Move point to N buttons backward.
	97	If N is negative, move forward instead."
	98	(interactive "p")
	99	(earcon-article-next-button (- n)))
	100
	101	(defun earcon-article-next-button (n)
	102	"Move point to N buttons forward.
	103	If N is negative, move backward instead."
	104	(interactive "p")
	105	(let ((function (if (< n 0) 'previous-single-property-change
	106	'next-single-property-change))
	107	(inhibit-point-motion-hooks t)
	108	(backward (< n 0))
	109	(limit (if (< n 0) (point-min) (point-max))))
	110	(setq n (abs n))
	111	(while (and (not (= limit (point)))
	112	(> n 0))
	113	;; Skip past the current button.
	114	(when (get-text-property (point) 'earcon-callback)
	115	(goto-char (funcall function (point) 'earcon-callback nil limit)))
	116	;; Go to the next (or previous) button.
	117	(gnus-goto-char (funcall function (point) 'earcon-callback nil limit))
	118	;; Put point at the start of the button.
	119	(when (and backward (not (get-text-property (point) 'earcon-callback)))
	120	(goto-char (funcall function (point) 'earcon-callback nil limit)))
	121	;; Skip past intangible buttons.
	122	(when (get-text-property (point) 'intangible)
	123	(incf n))
	124	(decf n))
	125	(unless (zerop n)
	126	(gnus-message 5 "No more buttons"))
	127	n))
	128
	129	(defun earcon-article-add-button (from to fun &optional data)
	130	"Create a button between FROM and TO with callback FUN and data DATA."
	131	(and (boundp gnus-article-button-face)
	132	gnus-article-button-face
	133	(gnus-overlay-put (gnus-make-overlay from to)
	134	'face gnus-article-button-face))
	135	(gnus-add-text-properties
	136	from to
	137	(nconc (and gnus-article-mouse-face
	138	(list gnus-mouse-face-prop gnus-article-mouse-face))
	139	(list 'gnus-callback fun)
	140	(and data (list 'gnus-data data)))))
	141
	142	(defun earcon-button-entry ()
	143	;; Return the first entry in `gnus-button-alist' matching this place.
	144	(let ((alist earcon-regexp-alist)
	145	(case-fold-search t)
	146	(entry nil))
147	(while alist
148	(setq entry (pop alist))
149	(if (looking-at (car entry))
150	(setq alist nil)
151	(setq entry nil)))
152	entry))
153
eec82323 LMI	154	(defun earcon-button-push (marker)
	155	;; Push button starting at MARKER.
	156	(save-excursion
	157	(set-buffer gnus-article-buffer)
	158	(goto-char marker)
	159	(let* ((entry (earcon-button-entry))
	160	(inhibit-point-motion-hooks t)
	161	(fun 'gnus-audio-play)
	162	(args (list (nth 2 entry))))
	163	(cond
	164	((fboundp fun)
	165	(apply fun args))
	166	((and (boundp fun)
	167	(fboundp (symbol-value fun)))
	168	(apply (symbol-value fun) args))
	169	(t
	170	(gnus-message 1 "You must define `%S' to use this button"
	171	(cons fun args)))))))
	172
	173	;;; FIXME!! clone of code from gnus-vis.el FIXME!!
	174
	175	;;;###interactive
	176	(defun earcon-region (beg end)
	177	"Play Sounds in the region between point and mark."
	178	(interactive "r")
	179	(earcon-buffer (current-buffer) beg end))
	180
	181	;;;###interactive
	182	(defun earcon-buffer (&optional buffer st nd)
	183	(interactive)
	184	(save-excursion
	185	;; clear old markers.
	186	(if (boundp 'earcon-button-marker-list)
	187	(while earcon-button-marker-list
	188	(set-marker (pop earcon-button-marker-list) nil))
	189	(setq earcon-button-marker-list nil))
	190	(and buffer (set-buffer buffer))
	191	(let ((buffer-read-only nil)
	192	(inhibit-point-motion-hooks t)
	193	(case-fold-search t)
	194	(alist earcon-regexp-alist)
	195	beg entry regexp)
	196	(goto-char (point-min))
	197	(setq beg (point))
	198	(while (setq entry (pop alist))
	199	(setq regexp (concat (regexp-quote earcon-prefix)
	200	".*\\("
	201	(car entry)
	202	"\\).*"
	203	(regexp-quote earcon-suffix)))
	204	(goto-char beg)
	205	(while (re-search-forward regexp nil t)
	206	(let* ((start (and entry (match-beginning 1)))
	207	(end (and entry (match-end 1)))
	208	(from (match-beginning 1)))
	209	(earcon-article-add-button
	210	start end 'earcon-button-push
	211	(car (push (set-marker (make-marker) from)
	212	earcon-button-marker-list)))
	213	(gnus-audio-play (caddr entry))))))))
	214
	215	;;;###autoload
	216	(defun gnus-earcon-display ()
	217	"Play sounds in message buffers."
218	(interactive)
219	(save-excursion
220	(set-buffer gnus-article-buffer)
221	(goto-char (point-min))
222	;; Skip headers
223	(unless (search-forward "\n\n" nil t)
224	(goto-char (point-max)))
225	(sit-for 0)
226	(earcon-buffer (current-buffer) (point))))
227
228	;;;***
229
230	(provide 'earcon)
231
232	(run-hooks 'earcon-load-hook)
233
ab5796a9	234	;;; arch-tag: 844dfeea-980c-4ed0-907f-a30bf139691c
eec82323	235	;;; earcon.el ends here