lisp/thumbs.el

   1 ;;; thumbs.el --- Thumbnails previewer for images files
   2
   3 ;; Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
   4
   5 ;; Author: Jean-Philippe Theberge <jphiltheberge@videotron.ca>
   6 ;; Maintainer: FSF
   7 ;; Keywords: Multimedia
   8
   9 ;; This file is part of GNU Emacs.
  10
  11 ;; GNU Emacs is free software: you can redistribute it and/or modify
  12 ;; it under the terms of the GNU General Public License as published by
  13 ;; the Free Software Foundation, either version 3 of the License, or
  14 ;; (at your option) any later version.
  15
  16 ;; GNU Emacs is distributed in the hope that it will be useful,
  17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19 ;; GNU General Public License for more details.
  20
  21 ;; You should have received a copy of the GNU General Public License
  22 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  23
  24 ;;; Commentary:
  25
  26 ;; This package create two new modes: thumbs-mode and thumbs-view-image-mode.
  27 ;; It is used for basic browsing and viewing of images from within Emacs.
  28 ;; Minimal image manipulation functions are also available via external
  29 ;; programs.  If you want to do more complex tasks like categorise and tag
  30 ;; your images, use image-dired.el
  31 ;;
  32 ;; The 'convert' program from 'ImageMagick'
  33 ;; [URL:http://www.imagemagick.org/] is required.
  34 ;;
  35 ;; Thanks: Alex Schroeder <alex@gnu.org> for maintaining the package at some
  36 ;;         time.  The peoples at #emacs@freenode.net for numerous help.  RMS
  37 ;;         for emacs and the GNU project.
  38 ;;
  39 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  40 ;;
  41 ;; CHANGELOG
  42 ;;
  43 ;; This is version 2.0
  44 ;;
  45 ;; USAGE
  46 ;;
  47 ;; Type M-x thumbs RET DIR RET to view the directory DIR in Thumbs mode.
  48 ;; That should be a directory containing image files.
  49 ;; from dired, C-t m enter in thumbs-mode with all marked files
  50 ;;             C-t a enter in thumbs-mode with all files in current-directory
  51 ;; In thumbs-mode, pressing <return> on a image will bring you in image view
  52 ;; mode for that image.  C-h m will give you a list of available keybinding.
  53
  54 ;;; History:
  55 ;;
  56
  57 ;;; Code:
  58
  59 (require 'dired)
  60
  61 ;; CUSTOMIZATIONS
  62
  63 (defgroup thumbs nil
  64   "Thumbnails previewer."
  65   :version "22.1"
  66   :group 'multimedia)
  67
  68 (defcustom thumbs-thumbsdir (locate-user-emacs-file "thumbs")
  69   "Directory to store thumbnails."
  70   :type 'directory
  71   :group 'thumbs)
  72
  73 (defcustom thumbs-geometry "100x100"
  74   "Size of thumbnails."
  75   :type 'string
  76   :group 'thumbs)
  77
  78 (defcustom thumbs-per-line 4
  79   "Number of thumbnails per line to show in directory."
  80   :type 'integer
  81   :group 'thumbs)
  82
  83 (defcustom thumbs-max-image-number 16
  84  "Maximum number of images initially displayed in thumbs buffer."
  85   :type 'integer
  86   :group 'thumbs)
  87
  88 (defcustom thumbs-thumbsdir-max-size 50000000
  89   "Maximum size for thumbnails directory.
  90 When it reaches that size (in bytes), a warning is sent."
  91   :type 'integer
  92   :group 'thumbs)
  93
  94 ;; Unfortunately Windows XP has a program called CONVERT.EXE in
  95 ;; C:/WINDOWS/SYSTEM32/ for partioning NTFS system.  So Emacs
  96 ;; can find the one in your ImageMagick directory, you need to
  97 ;; customize this value to the absolute filename.
  98 (defcustom thumbs-conversion-program
  99   (if (eq system-type 'windows-nt)
 100       "convert.exe"
 101     (or (executable-find "convert")
 102         "/usr/X11R6/bin/convert"))
 103   "Name of conversion program for thumbnails generation.
 104 It must be 'convert'."
 105   :type 'string
 106   :group 'thumbs)
 107
 108 (defcustom thumbs-setroot-command
 109   "xloadimage -onroot -fullscreen *"
 110   "Command to set the root window."
 111   :type 'string
 112   :group 'thumbs)
 113
 114 (defcustom thumbs-relief 5
 115   "Size of button-like border around thumbnails."
 116   :type 'integer
 117   :group 'thumbs)
 118
 119 (defcustom thumbs-margin 2
 120   "Size of the margin around thumbnails.
 121 This is where you see the cursor."
 122   :type 'integer
 123   :group 'thumbs)
 124
 125 (defcustom thumbs-thumbsdir-auto-clean t
 126   "If set, delete older file in the thumbnails directory.
 127 Deletion is done at load time when the directory size is bigger
 128 than `thumbs-thumbsdir-max-size'."
 129   :type 'boolean
 130   :group 'thumbs)
 131
 132 (defcustom thumbs-image-resizing-step 10
 133   "Step by which to resize image as a percentage."
 134   :type 'integer
 135   :group 'thumbs)
 136
 137 (defcustom thumbs-temp-dir temporary-file-directory
 138   "Temporary directory to use.
 139 Defaults to `temporary-file-directory'.  Leaving it to
 140 this value can let another user see some of your images."
 141   :type 'directory
 142   :group 'thumbs)
 143
 144 (defcustom thumbs-temp-prefix "emacsthumbs"
 145   "Prefix to add to temp files."
 146   :type 'string
 147   :group 'thumbs)
 148
 149 ;; Initialize some variable, for later use.
 150 (defvar thumbs-current-tmp-filename nil
 151   "Temporary filename of current image.")
 152 (make-variable-buffer-local 'thumbs-current-tmp-filename)
 153
 154 (defvar thumbs-current-image-filename nil
 155   "Filename of current image.")
 156 (make-variable-buffer-local 'thumbs-current-image-filename)
 157
 158 (defvar thumbs-extra-images 1
 159   "Counter for showing extra images in thumbs buffer.")
 160 (make-variable-buffer-local 'thumbs-extra-images)
 161 (put 'thumbs-extra-images 'permanent-local t)
 162
 163 (defvar thumbs-current-image-size nil
 164   "Size of current image.")
 165
 166 (defvar thumbs-image-num nil
 167   "Number of current image.")
 168 (make-variable-buffer-local 'thumbs-image-num)
 169
 170 (defvar thumbs-buffer nil
 171   "Name of buffer containing thumbnails associated with image.")
 172 (make-variable-buffer-local 'thumbs-buffer)
 173
 174 (defvar thumbs-current-dir nil
 175   "Current directory.")
 176
 177 (defvar thumbs-marked-list nil
 178   "List of marked files.")
 179 (make-variable-buffer-local 'thumbs-marked-list)
 180 (put 'thumbs-marked-list 'permanent-local t)
 181
 182 (defalias 'thumbs-gensym
 183     (if (fboundp 'gensym)
 184         'gensym
 185       ;; Copied from cl-macs.el
 186       (defvar thumbs-gensym-counter 0)
 187       (lambda (&optional prefix)
 188         "Generate a new uninterned symbol.
 189 The name is made by appending a number to PREFIX, default \"G\"."
 190         (let ((pfix (if (stringp prefix) prefix "G"))
 191               (num (if (integerp prefix) prefix
 192                      (prog1 thumbs-gensym-counter
 193                        (setq thumbs-gensym-counter
 194                              (1+ thumbs-gensym-counter))))))
 195           (make-symbol (format "%s%d" pfix num))))))
 196
 197 (defsubst thumbs-temp-dir ()
 198   (file-name-as-directory (expand-file-name thumbs-temp-dir)))
 199
 200 (defun thumbs-temp-file ()
 201   "Return a unique temporary filename for an image."
 202   (format "%s%s-%s.jpg"
 203           (thumbs-temp-dir)
 204           thumbs-temp-prefix
 205           (thumbs-gensym "T")))
 206
 207 (defun thumbs-thumbsdir ()
 208   "Return the current thumbnails directory (from `thumbs-thumbsdir').
 209 Create the thumbnails directory if it does not exist."
 210   (let ((thumbs-thumbsdir (file-name-as-directory
 211                            (expand-file-name thumbs-thumbsdir))))
 212     (unless (file-directory-p thumbs-thumbsdir)
 213       (make-directory thumbs-thumbsdir t)
 214       (message "Creating thumbnails directory"))
 215     thumbs-thumbsdir))
 216
 217 (defun thumbs-cleanup-thumbsdir ()
 218   "Clean the thumbnails directory.
 219 If the total size of all files in `thumbs-thumbsdir' is bigger than
 220 `thumbs-thumbsdir-max-size', files are deleted until the max size is
 221 reached."
 222   (let* ((files-list
 223           (sort
 224            (mapcar
 225             (lambda (f)
 226               (let ((fattribs-list (file-attributes f)))
 227                 `(,(nth 4 fattribs-list) ,(nth 7 fattribs-list) ,f)))
 228             (directory-files (thumbs-thumbsdir) t (image-file-name-regexp)))
 229            '(lambda (l1 l2) (time-less-p (car l1) (car l2)))))
 230          (dirsize (apply '+ (mapcar (lambda (x) (cadr x)) files-list))))
 231     (while (> dirsize thumbs-thumbsdir-max-size)
 232       (progn
 233         (message "Deleting file %s" (cadr (cdar files-list))))
 234       (delete-file (cadr (cdar files-list)))
 235       (setq dirsize (- dirsize (car (cdar files-list))))
 236       (setq files-list (cdr files-list)))))
 237
 238 ;; Check the thumbsnail directory size and clean it if necessary.
 239 (when thumbs-thumbsdir-auto-clean
 240   (thumbs-cleanup-thumbsdir))
 241
 242 (defun thumbs-call-convert (filein fileout action
 243                                    &optional arg output-format action-prefix)
 244   "Call the convert program.
 245 FILEIN is the input file,
 246 FILEOUT is the output file,
 247 ACTION is the command to send to convert.
 248 Optional arguments are:
 249 ARG any arguments to the ACTION command,
 250 OUTPUT-FORMAT is the file format to output (default is jpeg),
 251 ACTION-PREFIX is the symbol to place before the ACTION command
 252               (defaults to '-' but can sometimes be '+')."
 253   (call-process thumbs-conversion-program nil nil nil
 254                 (or action-prefix "-")
 255                 action
 256                 (or arg "")
 257                 filein
 258                 (format "%s:%s" (or output-format "jpeg") fileout)))
 259
 260 (defun thumbs-new-image-size (s increment)
 261   "New image (a cons of width x height)."
 262   (let ((d (* increment thumbs-image-resizing-step)))
 263     (cons
 264      (round (+ (car s) (/ (* d (car s)) 100)))
 265      (round (+ (cdr s) (/ (* d (cdr s)) 100))))))
 266
 267 (defun thumbs-resize-image-1 (&optional increment size)
 268   "Resize image in current buffer.
 269 If SIZE is specified use it.  Otherwise make the image larger or
 270 smaller according to whether INCREMENT is 1 or -1."
 271   (let* ((buffer-read-only nil)
 272          (old thumbs-current-tmp-filename)
 273          (x (or size
 274                 (thumbs-new-image-size thumbs-current-image-size increment)))
 275          (tmp (thumbs-temp-file)))
 276     (erase-buffer)
 277     (thumbs-call-convert (or old thumbs-current-image-filename)
 278                          tmp "sample"
 279                          (concat (number-to-string (car x)) "x"
 280                                  (number-to-string (cdr x))))
 281     (save-excursion
 282       (thumbs-insert-image tmp 'jpeg 0))
 283     (setq thumbs-current-tmp-filename tmp)))
 284
 285 (defun thumbs-resize-image (width height)
 286   "Resize image interactively to specified WIDTH and HEIGHT."
 287   (interactive "nWidth: \nnHeight: ")
 288   (thumbs-resize-image-1 nil (cons width height)))
 289
 290 (defun thumbs-shrink-image ()
 291   "Resize image (smaller)."
 292   (interactive)
 293   (thumbs-resize-image-1 -1))
 294
 295 (defun thumbs-enlarge-image ()
 296   "Resize image (bigger)."
 297   (interactive)
 298   (thumbs-resize-image-1 1))
 299
 300 (defun thumbs-thumbname (img)
 301   "Return a thumbnail name for the image IMG."
 302   (convert-standard-filename
 303    (let ((filename (expand-file-name img)))
 304      (format "%s%08x-%s.jpg"
 305              (thumbs-thumbsdir)
 306              (sxhash filename)
 307              (subst-char-in-string
 308               ?\s ?\_
 309               (apply
 310                'concat
 311                (split-string filename "/")))))))
 312
 313 (defun thumbs-make-thumb (img)
 314   "Create the thumbnail for IMG."
 315   (let ((fn (expand-file-name img))
 316         (tn (thumbs-thumbname img)))
 317     (if (or (not (file-exists-p tn))
 318             ;;  This is not the right fix, but I don't understand
 319             ;;  the external program or why it produces a geometry
 320             ;;  unequal to the one requested -- rms.
 321 ;;;         (not (equal (thumbs-file-size tn) thumbs-geometry))
 322             )
 323         (thumbs-call-convert fn tn "sample" thumbs-geometry))
 324     tn))
 325
 326 (defun thumbs-image-type (img)
 327   "Return image type from filename IMG."
 328   (cond ((string-match ".*\\.jpe?g\\'" img) 'jpeg)
 329         ((string-match ".*\\.xpm\\'" img) 'xpm)
 330         ((string-match ".*\\.xbm\\'" img) 'xbm)
 331         ((string-match ".*\\.pbm\\'" img) 'pbm)
 332         ((string-match ".*\\.gif\\'" img) 'gif)
 333         ((string-match ".*\\.bmp\\'" img) 'bmp)
 334         ((string-match ".*\\.png\\'" img) 'png)
 335         ((string-match ".*\\.tiff?\\'" img) 'tiff)))
 336
 337 (declare-function image-size "image.c" (spec &optional pixels frame))
 338
 339 (defun thumbs-file-size (img)
 340   (let ((i (image-size
 341             (find-image `((:type ,(thumbs-image-type img) :file ,img))) t)))
 342     (concat (number-to-string (round (car i))) "x"
 343             (number-to-string (round (cdr i))))))
 344
 345 ;;;###autoload
 346 (defun thumbs-find-thumb (img)
 347   "Display the thumbnail for IMG."
 348   (interactive "f")
 349   (find-file (thumbs-make-thumb img)))
 350
 351 (defun thumbs-insert-image (img type relief &optional marked)
 352   "Insert image IMG at point.
 353 TYPE and RELIEF will be used in constructing the image; see `image'
 354 in the emacs-lisp manual for further documentation.
 355 If MARKED is non-nil, the image is marked."
 356   (let ((i `(image :type ,type
 357                    :file ,img
 358                    :relief ,relief
 359                    :conversion ,(if marked 'disabled)
 360                    :margin ,thumbs-margin)))
 361     (insert-image i)
 362     (set (make-local-variable 'thumbs-current-image-size)
 363          (image-size i t))))
 364
 365 (defun thumbs-insert-thumb (img &optional marked)
 366   "Insert the thumbnail for IMG at point.
 367 If MARKED is non-nil, the image is marked."
 368   (thumbs-insert-image
 369    (thumbs-make-thumb img) 'jpeg thumbs-relief marked)
 370   (add-text-properties (1- (point)) (point)
 371                      `(thumb-image-file ,img
 372                        help-echo ,(file-name-nondirectory img)
 373                        rear-nonsticky help-echo)))
 374
 375 (defun thumbs-do-thumbs-insertion (list)
 376   "Insert all thumbnails into thumbs buffer."
 377   (let* ((i 0)
 378         (length (length list))
 379         (diff (- length (* thumbs-max-image-number thumbs-extra-images))))
 380     (nbutlast list diff)
 381     (dolist (img list)
 382       (thumbs-insert-thumb img
 383                            (member img thumbs-marked-list))
 384       (when (= 0 (mod (setq i (1+ i)) thumbs-per-line))
 385         (newline)))
 386     (unless (bobp) (newline))
 387     (if (> diff 0) (message "Type + to display more images."))))
 388
 389 (defun thumbs-show-thumbs-list (list &optional dir same-window)
 390   (unless (and (display-images-p)
 391                (image-type-available-p 'jpeg))
 392     (error "Required image type is not supported in this Emacs session"))
 393   (funcall (if same-window 'switch-to-buffer 'pop-to-buffer)
 394            (if dir (concat "*Thumbs: " dir) "*THUMB-View*"))
 395   (let ((inhibit-read-only t))
 396     (erase-buffer)
 397     (thumbs-mode)
 398     (setq thumbs-buffer (current-buffer))
 399     (if dir (setq default-directory dir))
 400     (thumbs-do-thumbs-insertion list)
 401     (goto-char (point-min))
 402     (set (make-local-variable 'thumbs-current-dir) default-directory)))
 403
 404 ;;;###autoload
 405 (defun thumbs-show-from-dir (dir &optional reg same-window)
 406   "Make a preview buffer for all images in DIR.
 407 Optional argument REG to select file matching a regexp,
 408 and SAME-WINDOW to show thumbs in the same window."
 409   (interactive "DDir: ")
 410   (thumbs-show-thumbs-list
 411    (directory-files dir t (or reg (image-file-name-regexp)))
 412    dir same-window))
 413
 414 ;;;###autoload
 415 (defun thumbs-dired-show-marked ()
 416   "In dired, make a thumbs buffer with marked files."
 417   (interactive)
 418   (thumbs-show-thumbs-list (dired-get-marked-files) nil t))
 419
 420 ;;;###autoload
 421 (defun thumbs-dired-show ()
 422   "In dired, make a thumbs buffer with all files in current directory."
 423   (interactive)
 424   (thumbs-show-from-dir default-directory nil t))
 425
 426 ;;;###autoload
 427 (defalias 'thumbs 'thumbs-show-from-dir)
 428
 429 (defun thumbs-find-image (img &optional num otherwin)
 430   (let ((buffer (current-buffer)))
 431     (funcall
 432      (if otherwin 'switch-to-buffer-other-window 'switch-to-buffer)
 433      "*Image*")
 434     (thumbs-view-image-mode)
 435     (setq mode-name
 436           (concat "image-view-mode: " (file-name-nondirectory img)
 437                   " - " (number-to-string num)))
 438     (setq thumbs-buffer buffer)
 439     (let ((inhibit-read-only t))
 440       (setq thumbs-current-image-filename img
 441             thumbs-current-tmp-filename nil
 442             thumbs-image-num (or num 0))
 443       (delete-region (point-min)(point-max))
 444       (save-excursion
 445         (thumbs-insert-image img (thumbs-image-type img) 0)))))
 446
 447 (defun thumbs-find-image-at-point (&optional img otherwin)
 448   "Display image IMG for thumbnail at point.
 449 Use another window if OTHERWIN is t."
 450   (interactive)
 451   (let* ((i (or img (thumbs-current-image))))
 452     (thumbs-find-image i (point) otherwin)))
 453
 454 (defun thumbs-find-image-at-point-other-window ()
 455   "Display image for thumbnail at point in the preview buffer.
 456 Open another window."
 457   (interactive)
 458   (thumbs-find-image-at-point nil t))
 459
 460 (defun thumbs-mouse-find-image (event)
 461   "Display image for thumbnail at mouse click EVENT."
 462   (interactive "e")
 463   (mouse-set-point event)
 464   (thumbs-find-image-at-point))
 465
 466 (defun thumbs-call-setroot-command (img)
 467   "Call the setroot program for IMG."
 468   (run-hooks 'thumbs-before-setroot-hook)
 469   (shell-command (replace-regexp-in-string
 470                   "\\*"
 471                   (shell-quote-argument (expand-file-name img))
 472                   thumbs-setroot-command nil t))
 473   (run-hooks 'thumbs-after-setroot-hook))
 474
 475 (defun thumbs-set-image-at-point-to-root-window ()
 476   "Set the image at point as the desktop wallpaper."
 477   (interactive)
 478   (thumbs-call-setroot-command
 479    (thumbs-current-image)))
 480
 481 (defun thumbs-set-root ()
 482   "Set the current image as root."
 483   (interactive)
 484   (thumbs-call-setroot-command
 485    (or thumbs-current-tmp-filename
 486        thumbs-current-image-filename)))
 487
 488 (defun thumbs-file-alist ()
 489   "Make an alist of elements (POS . FILENAME) for all images in thumb buffer."
 490   (with-current-buffer thumbs-buffer
 491     (save-excursion
 492       (let (list)
 493         (goto-char (point-min))
 494         (while (not (eobp))
 495           (unless (eolp)
 496             (if (thumbs-current-image)
 497                 (push (cons (point-marker)
 498                             (thumbs-current-image))
 499                     list)))
 500           (forward-char 1))
 501         (nreverse list)))))
 502
 503 (defun thumbs-file-list ()
 504   "Make a list of file names for all images in thumb buffer."
 505   (save-excursion
 506     (let (list)
 507       (goto-char (point-min))
 508       (while (not (eobp))
 509         (if (thumbs-current-image)
 510             (push (thumbs-current-image) list))
 511         (forward-char 1))
 512       (nreverse list))))
 513
 514 (defun thumbs-delete-images ()
 515   "Delete the image at point (and its thumbnail) (or marked files if any)."
 516   (interactive)
 517   (let ((files (or thumbs-marked-list (list (thumbs-current-image)))))
 518     (if (yes-or-no-p (format "Really delete %d files? " (length files)))
 519         (let ((thumbs-file-list (thumbs-file-alist))
 520               (inhibit-read-only t))
 521           (dolist (x files)
 522             (let (failure)
 523               (condition-case ()
 524                   (progn
 525                     (delete-file x)
 526                     (delete-file (thumbs-thumbname x)))
 527                 (file-error (setq failure t)))
 528               (unless failure
 529                 (when (rassoc x thumbs-file-list)
 530                   (goto-char (car (rassoc x thumbs-file-list)))
 531                   (delete-region (point) (1+ (point))))
 532                 (setq thumbs-marked-list
 533                       (delq x thumbs-marked-list)))))))))
 534
 535 (defun thumbs-rename-images (newfile)
 536   "Rename the image at point (and its thumbnail) (or marked files if any)."
 537   (interactive "FRename to file or directory: ")
 538   (let ((files (or thumbs-marked-list (list (thumbs-current-image))))
 539         failures)
 540     (if (and (not (file-directory-p newfile))
 541              thumbs-marked-list)
 542         (if (file-exists-p newfile)
 543             (error "Renaming marked files to file name `%s'" newfile)
 544           (make-directory newfile t)))
 545     (if (yes-or-no-p (format "Really rename %d files? " (length files)))
 546         (let ((thumbs-file-list (thumbs-file-alist))
 547               (inhibit-read-only t))
 548           (dolist (file files)
 549             (let (failure)
 550               (condition-case ()
 551                   (if (file-directory-p newfile)
 552                       (rename-file file
 553                                    (expand-file-name
 554                                     (file-name-nondirectory file)
 555                                     newfile))
 556                     (rename-file file newfile))
 557                 (file-error (setq failure t)
 558                             (push file failures)))
 559               (unless failure
 560                 (when (rassoc file thumbs-file-list)
 561                   (goto-char (car (rassoc file thumbs-file-list)))
 562                   (delete-region (point) (1+ (point))))
 563                 (setq thumbs-marked-list
 564                       (delq file thumbs-marked-list)))))))
 565     (if failures
 566         (display-warning 'file-error
 567                          (format "Rename failures for %s into %s"
 568                                  failures newfile)
 569                          :error))))
 570
 571 (defun thumbs-kill-buffer ()
 572   "Kill the current buffer."
 573   (interactive)
 574   (quit-window t (selected-window)))
 575
 576 (defun thumbs-show-image-num (num)
 577   "Show the image with number NUM."
 578   (let ((image-buffer (get-buffer-create "*Image*")))
 579     (let ((img (cdr (nth (1- num) (thumbs-file-alist)))))
 580       (with-current-buffer image-buffer
 581         (setq mode-name
 582               (concat "image-view-mode: " (file-name-nondirectory img)
 583                       " - " (number-to-string num)))
 584         (let ((inhibit-read-only t))
 585           (erase-buffer)
 586           (thumbs-insert-image img (thumbs-image-type img) 0)
 587           (goto-char (point-min))))
 588       (setq thumbs-image-num num
 589             thumbs-current-image-filename img))))
 590
 591 (defun thumbs-previous-image ()
 592   "Show the previous image."
 593   (interactive)
 594   (let* ((i (- thumbs-image-num 1))
 595          (number (length (thumbs-file-alist))))
 596     (if (= i 0) (setq i (1- number)))
 597     (thumbs-show-image-num i)))
 598
 599 (defun thumbs-next-image ()
 600   "Show the next image."
 601   (interactive)
 602   (let* ((i (1+ thumbs-image-num))
 603          (number (length (thumbs-file-alist))))
 604     (if (= i number) (setq i 1))
 605     (thumbs-show-image-num i)))
 606
 607 (defun thumbs-display-thumbs-buffer ()
 608   "Display the associated thumbs buffer."
 609   (interactive)
 610   (display-buffer thumbs-buffer))
 611
 612 (defun thumbs-redraw-buffer ()
 613   "Redraw the current thumbs buffer."
 614   (let ((p (point))
 615         (inhibit-read-only t)
 616         (files (thumbs-file-list)))
 617     (erase-buffer)
 618     (thumbs-do-thumbs-insertion files)
 619     (goto-char p)))
 620
 621 (defun thumbs-mark ()
 622   "Mark the image at point."
 623   (interactive)
 624   (let ((elt (thumbs-current-image)))
 625     (unless elt
 626       (error "No image here"))
 627     (push elt thumbs-marked-list)
 628     (let ((inhibit-read-only t))
 629       (delete-char 1)
 630       (thumbs-insert-thumb elt t)))
 631   (when (eolp) (forward-char)))
 632
 633 (defun thumbs-unmark ()
 634   "Unmark the image at point."
 635   (interactive)
 636   (let ((elt (thumbs-current-image)))
 637     (unless elt
 638       (error "No image here"))
 639     (setq thumbs-marked-list (delete elt thumbs-marked-list))
 640     (let ((inhibit-read-only t))
 641       (delete-char 1)
 642       (thumbs-insert-thumb elt nil)))
 643   (when (eolp) (forward-char)))
 644
 645 ;; cleaning of old temp files
 646 (mapc 'delete-file
 647       (directory-files (thumbs-temp-dir) t thumbs-temp-prefix))
 648
 649 ;; Image modification routines
 650
 651 (defun thumbs-modify-image (action &optional arg)
 652   "Call convert to do ACTION on image with argument ARG.
 653 ACTION and ARG should be a valid convert command."
 654   (interactive "sAction: \nsValue: ")
 655   (let* ((buffer-read-only nil)
 656          (old thumbs-current-tmp-filename)
 657          (tmp (thumbs-temp-file)))
 658     (erase-buffer)
 659     (thumbs-call-convert (or old thumbs-current-image-filename)
 660                          tmp
 661                          action
 662                          (or arg ""))
 663     (save-excursion
 664       (thumbs-insert-image tmp 'jpeg 0))
 665     (setq thumbs-current-tmp-filename tmp)))
 666
 667 (defun thumbs-emboss-image (emboss)
 668   "Emboss the image with value EMBOSS."
 669   (interactive "nEmboss value: ")
 670   (if (or (< emboss 3) (> emboss 31) (zerop (% emboss 2)))
 671       (error "Arg must be an odd number between 3 and 31"))
 672   (thumbs-modify-image "emboss" (number-to-string emboss)))
 673
 674 (defun thumbs-monochrome-image ()
 675   "Turn the image to monochrome."
 676   (interactive)
 677   (thumbs-modify-image "monochrome"))
 678
 679 (defun thumbs-negate-image ()
 680   "Negate the image."
 681   (interactive)
 682   (thumbs-modify-image "negate"))
 683
 684 (defun thumbs-rotate-left ()
 685   "Rotate the image 90 degrees counter-clockwise."
 686   (interactive)
 687   (thumbs-modify-image "rotate" "270"))
 688
 689 (defun thumbs-rotate-right ()
 690   "Rotate the image 90 degrees clockwise."
 691   (interactive)
 692   (thumbs-modify-image "rotate" "90"))
 693
 694 (defun thumbs-current-image ()
 695   "Return the name of the image file name at point."
 696   (get-text-property (point) 'thumb-image-file))
 697
 698 (defun thumbs-forward-char ()
 699   "Move forward one image."
 700   (interactive)
 701   (forward-char)
 702   (while (and (not (eobp)) (not (thumbs-current-image)))
 703     (forward-char))
 704   (thumbs-show-name))
 705
 706 (defun thumbs-backward-char ()
 707   "Move backward one image."
 708   (interactive)
 709   (forward-char -1)
 710   (while (and (not (bobp)) (not (thumbs-current-image)))
 711     (forward-char -1))
 712   (thumbs-show-name))
 713
 714 (defun thumbs-backward-line ()
 715   "Move up one line."
 716   (interactive)
 717   (forward-line -1)
 718   (thumbs-show-name))
 719
 720 (defun thumbs-forward-line ()
 721   "Move down one line."
 722   (interactive)
 723   (forward-line 1)
 724   (thumbs-show-name))
 725
 726 (defun thumbs-show-more-images (&optional arg)
 727   "Show more than `thumbs-max-image-number' images, if present."
 728   (interactive "P")
 729   (or arg (setq arg 1))
 730   (setq thumbs-extra-images (+ thumbs-extra-images arg))
 731   (thumbs-dired-show))
 732
 733 (defun thumbs-show-name ()
 734   "Show the name of the current file."
 735   (interactive)
 736   (let ((f (thumbs-current-image)))
 737     (and f (message "%s [%s]" f (thumbs-file-size f)))))
 738
 739 (defun thumbs-save-current-image ()
 740   "Save the current image."
 741   (interactive)
 742   (let ((f (or thumbs-current-tmp-filename
 743                thumbs-current-image-filename))
 744         (sa (read-from-minibuffer "Save image file as: "
 745                                   thumbs-current-image-filename)))
 746     (copy-file f sa)))
 747
 748 (defun thumbs-dired ()
 749   "Use `dired' on the current thumbs directory."
 750   (interactive)
 751   (dired thumbs-current-dir))
 752
 753 ;; thumbs-mode
 754
 755 (defvar thumbs-mode-map
 756   (let ((map (make-sparse-keymap)))
 757     (define-key map [return] 'thumbs-find-image-at-point)
 758     (define-key map [mouse-2] 'thumbs-mouse-find-image)
 759     (define-key map [(meta return)] 'thumbs-find-image-at-point-other-window)
 760     (define-key map [(control return)] 'thumbs-set-image-at-point-to-root-window)
 761     (define-key map [delete] 'thumbs-delete-images)
 762     (define-key map [right] 'thumbs-forward-char)
 763     (define-key map [left] 'thumbs-backward-char)
 764     (define-key map [up] 'thumbs-backward-line)
 765     (define-key map [down] 'thumbs-forward-line)
 766     (define-key map "+" 'thumbs-show-more-images)
 767     (define-key map "d" 'thumbs-dired)
 768     (define-key map "m" 'thumbs-mark)
 769     (define-key map "u" 'thumbs-unmark)
 770     (define-key map "R" 'thumbs-rename-images)
 771     (define-key map "x" 'thumbs-delete-images)
 772     (define-key map "s" 'thumbs-show-name)
 773     (define-key map "q" 'thumbs-kill-buffer)
 774     map)
 775   "Keymap for `thumbs-mode'.")
 776
 777 (put 'thumbs-mode 'mode-class 'special)
 778 (define-derived-mode thumbs-mode
 779   fundamental-mode "thumbs"
 780   "Preview images in a thumbnails buffer"
 781   (setq buffer-read-only t))
 782
 783 (defvar thumbs-view-image-mode-map
 784   (let ((map (make-sparse-keymap)))
 785     (define-key map [prior] 'thumbs-previous-image)
 786     (define-key map [next] 'thumbs-next-image)
 787     (define-key map "^" 'thumbs-display-thumbs-buffer)
 788     (define-key map "-" 'thumbs-shrink-image)
 789     (define-key map "+" 'thumbs-enlarge-image)
 790     (define-key map "<" 'thumbs-rotate-left)
 791     (define-key map ">" 'thumbs-rotate-right)
 792     (define-key map "e" 'thumbs-emboss-image)
 793     (define-key map "r" 'thumbs-resize-image)
 794     (define-key map "s" 'thumbs-save-current-image)
 795     (define-key map "q" 'thumbs-kill-buffer)
 796     (define-key map "w" 'thumbs-set-root)
 797     map)
 798   "Keymap for `thumbs-view-image-mode'.")
 799
 800 ;; thumbs-view-image-mode
 801 (put 'thumbs-view-image-mode 'mode-class 'special)
 802 (define-derived-mode thumbs-view-image-mode
 803   fundamental-mode "image-view-mode"
 804   (setq buffer-read-only t))
 805
 806 ;;;###autoload
 807 (defun thumbs-dired-setroot ()
 808   "In dired, call the setroot program on the image at point."
 809   (interactive)
 810   (thumbs-call-setroot-command (dired-get-filename)))
 811
 812 ;; Modif to dired mode map
 813 (define-key dired-mode-map "\C-ta" 'thumbs-dired-show)
 814 (define-key dired-mode-map "\C-tm" 'thumbs-dired-show-marked)
 815 (define-key dired-mode-map "\C-tw" 'thumbs-dired-setroot)
 816
 817 (provide 'thumbs)
 818
 819 ;; arch-tag: f9ac1ef8-83fc-42c0-8069-1fae43fd2e5c
 820 ;;; thumbs.el ends here