* gnus.el: Fix copyright statements.
[gnus] / lisp / earcon.el
1 ;;; earcon.el --- Sound effects for messages
2 ;; Copyright (C) 1996 Free Software Foundation
3
4 ;; Author: Steven L. Baur <steve@miranova.com>
5 ;; GNU Emacs 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, or (at your option)
8 ;; any later version.
9
10 ;; GNU Emacs 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.
14
15 ;; You should have received a copy of the GNU General Public License
16 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
17 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 ;; Boston, MA 02111-1307, USA.
19
20 ;;; Commentary:
21 ;; This file provides access to sound effects in Gnus.
22
23 ;;; Code:
24
25 (if (null (boundp 'running-xemacs))
26     (defvar running-xemacs (string-match "XEmacs\\|Lucid" emacs-version)))
27
28 (eval-when-compile (require 'cl))
29 (require 'gnus)
30 (require 'gnus-audio)
31 (require 'gnus-art)
32
33 (defgroup earcon nil
34   "Turn ** sounds ** into noise."
35   :group 'gnus-visual)
36
37 (defcustom earcon-auto-play nil
38   "*When True, automatically play sounds as well as buttonize them."
39   :type 'boolean
40   :group 'earcon)
41
42 (defcustom earcon-prefix "**"
43   "*String denoting the start of an earcon."
44   :type 'string
45   :group 'earcon)
46
47 (defcustom earcon-suffix "**"
48   "String denoting the end of an earcon."
49   :type 'string
50   :group 'earcon)
51
52 (defcustom earcon-regexp-alist
53   '(("boring" 1 "Boring.au")
54     ("evil[ \t]+laugh" 1 "Evil_Laugh.au")
55     ("gag\\|puke" 1 "Puke.au")
56     ("snicker" 1 "Snicker.au")
57     ("meow" 1 "catmeow.au")
58     ("sob\\|boohoo" 1 "cry.wav")
59     ("drum[ \t]*roll" 1 "drumroll.au")
60     ("blast" 1 "explosion.au")
61     ("flush\\|plonk!*" 1 "flush.au")
62     ("kiss" 1 "kiss.wav")
63     ("tee[ \t]*hee" 1 "laugh.au")
64     ("shoot" 1 "shotgun.wav")
65     ("yawn" 1 "snore.wav")
66     ("cackle" 1 "witch.au")
67     ("yell\\|roar" 1 "yell2.au")
68     ("whoop-de-doo" 1 "whistle.au"))
69   "*A list of regexps to map earcons to real sounds."
70   :type '(repeat (list regexp
71                        (integer :tag "Match")
72                        (string :tag "Sound")))
73   :group 'earcon)
74 (defvar earcon-button-marker-list nil)
75 (make-variable-buffer-local 'earcon-button-marker-list)
76
77 ;;; FIXME!! clone of code from gnus-vis.el FIXME!!
78 (defun earcon-article-push-button (event)
79   "Check text under the mouse pointer for a callback function.
80 If the text under the mouse pointer has a `earcon-callback' property,
81 call it with the value of the `earcon-data' text property."
82   (interactive "e")
83   (set-buffer (window-buffer (posn-window (event-start event))))
84   (let* ((pos (posn-point (event-start event)))
85          (data (get-text-property pos 'earcon-data))
86          (fun (get-text-property pos 'earcon-callback)))
87     (if fun (funcall fun data))))
88
89 (defun earcon-article-press-button ()
90   "Check text at point for a callback function.
91 If the text at point has a `earcon-callback' property,
92 call it with the value of the `earcon-data' text property."
93   (interactive)
94   (let* ((data (get-text-property (point) 'earcon-data))
95          (fun (get-text-property (point) 'earcon-callback)))
96     (if fun (funcall fun data))))
97
98 (defun earcon-article-prev-button (n)
99   "Move point to N buttons backward.
100 If N is negative, move forward instead."
101   (interactive "p")
102   (earcon-article-next-button (- n)))
103
104 (defun earcon-article-next-button (n)
105   "Move point to N buttons forward.
106 If N is negative, move backward instead."
107   (interactive "p")
108   (let ((function (if (< n 0) 'previous-single-property-change
109                     'next-single-property-change))
110         (inhibit-point-motion-hooks t)
111         (backward (< n 0))
112         (limit (if (< n 0) (point-min) (point-max))))
113     (setq n (abs n))
114     (while (and (not (= limit (point)))
115                 (> n 0))
116       ;; Skip past the current button.
117       (when (get-text-property (point) 'earcon-callback)
118         (goto-char (funcall function (point) 'earcon-callback nil limit)))
119       ;; Go to the next (or previous) button.
120       (gnus-goto-char (funcall function (point) 'earcon-callback nil limit))