]> code.delx.au - gnu-emacs/blob - lisp/play/gamegrid.el
Merge from emacs--rel--22
[gnu-emacs] / lisp / play / gamegrid.el
1 ;;; gamegrid.el --- library for implementing grid-based games on Emacs
2
3 ;; Copyright (C) 1997, 1998, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007 Free Software Foundation, Inc.
5
6 ;; Author: Glynn Clements <glynn@sensei.co.uk>
7 ;; Version: 1.02
8 ;; Created: 1997-08-13
9 ;; Keywords: games
10
11 ;; This file is part of GNU Emacs.
12
13 ;; GNU Emacs is free software; you can redistribute it and/or modify
14 ;; it under the terms of the GNU General Public License as published by
15 ;; the Free Software Foundation; either version 3, or (at your option)
16 ;; any later version.
17
18 ;; GNU Emacs is distributed in the hope that it will be useful,
19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 ;; GNU General Public License for more details.
22
23 ;; You should have received a copy of the GNU General Public License
24 ;; along with GNU Emacs; see the file COPYING. If not, write to the
25 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
26 ;; Boston, MA 02110-1301, USA.
27
28 ;;; Commentary:
29
30 ;;; Code:
31
32 (eval-when-compile
33 (require 'cl))
34
35 ;; ;;;;;;;;;;;;; buffer-local variables ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
36
37 (defvar gamegrid-use-glyphs t
38 "Non-nil means use glyphs when available.")
39
40 (defvar gamegrid-use-color t
41 "Non-nil means use color when available.")
42
43 (defvar gamegrid-font "-*-courier-medium-r-*-*-*-140-100-75-*-*-iso8859-*"
44 "Name of the font used in X mode.")
45
46 (defvar gamegrid-face nil
47 "Indicates the face to use as a default.")
48 (make-variable-buffer-local 'gamegrid-face)
49
50 (defvar gamegrid-display-options nil)
51
52 (defvar gamegrid-buffer-width 0)
53 (defvar gamegrid-buffer-height 0)
54 (defvar gamegrid-blank 0)
55
56 (defvar gamegrid-timer nil)
57
58 (defvar gamegrid-display-mode nil)
59
60 (defvar gamegrid-display-table)
61
62 (defvar gamegrid-face-table nil)
63
64 (defvar gamegrid-buffer-start 1)
65
66 (defvar gamegrid-score-file-length 50
67 "Number of high scores to keep")
68
69 (defvar gamegrid-user-score-file-directory
70 (concat user-emacs-directory "games")
71 "A directory for game scores which can't be shared.
72 If Emacs was built without support for shared game scores, then this
73 directory will be used.")
74
75 (make-variable-buffer-local 'gamegrid-use-glyphs)
76 (make-variable-buffer-local 'gamegrid-use-color)
77 (make-variable-buffer-local 'gamegrid-font)
78 (make-variable-buffer-local 'gamegrid-display-options)
79 (make-variable-buffer-local 'gamegrid-buffer-width)
80 (make-variable-buffer-local 'gamegrid-buffer-height)
81 (make-variable-buffer-local 'gamegrid-blank)
82 (make-variable-buffer-local 'gamegrid-timer)
83 (make-variable-buffer-local 'gamegrid-display-mode)
84 (make-variable-buffer-local 'gamegrid-display-table)
85 (make-variable-buffer-local 'gamegrid-face-table)
86 (make-variable-buffer-local 'gamegrid-buffer-start)
87 (make-variable-buffer-local 'gamegrid-score-file-length)
88
89 ;; ;;;;;;;;;;;;; global variables ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
90
91 (defvar gamegrid-grid-x-face nil)
92 (defvar gamegrid-mono-x-face nil)
93 (defvar gamegrid-mono-tty-face nil)
94
95 ;; ;;;;;;;;;;;;; constants ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
96
97 (defconst gamegrid-glyph-height 16)
98
99 (defconst gamegrid-xpm "\
100 /* XPM */
101 static char *noname[] = {
102 /* width height ncolors chars_per_pixel */
103 \"16 16 3 1\",
104 /* colors */
105 \"+ s col1\",
106 \". s col2\",
107 \"- s col3\",
108 /* pixels */
109 \"---------------+\",
110 \"--------------++\",
111 \"--............++\",
112 \"--............++\",
113 \"--............++\",
114 \"--............++\",
115 \"--............++\",
116 \"--............++\",
117 \"--............++\",
118 \"--............++\",
119 \"--............++\",
120 \"--............++\",
121 \"--............++\",
122 \"--............++\",
123 \"-+++++++++++++++\",
124 \"++++++++++++++++\"
125 };
126 "
127 "XPM format image used for each square")
128
129 (defvar gamegrid-xbm "\
130 /* gamegrid XBM */
131 #define gamegrid_width 16
132 #define gamegrid_height 16
133 static unsigned char gamegrid_bits[] = {
134 0xff, 0xff, 0xff, 0x7f, 0xff, 0x3f, 0xaf, 0x0a, 0x57, 0x15, 0xaf, 0x0a,
135 0x57, 0x15, 0xaf, 0x0a, 0x57, 0x15, 0xaf, 0x0a, 0x57, 0x15, 0xaf, 0x0a,
136 0x57, 0x15, 0x07, 0x00, 0x03, 0x00, 0x01, 0x00 };"
137 "XBM format image used for each square.")
138
139 ;; ;;;;;;;;;;;;;;;; miscellaneous functions ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
140
141 (defsubst gamegrid-characterp (arg)
142 (if (fboundp 'characterp)
143 (characterp arg)
144 (integerp arg)))
145
146 (defsubst gamegrid-event-x (event)
147 (if (fboundp 'event-x)
148 (event-x event)
149 (car (posn-col-row (event-end event)))))
150
151 (defsubst gamegrid-event-y (event)
152 (if (fboundp 'event-y)
153 (event-y event)
154 (cdr (posn-col-row (event-end event)))))
155
156 ;; ;;;;;;;;;;;;; display functions ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
157
158 (defun gamegrid-color (color shade)
159 (let* ((v (floor (* shade 255)))
160 (r (* v (aref color 0)))
161 (g (* v (aref color 1)))
162 (b (* v (aref color 2))))
163 (format "#%02x%02x%02x" r g b)))
164
165 (defun gamegrid-set-font (face)
166 (if gamegrid-font
167 (condition-case nil
168 (set-face-font face gamegrid-font)
169 (error nil))))
170
171 (defun gamegrid-setup-face (face color)
172 (set-face-foreground face color)
173 (set-face-background face color)
174 (gamegrid-set-font face)
175 (condition-case nil
176 (set-face-background-pixmap face [nothing]);; XEmacs
177 (error nil))
178 (condition-case nil
179 (set-face-background-pixmap face nil);; Emacs
180 (error nil)))
181
182 (defun gamegrid-make-mono-tty-face ()
183 (let ((face (make-face 'gamegrid-mono-tty-face)))
184 (set-face-inverse-video-p face t)
185 face))
186
187 (defun gamegrid-make-color-tty-face (color)
188 (let* ((color-str (if (symbolp color) (symbol-value color) color))
189 (name (intern (format "gamegrid-color-tty-face-%s" color-str)))
190 (face (make-face name)))
191 (gamegrid-setup-face face color-str)
192 face))
193
194 (defun gamegrid-make-grid-x-face ()
195 (let ((face (make-face 'gamegrid-x-border-face)))
196 (gamegrid-set-font face)
197 face))
198
199 (defun gamegrid-make-mono-x-face ()
200 (let ((face (make-face 'gamegrid-mono-x-face))
201 (color (face-foreground 'default)))
202 (if (null color)
203 (setq color
204 (cdr-safe (assq 'foreground-color (frame-parameters)))))
205 (gamegrid-setup-face face color)
206 face))
207
208 (defun gamegrid-make-color-x-face (color)
209 (let* ((hex (gamegrid-color color 1.0))
210 (name (intern (format "gamegrid-color-x-face-%s" hex)))
211 (face (make-face name)))
212 (gamegrid-setup-face face hex)
213 face))
214
215 (defun gamegrid-make-face (data-spec-list color-spec-list)
216 (let ((data (gamegrid-match-spec-list data-spec-list))
217 (color (gamegrid-match-spec-list color-spec-list)))
218 (case data
219 ('color-x
220 (gamegrid-make-color-x-face color))
221 ('grid-x
222 (unless gamegrid-grid-x-face
223 (setq gamegrid-grid-x-face (gamegrid-make-grid-x-face)))
224 gamegrid-grid-x-face)
225 ('mono-x
226 (unless gamegrid-mono-x-face
227 (setq gamegrid-mono-x-face (gamegrid-make-mono-x-face)))
228 gamegrid-mono-x-face)
229 ('color-tty
230 (gamegrid-make-color-tty-face color))
231 ('mono-tty
232 (unless gamegrid-mono-tty-face
233 (setq gamegrid-mono-tty-face (gamegrid-make-mono-tty-face)))
234 gamegrid-mono-tty-face))))
235
236 (defun gamegrid-colorize-glyph (color)
237 (find-image `((:type xpm :data ,gamegrid-xpm
238 :ascent center
239 :color-symbols
240 (("col1" . ,(gamegrid-color color 0.6))
241 ("col2" . ,(gamegrid-color color 0.8))
242 ("col3" . ,(gamegrid-color color 1.0))))
243 (:type xbm :data ,gamegrid-xbm
244 :ascent center
245 :foreground ,(gamegrid-color color 1.0)
246 :background ,(gamegrid-color color 0.5)))))
247
248 (defun gamegrid-match-spec (spec)
249 (let ((locale (car spec))
250 (value (cadr spec)))
251 (and (or (eq locale t)
252 (and (listp locale)
253 (memq gamegrid-display-mode locale))
254 (and (symbolp locale)
255 (eq gamegrid-display-mode locale)))
256 value)))
257
258 (defun gamegrid-match-spec-list (spec-list)
259 (and spec-list
260 (or (gamegrid-match-spec (car spec-list))
261 (gamegrid-match-spec-list (cdr spec-list)))))
262
263 (defun gamegrid-make-glyph (data-spec-list color-spec-list)
264 (let ((data (gamegrid-match-spec-list data-spec-list))
265 (color (gamegrid-match-spec-list color-spec-list)))
266 (cond ((gamegrid-characterp data)
267 (vector data))
268 ((eq data 'colorize)
269 (gamegrid-colorize-glyph color))
270 ((listp data)
271 (find-image data)) ;untested!
272 ((vectorp data)
273 (gamegrid-make-image-from-vector data)))))
274
275 (defun gamegrid-make-image-from-vector (vect)
276 "Convert an XEmacs style \"glyph\" to an image-spec."
277 (let ((l (list 'image :type)))
278 (dotimes (n (length vect))
279 (setf l (nconc l (list (aref vect n)))))
280 (nconc l (list :ascent 'center))))
281
282 (defun gamegrid-display-type ()
283 (cond ((and gamegrid-use-glyphs
284 (display-images-p))
285 'glyph)
286 ((and gamegrid-use-color
287 (display-graphic-p)
288 (display-color-p))
289 'color-x)
290 ((display-graphic-p)
291 'mono-x)
292 ((and gamegrid-use-color
293 (display-color-p))
294 'color-tty)
295 ((display-multi-font-p) ;???
296 'mono-tty)
297 (t
298 'emacs-tty)))
299
300 (defun gamegrid-set-display-table ()
301 (if (featurep 'xemacs)
302 (add-spec-to-specifier current-display-table
303 gamegrid-display-table
304 (current-buffer)
305 nil
306 'remove-locale)
307 (setq buffer-display-table gamegrid-display-table)))
308
309 (defun gamegrid-setup-default-font ()
310 (setq gamegrid-face
311 (copy-face 'default
312 (intern (concat "gamegrid-face-" (buffer-name)))))
313 (when (eq gamegrid-display-mode 'glyph)
314 (let ((max-height nil))
315 (loop for c from 0 to 255 do
316 (let ((glyph (aref gamegrid-display-table c)))
317 (when (and (listp glyph) (eq (car glyph) 'image))
318 (let ((height (cdr (image-size glyph))))
319 (if (or (null max-height)
320 (< max-height height))
321 (setq max-height height))))))
322 (when (and max-height (< max-height 1))
323 (face-spec-set gamegrid-face `((t :height ,max-height)))))))
324
325 (defun gamegrid-initialize-display ()
326 (setq gamegrid-display-mode (gamegrid-display-type))
327 (setq gamegrid-display-table (make-display-table))
328 (setq gamegrid-face-table (make-vector 256 nil))
329 (loop for c from 0 to 255 do
330 (let* ((spec (aref gamegrid-display-options c))
331 (glyph (gamegrid-make-glyph (car spec) (caddr spec)))
332 (face (gamegrid-make-face (cadr spec) (caddr spec))))
333 (aset gamegrid-face-table c face)
334 (aset gamegrid-display-table c glyph)))
335 (gamegrid-setup-default-font)
336 (gamegrid-set-display-table)
337 (setq cursor-type nil))
338
339
340 (defun gamegrid-set-face (c)
341 (if (eq gamegrid-display-mode 'glyph)
342 (add-text-properties (1- (point)) (point)
343 (list 'display (list (aref gamegrid-display-table c))))
344 (put-text-property (1- (point))
345 (point)
346 'face
347 (aref gamegrid-face-table c))))
348
349 (defun gamegrid-cell-offset (x y)
350 (+ gamegrid-buffer-start
351 (* (1+ gamegrid-buffer-width) y)
352 x))
353
354 ;; ;;;;;;;;;;;;;;;; grid functions ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
355
356 (defun gamegrid-get-cell (x y)
357 (char-after (gamegrid-cell-offset x y)))
358
359 (defun gamegrid-set-cell (x y c)
360 (save-excursion
361 (let ((buffer-read-only nil))
362 (goto-char (gamegrid-cell-offset x y))
363 (delete-char 1)
364 (insert-char c 1)
365 (gamegrid-set-face c))))
366
367 (defun gamegrid-init-buffer (width height blank)
368 (setq gamegrid-buffer-width width
369 gamegrid-buffer-height height)
370 (let ((line (concat
371 (make-string width blank)
372 "\n"))
373 (buffer-read-only nil))
374 (erase-buffer)
375 (setq gamegrid-buffer-start (point))
376 (dotimes (i height)
377 (insert line))
378 ;; Adjust the height of the default face to the height of the
379 ;; images. Unlike XEmacs, Emacs doesn't allow to make the default
380 ;; face buffer-local; so we do this with an overlay.
381 (when (eq gamegrid-display-mode 'glyph)
382 (overlay-put (make-overlay (point-min) (point-max))
383 'face gamegrid-face))
384 (goto-char (point-min))))
385
386 (defun gamegrid-init (options)
387 (setq buffer-read-only t
388 truncate-lines t
389 line-spacing 0
390 gamegrid-display-options options)
391 (buffer-disable-undo (current-buffer))
392 (gamegrid-initialize-display))
393
394 ;; ;;;;;;;;;;;;;;;; timer functions ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
395
396 (defun gamegrid-start-timer (period func)
397 (setq gamegrid-timer
398 (if (featurep 'itimer)
399 (start-itimer "Gamegrid"
400 func
401 period
402 period
403 nil
404 t
405 (current-buffer))
406 (run-with-timer period
407 period
408 func
409 (current-buffer)))))
410
411 (defun gamegrid-set-timer (delay)
412 (if gamegrid-timer
413 (if (fboundp 'set-itimer-restart)
414 (set-itimer-restart gamegrid-timer delay)
415 (timer-set-time gamegrid-timer
416 (list (aref gamegrid-timer 1)
417 (aref gamegrid-timer 2)
418 (aref gamegrid-timer 3))
419 delay))))
420
421 (defun gamegrid-kill-timer ()
422 (if gamegrid-timer
423 (if (featurep 'itimer)
424 (delete-itimer gamegrid-timer)
425 (cancel-timer gamegrid-timer)))
426 (setq gamegrid-timer nil))
427
428 ;; ;;;;;;;;;;;;;;; high score functions ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
429
430 (defun gamegrid-add-score (file score)
431 "Add the current score to the high score file.
432
433 On POSIX systems there may be a shared game directory for all users in
434 which the scorefiles are kept. On such systems Emacs doesn't create
435 the score file FILE in this directory, if it doesn't already exist. In
436 this case Emacs searches for FILE in the directory specified by
437 `gamegrid-user-score-file-directory' and creates it there, if
438 necessary.
439
440 To add the score file for a game to the system wide shared game
441 directory, create the file with the shell command \"touch\" in this
442 directory and make sure that it is owned by the correct user and
443 group. You probably need special user privileges to do this.
444
445 On non-POSIX systems Emacs searches for FILE in the directory
446 specified by the variable `temporary-file-directory'. If necessary,
447 FILE is created there."
448 (case system-type
449 ((ms-dos windows-nt)
450 (gamegrid-add-score-insecure file score))
451 (t
452 (gamegrid-add-score-with-update-game-score file score))))
453
454
455 ;; On POSIX systems there are four cases to distinguish:
456
457 ;; 1. FILE is an absolute filename. Then it should be a file in
458 ;; temporary file directory. This is the way,
459 ;; `gamegrid-add-score' was supposed to be used in the past and
460 ;; is covered here for backward-compatibility.
461 ;;
462 ;; 2. The helper program "update-game-score" is setuid and the
463 ;; file FILE does already exist in a system wide shared game
464 ;; directory. This should be the normal case on POSIX systems,
465 ;; if the game was installed system wide. Use
466 ;; "update-game-score" to add the score to the file in the
467 ;; shared game directory.
468 ;;
469 ;; 3. "update-game-score" is setuid, but the file FILE does *not*
470 ;; exist in the system wide shared game directory. Use
471 ;; `gamegrid-add-score-insecure' to create--if necessary--and
472 ;; update FILE. This is for the case that a user has installed
473 ;; a game on her own.
474 ;;
475 ;; 4. "update-game-score" is not setuid. Use it to create/update
476 ;; FILE in the user's home directory. There is presumably no
477 ;; shared game directory.
478
479 (defvar gamegrid-shared-game-dir)
480
481 (defun gamegrid-add-score-with-update-game-score (file score)
482 (let* ((result nil) ;; What is this good for? -- os
483 (gamegrid-shared-game-dir
484 (not (zerop (logand (file-modes
485 (expand-file-name "update-game-score"
486 exec-directory))
487 #o4000)))))
488 (cond ((file-name-absolute-p file)
489 (gamegrid-add-score-insecure file score))
490 ((and gamegrid-shared-game-dir
491 (file-exists-p (expand-file-name file shared-game-score-directory)))
492 ;; Use the setuid "update-game-score" program to update a
493 ;; system-wide score file.
494 (gamegrid-add-score-with-update-game-score-1 file
495 (expand-file-name file shared-game-score-directory) score))
496 ;; Else: Add the score to a score file in the user's home
497 ;; directory.
498 (gamegrid-shared-game-dir
499 ;; If `gamegrid-shared-game-dir' is non-nil, then
500 ;; "update-gamescore" program is setuid, so don't use it.
501 (unless (file-exists-p
502 (directory-file-name gamegrid-user-score-file-directory))
503 (make-directory gamegrid-user-score-file-directory t))
504 (gamegrid-add-score-insecure file score
505 gamegrid-user-score-file-directory))
506 (t (let ((f (expand-file-name
507 gamegrid-user-score-file-directory)))
508 (when (file-writable-p f)
509 (unless (eq (car-safe (file-attributes f))
510 t)
511 (make-directory f))
512 (setq f (expand-file-name file f))
513 (unless (file-exists-p f)
514 (write-region "" nil f nil 'silent nil 'excl)))
515 (gamegrid-add-score-with-update-game-score-1 file f score))))))
516
517 (defun gamegrid-add-score-with-update-game-score-1 (file target score)
518 (let ((default-directory "/")
519 (errbuf (generate-new-buffer " *update-game-score loss*"))
520 (marker-string (concat
521 (user-full-name)
522 " <"
523 (cond ((fboundp 'user-mail-address)
524 (user-mail-address))
525 ((boundp 'user-mail-address)
526 user-mail-address)
527 (t ""))
528 "> "
529 (current-time-string))))
530 ;; This can be called from a timer, so enable local quits.
531 (with-local-quit
532 (apply
533 'call-process
534 (append
535 (list
536 (expand-file-name "update-game-score" exec-directory)
537 nil errbuf nil
538 "-m" (int-to-string gamegrid-score-file-length)
539 "-d" (if gamegrid-shared-game-dir
540 (expand-file-name shared-game-score-directory)
541 (file-name-directory target))
542 file
543 (int-to-string score)
544 marker-string))))
545 (if (buffer-modified-p errbuf)
546 (progn
547 (display-buffer errbuf)
548 (error "Failed to update game score file"))
549 (kill-buffer errbuf))
550 (let ((buf (find-buffer-visiting target)))
551 (save-excursion
552 (if buf
553 (progn
554 (switch-to-buffer buf)
555 (revert-buffer nil t nil)
556 (display-buffer buf))
557 (find-file-read-only target))
558 (goto-char (point-min))
559 (search-forward (concat (int-to-string score)
560 " " (user-login-name) " "
561 marker-string))
562 (beginning-of-line)))))
563
564 (defun gamegrid-add-score-insecure (file score &optional directory)
565 (save-excursion
566 (setq file (expand-file-name file (or directory
567 temporary-file-directory)))
568 (find-file-other-window file)
569 (setq buffer-read-only nil)
570 (goto-char (point-max))
571 (insert (format "%05d\t%s\t%s <%s>\n"
572 score
573 (current-time-string)
574 (user-full-name)
575 (cond ((fboundp 'user-mail-address)
576 (user-mail-address))
577 ((boundp 'user-mail-address)
578 user-mail-address)
579 (t ""))))
580 (sort-fields 1 (point-min) (point-max))
581 (reverse-region (point-min) (point-max))
582 (goto-line (1+ gamegrid-score-file-length))
583 (delete-region (point) (point-max))
584 (setq buffer-read-only t)
585 (save-buffer)))
586
587
588 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
589
590 (provide 'gamegrid)
591
592 ;;; arch-tag: a96c2ff4-1c12-427e-bd3d-faeaf174cd46
593 ;;; gamegrid.el ends here