-a0 243
;;; chess.el --- Play chess in Emacs
;; Copyright (C) 2001 John Wiegley <johnw@gnu.org>
;; Version: 2.0
;; Keywords: games
;; Author: John Wiegley <johnw@gnu.org>
-;; Maintainer: John Wiegley <johnw@gnu.org>
+;; Maintainer: Mario Lang <mlang@delysid.org>
;; Description: Play chess in Emacs
-;; URL: http://www.gci-net.com/~johnw/Emacs/packages/chess.tar.gz
-;; Compatibility: Emacs20, Emacs21, XEmacs21
+;; URL: http://emacs-chess.sourceforge.net/
+;; Compatibility: Emacs21
;; This file is not part of GNU Emacs.
;;
;; To just get a chessboard up, put the following in your .emacs file:
;;
-;; (add-to-list 'load-list "<the path to Emacs Chess>")
+;; (add-to-list 'load-path "<the path to Emacs Chess>")
;;
;; (autoload 'chess "chess" "Play a game of chess" t)
;;
(require 'chess-game)
(require 'chess-display)
(require 'chess-engine)
-(require 'chess-pgn)
(defgroup chess nil
"An Emacs chess playing program."
:group 'games)
-(defconst chess-version "2.0a7"
+(defconst chess-version "2.0b6"
"The version of the Emacs chess program.")
-(defcustom chess-default-display (if (display-graphic-p)
- 'chess-images 'chess-ics1)
- "Default module set to be used when starting a chess session."
- :type 'sexp
+(defcustom chess-default-display
+ '(chess-images chess-ics1 chess-plain)
+ "Default display to be used when starting a chess session.
+A list indicates a series of alternatives if the first display is
+not available."
+ :type '(choice symbol (repeat symbol))
:group 'chess)
-(defcustom chess-default-engine 'chess-gnuchess
- "Default engine to be used when starting a chess session."
- :type 'sexp
+(defcustom chess-default-modules
+ '((chess-sound chess-announce)
+ chess-autosave
+ chess-clock
+ ;;chess-kibitz jww (2002-04-30): not fully supported yet
+ ;;chess-chat
+ )
+ "Modules to be used when starting a chess session.
+A sublist indicates a series of alternatives, if the first is not
+available.
+These can do just about anything."
+ :type '(repeat (choice symbol (repeat symbol)))
:group 'chess)
-(defcustom chess-announce-moves t
- "If non-nil, announce when your opponent makes a move.
-This variable can also be a symbol which names a different announcing
-module to use. This happens verbally if 'festival' is installed, or
-if you have sound files installed and a sound play (see
-chess-sound.el). Otherwise it just prints a message in your
-minibuffer, which works well for Emacspeak users."
- :type 'boolean
+(defcustom chess-default-engine
+ '(chess-crafty
+ chess-stockfish chess-glaurung chess-fruit
+ chess-gnuchess chess-phalanx
+ chess-ai)
+ "Default engine to be used when starting a chess session.
+A list indicates a series of alternatives if the first engine is not
+available."
+ :type '(choice symbol (repeat symbol))
:group 'chess)
(defcustom chess-full-name (user-full-name)
:type 'string
:group 'chess)
+(and (fboundp 'font-lock-add-keywords)
+ (font-lock-add-keywords
+ 'emacs-lisp-mode
+ '(("(\\(chess-error\\)\\>" 1 font-lock-warning-face)
+ ("(\\(chess-with-current-buffer\\)\\>" 1 font-lock-keyword-face))))
+
+(defun chess--create-display (module game my-color disable-popup)
+ (let ((display (chess-display-create game module my-color)))
+ (when display
+ (chess-game-set-data game 'my-color my-color)
+ (if disable-popup
+ (chess-display-disable-popup display))
+ display)))
+
+(defun chess--create-engine (module game response-handler ctor-args)
+ (let ((engine (apply 'chess-engine-create module game
+ response-handler ctor-args)))
+ (when engine
+ ;; for the sake of engines which are ready to play now, and
+ ;; which don't need connect/accept negotiation (most
+ ;; computerized engines fall into this category), we need to
+ ;; let them know we're ready to begin
+ (chess-engine-command engine 'ready)
+ engine)))
+
+(defun chess-create-modules (module-list create-func &rest args)
+ "Create modules from MODULE-LIST with CREATE-FUNC and ARGS.
+If an element of MODULE-LIST is a sublist, treat it as alternatives."
+ (let (objects)
+ (dolist (module module-list)
+ (let (object)
+ (if (symbolp module)
+ (if (setq object (apply create-func module args))
+ (push object objects))
+ ;; this module is actually a list, which means keep trying
+ ;; until we find one that works
+ (while module
+ (if (setq object (condition-case nil
+ (apply create-func (car module) args)
+ (error nil)))
+ (progn
+ (push object objects)
+ (setq module nil))
+ (setq module (cdr module)))))))
+ (nreverse objects)))
+
+(chess-message-catalog 'english
+ '((no-engines-found
+ . "Could not find any chess engines to play against; install gnuchess!")))
+
;;;###autoload
(defun chess (&optional engine disable-popup engine-response-handler
&rest engine-ctor-args)
- "Start a game of chess, playing against ENGINE (a module name)."
+ "Start a game of chess, playing against ENGINE (a module name).
+With prefix argument, prompt for the engine to play against.
+Otherwise use `chess-default-engine' to determine the engine."
(interactive
(list
(if current-prefix-arg
"none"))))
chess-default-engine)))
- (require chess-default-display)
- (let* ((my-color t) ; we start out as white always
- (display (chess-display-create chess-default-display my-color))
- (game (chess-game-create)))
-
- (when (and (eq chess-default-display 'chess-images)
- (with-current-buffer display
- (null chess-images-size)))
- (message "Could not find suitable chess images; using ics1 display")
- (chess-display-destroy display)
- (require 'chess-ics1)
- (setq display (chess-display-create 'chess-ics1 my-color)))
-
- (chess-game-set-data game 'my-color my-color)
- (if disable-popup
- (chess-display-disable-popup display))
- (chess-display-set-game display game)
- (chess-display-set-main display)
-
- (let ((engine-module (or engine chess-default-engine)))
- (when (and engine-module (require engine-module nil t))
- (let ((engine (apply 'chess-engine-create engine-module nil
- engine-ctor-args)))
- (chess-engine-set-game* engine game)
- ;; for the sake of engines which are ready to play now, and
- ;; which don't need connect/accept negotiation (most
- ;; computerized engines fall into this category), we need to
- ;; let them know we're ready to begin
- (chess-engine-command engine 'ready))
-
- (when chess-announce-moves
- (if (and (not (eq chess-announce-moves t))
- (symbolp chess-announce-moves))
- (let ((name (symbol-name chess-announce-moves)))
- (require chess-announce-moves)
- (if (funcall (intern (concat name "-available-p")))
- (funcall (intern (concat name "-for-game")) game)))
- (require 'chess-sound)
- (if (chess-sound-available-p)
- (chess-sound-for-game game)
- (require 'chess-announce)
- (if (chess-announce-available-p)
- (chess-announce-for-game game)))))))
-
- (chess-display-update display t)
-
- (cons display engine)))
+ (let ((game (chess-game-create))
+ (my-color t) ; we start out as white always
+ objects)
-(defalias 'chess-session 'chess)
+ ;; all these odd calls are so that `objects' ends up looking like:
+ ;; (ENGINE FIRST-DISPLAY...)
+
+ (setq objects (chess-create-modules (list chess-default-display)
+ 'chess--create-display
+ game my-color disable-popup))
+ (when (car objects)
+ (mapc 'chess-display-update objects)
+ (chess-module-set-leader (car objects))
+ (unless disable-popup
+ (chess-display-popup (car objects))))
+
+ (nconc objects (chess-create-modules chess-default-modules
+ 'chess-module-create game))
+
+ (push (unless (eq engine 'none)
+ (car ;(condition-case nil
+ (chess-create-modules (list (or engine chess-default-engine))
+ 'chess--create-engine game
+ engine-response-handler
+ engine-ctor-args)
+ ; (error nil))
+ ))
+ objects)
+
+ (unless (car objects)
+ (chess-message 'no-engines-found))
+
+ objects))
;;;###autoload
-(defun chess-read-pgn (&optional file)
- "Read and display a PGN game after point."
- (interactive "P")
- (if (or file (not (search-forward "[Event" nil t)))
- (setq file (read-file-name "Read a PGN game from file: ")))
- (if file
- (find-file file))
- (let ((game (chess-pgn-to-game)))
- (when game
- (require chess-default-display)
- (chess-display-set-game
- (chess-display-create chess-default-display
- (chess-game-side-to-move game)) game))))
-
-(defvar chess-puzzle-locations nil)
-
-(defun chess-puzzle-next ()
- "Play the next puzzle in the collection, selected randomly."
- (interactive)
- (if chess-puzzle-locations
- (chess-puzzle (aref chess-puzzle-locations 0))))
+(defalias 'chess-session 'chess)
;;;###autoload
-(defun chess-puzzle (file)
- "Pick a random puzzle from FILE, and solve it against the default engine.
-The spacebar in the display buffer is bound to `chess-puzzle-next',
-making it easy to go on to the next puzzle once you've solved one."
- (interactive "fRead chess puzzles from: ")
- (save-excursion
- (with-current-buffer (find-file-noselect file)
- (when (or (null chess-puzzle-locations)
- (not (equal file (aref chess-puzzle-locations 0))))
- (let (locations)
- (goto-char (point-min))
- (while (search-forward "[Event" nil t)
- (push (point) locations))
- (setq chess-puzzle-locations (vector file locations nil nil)))
- (random t))
- (goto-char (nth (random (length (aref chess-puzzle-locations 1)))
- (aref chess-puzzle-locations 1)))
- (let ((game (chess-pgn-to-game)))
- (when game
- (require chess-default-display)
- (let ((puzzle-display
- (or (and (buffer-live-p (aref chess-puzzle-locations 2))
- (aref chess-puzzle-locations 2))
- (chess-display-create chess-default-display
- (chess-game-side-to-move game)))))
- (chess-display-set-game puzzle-display game)
- (aset chess-puzzle-locations 2 puzzle-display)
- ;; setup spacebar as a convenient way to jump to the next puzzle
- (with-current-buffer puzzle-display
- (define-key (current-local-map) [? ] 'chess-puzzle-next)))
- (require chess-default-engine)
- (let ((puzzle-engine
- (or (and (buffer-live-p (aref chess-puzzle-locations 3))
- (aref chess-puzzle-locations 3))
- (chess-engine-create chess-default-engine))))
- (chess-engine-set-game puzzle-engine game)
- (aset chess-puzzle-locations 3 puzzle-engine)))))))
+(defun chess-create-display (perspective &optional modules-too)
+ "Create a display, letting the user's customization decide the style.
+If MODULES-TOO is non-nil, also create and associate the modules
+listed in `chess-default-modules'."
+ (if modules-too
+ (let ((display (cadr (chess-session 'none))))
+ (chess-display-set-perspective* display perspective))
+ (car (chess-create-modules (list chess-default-display)
+ 'chess--create-display
+ (chess-game-create) perspective nil))))
(provide 'chess)