Commit | Line | Data |
---|---|---|
7840ced1 GM |
1 | ;;; image.el --- image API |
2 | ||
ba318903 | 3 | ;; Copyright (C) 1998-2014 Free Software Foundation, Inc. |
634f4a67 | 4 | |
34dc21db | 5 | ;; Maintainer: emacs-devel@gnu.org |
04799cf5 | 6 | ;; Keywords: multimedia |
bd78fa1d | 7 | ;; Package: emacs |
7840ced1 GM |
8 | |
9 | ;; This file is part of GNU Emacs. | |
10 | ||
eb3fa2cf | 11 | ;; GNU Emacs is free software: you can redistribute it and/or modify |
7840ced1 | 12 | ;; it under the terms of the GNU General Public License as published by |
eb3fa2cf GM |
13 | ;; the Free Software Foundation, either version 3 of the License, or |
14 | ;; (at your option) any later version. | |
7840ced1 GM |
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 | |
eb3fa2cf | 22 | ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
7840ced1 GM |
23 | |
24 | ;;; Commentary: | |
25 | ||
26 | ;;; Code: | |
27 | ||
77f6105c MB |
28 | |
29 | (defgroup image () | |
30 | "Image support." | |
31 | :group 'multimedia) | |
32 | ||
110683ad | 33 | (defalias 'image-refresh 'image-flush) |
77f6105c | 34 | |
4fde92ef | 35 | (defconst image-type-header-regexps |
62564fc7 | 36 | `(("\\`/[\t\n\r ]*\\*.*XPM.\\*/" . xpm) |
0e7690de CB |
37 | ("\\`P[1-6]\\\(?:\ |
38 | \\(?:\\(?:#[^\r\n]*[\r\n]\\)?[[:space:]]\\)+\ | |
39 | \\(?:\\(?:#[^\r\n]*[\r\n]\\)?[0-9]\\)+\ | |
40 | \\)\\{2\\}" . pbm) | |
3205431d | 41 | ("\\`GIF8[79]a" . gif) |
6642c904 | 42 | ("\\`\x89PNG\r\n\x1a\n" . png) |
fa4354c1 AS |
43 | ("\\`[\t\n\r ]*#define \\([a-z0-9_]+\\)_width [0-9]+\n\ |
44 | #define \\1_height [0-9]+\n\\(\ | |
45 | #define \\1_x_hot [0-9]+\n\ | |
46 | #define \\1_y_hot [0-9]+\n\\)?\ | |
47 | static \\(unsigned \\)?char \\1_bits" . xbm) | |
6642c904 JB |
48 | ("\\`\\(?:MM\0\\*\\|II\\*\0\\)" . tiff) |
49 | ("\\`[\t\n\r ]*%!PS" . postscript) | |
d30a05d1 | 50 | ("\\`\xff\xd8" . jpeg) ; used to be (image-jpeg-p . jpeg) |
62564fc7 JL |
51 | (,(let* ((incomment-re "\\(?:[^-]\\|-[^-]\\)") |
52 | (comment-re (concat "\\(?:!--" incomment-re "*-->[ \t\r\n]*<\\)"))) | |
53 | (concat "\\(?:<\\?xml[ \t\r\n]+[^>]*>\\)?[ \t\r\n]*<" | |
54 | comment-re "*" | |
55 | "\\(?:!DOCTYPE[ \t\r\n]+[^>]*>[ \t\r\n]*<[ \t\r\n]*" comment-re "*\\)?" | |
56 | "[Ss][Vv][Gg]")) | |
57 | . svg) | |
58 | ) | |
6642c904 | 59 | "Alist of (REGEXP . IMAGE-TYPE) pairs used to auto-detect image types. |
7840ced1 | 60 | When the first bytes of an image file match REGEXP, it is assumed to |
6642c904 JB |
61 | be of image type IMAGE-TYPE if IMAGE-TYPE is a symbol. If not a symbol, |
62 | IMAGE-TYPE must be a pair (PREDICATE . TYPE). PREDICATE is called | |
63 | with one argument, a string containing the image data. If PREDICATE returns | |
64 | a non-nil value, TYPE is the image's type.") | |
8a8ef149 | 65 | |
5fd62452 | 66 | (defvar image-type-file-name-regexps |
4fde92ef KS |
67 | '(("\\.png\\'" . png) |
68 | ("\\.gif\\'" . gif) | |
69 | ("\\.jpe?g\\'" . jpeg) | |
70 | ("\\.bmp\\'" . bmp) | |
71 | ("\\.xpm\\'" . xpm) | |
72 | ("\\.pbm\\'" . pbm) | |
73 | ("\\.xbm\\'" . xbm) | |
74 | ("\\.ps\\'" . postscript) | |
62564fc7 JL |
75 | ("\\.tiff?\\'" . tiff) |
76 | ("\\.svgz?\\'" . svg) | |
77 | ) | |
4fde92ef KS |
78 | "Alist of (REGEXP . IMAGE-TYPE) pairs used to identify image files. |
79 | When the name of an image file match REGEXP, it is assumed to | |
80 | be of image type IMAGE-TYPE.") | |
81 | ||
a9bb04bb CY |
82 | ;; We rely on `auto-mode-alist' to detect xbm and xpm files, instead |
83 | ;; of content autodetection. Their contents are just C code, so it is | |
84 | ;; easy to generate false matches. | |
6642c904 JB |
85 | (defvar image-type-auto-detectable |
86 | '((pbm . t) | |
a9bb04bb | 87 | (xbm . nil) |
6642c904 JB |
88 | (bmp . maybe) |
89 | (gif . maybe) | |
90 | (png . maybe) | |
a9bb04bb | 91 | (xpm . nil) |
6642c904 JB |
92 | (jpeg . maybe) |
93 | (tiff . maybe) | |
62564fc7 | 94 | (svg . maybe) |
6642c904 JB |
95 | (postscript . nil)) |
96 | "Alist of (IMAGE-TYPE . AUTODETECT) pairs used to auto-detect image files. | |
97 | \(See `image-type-auto-detected-p'). | |
98 | ||
99 | AUTODETECT can be | |
100 | - t always auto-detect. | |
101 | - nil never auto-detect. | |
102 | - maybe auto-detect only if the image type is available | |
103 | (see `image-type-available-p').") | |
4fde92ef | 104 | |
c6b7ccaa | 105 | (defvar image-format-suffixes |
8259030d | 106 | '((image/x-icon "ico")) |
7b997b14 | 107 | "An alist associating image types with file name suffixes. |
8259030d | 108 | This is used as a hint by the ImageMagick library when detecting |
7b997b14 GM |
109 | the type of image data (that does not have an associated file name). |
110 | Each element has the form (MIME-CONTENT-TYPE EXTENSION). | |
111 | If `create-image' is called with a :format attribute whose value | |
112 | equals a content-type found in this list, the ImageMagick library is | |
113 | told that the data would have the associated suffix if saved to a file.") | |
8259030d | 114 | |
45448e64 SM |
115 | (defcustom image-load-path |
116 | (list (file-name-as-directory (expand-file-name "images" data-directory)) | |
117 | 'data-directory 'load-path) | |
5fc5ac38 | 118 | "List of locations in which to search for image files. |
93a75651 CY |
119 | If an element is a string, it defines a directory to search. |
120 | If an element is a variable symbol whose value is a string, that | |
121 | value defines a directory to search. | |
122 | If an element is a variable symbol whose value is a list, the | |
7a4bc7be XF |
123 | value is used as a list of directories to search. |
124 | ||
125 | Subdirectories are not automatically included in the search." | |
45448e64 SM |
126 | :type '(repeat (choice directory variable)) |
127 | :initialize 'custom-initialize-delay) | |
dada660a | 128 | |
5248a565 | 129 | |
20c65d08 | 130 | (defun image-load-path-for-library (library image &optional path no-error) |
ae77c7ff | 131 | "Return a suitable search path for images used by LIBRARY. |
7c565097 | 132 | |
40db64d2 | 133 | It searches for IMAGE in `image-load-path' (excluding |
c0696e1b BW |
134 | \"`data-directory'/images\") and `load-path', followed by a path |
135 | suitable for LIBRARY, which includes \"../../etc/images\" and | |
136 | \"../etc/images\" relative to the library file itself, and then | |
137 | in \"`data-directory'/images\". | |
7c565097 | 138 | |
5248a565 BW |
139 | Then this function returns a list of directories which contains |
140 | first the directory in which IMAGE was found, followed by the | |
68ba6c49 | 141 | value of `load-path'. If PATH is given, it is used instead of |
5248a565 | 142 | `load-path'. |
20c65d08 | 143 | |
5248a565 | 144 | If NO-ERROR is non-nil and a suitable path can't be found, don't |
68ba6c49 | 145 | signal an error. Instead, return a list of directories as before, |
5248a565 | 146 | except that nil appears in place of the image directory. |
7c565097 BW |
147 | |
148 | Here is an example that uses a common idiom to provide | |
149 | compatibility with versions of Emacs that lack the variable | |
150 | `image-load-path': | |
151 | ||
9f036d33 BW |
152 | ;; Shush compiler. |
153 | (defvar image-load-path) | |
5248a565 BW |
154 | |
155 | (let* ((load-path (image-load-path-for-library \"mh-e\" \"mh-logo.xpm\")) | |
9f036d33 BW |
156 | (image-load-path (cons (car load-path) |
157 | (when (boundp 'image-load-path) | |
158 | image-load-path)))) | |
5248a565 | 159 | (mh-tool-bar-folder-buttons-init))" |
7c565097 BW |
160 | (unless library (error "No library specified")) |
161 | (unless image (error "No image specified")) | |
c0696e1b BW |
162 | (let (image-directory image-directory-load-path) |
163 | ;; Check for images in image-load-path or load-path. | |
164 | (let ((img image) | |
165 | (dir (or | |
166 | ;; Images in image-load-path. | |
167 | (image-search-load-path image) | |
168 | ;; Images in load-path. | |
169 | (locate-library image))) | |
170 | parent) | |
171 | ;; Since the image might be in a nested directory (for | |
172 | ;; example, mail/attach.pbm), adjust `image-directory' | |
173 | ;; accordingly. | |
174 | (when dir | |
175 | (setq dir (file-name-directory dir)) | |
176 | (while (setq parent (file-name-directory img)) | |
177 | (setq img (directory-file-name parent) | |
178 | dir (expand-file-name "../" dir)))) | |
179 | (setq image-directory-load-path dir)) | |
180 | ||
44e97401 | 181 | ;; If `image-directory-load-path' isn't Emacs's image directory, |
c0696e1b BW |
182 | ;; it's probably a user preference, so use it. Then use a |
183 | ;; relative setting if possible; otherwise, use | |
184 | ;; `image-directory-load-path'. | |
7c565097 | 185 | (cond |
c0696e1b BW |
186 | ;; User-modified image-load-path? |
187 | ((and image-directory-load-path | |
188 | (not (equal image-directory-load-path | |
189 | (file-name-as-directory | |
190 | (expand-file-name "images" data-directory))))) | |
191 | (setq image-directory image-directory-load-path)) | |
7c565097 BW |
192 | ;; Try relative setting. |
193 | ((let (library-name d1ei d2ei) | |
194 | ;; First, find library in the load-path. | |
195 | (setq library-name (locate-library library)) | |
196 | (if (not library-name) | |
197 | (error "Cannot find library %s in load-path" library)) | |
198 | ;; And then set image-directory relative to that. | |
199 | (setq | |
200 | ;; Go down 2 levels. | |
c0696e1b BW |
201 | d2ei (file-name-as-directory |
202 | (expand-file-name | |
203 | (concat (file-name-directory library-name) "../../etc/images"))) | |
7c565097 | 204 | ;; Go down 1 level. |
c0696e1b BW |
205 | d1ei (file-name-as-directory |
206 | (expand-file-name | |
207 | (concat (file-name-directory library-name) "../etc/images")))) | |
7c565097 BW |
208 | (setq image-directory |
209 | ;; Set it to nil if image is not found. | |
210 | (cond ((file-exists-p (expand-file-name image d2ei)) d2ei) | |
211 | ((file-exists-p (expand-file-name image d1ei)) d1ei))))) | |
44e97401 | 212 | ;; Use Emacs's image directory. |
c0696e1b BW |
213 | (image-directory-load-path |
214 | (setq image-directory image-directory-load-path)) | |
20c65d08 | 215 | (no-error |
20c65d08 | 216 | (message "Could not find image %s for library %s" image library)) |
7c565097 BW |
217 | (t |
218 | (error "Could not find image %s for library %s" image library))) | |
219 | ||
5248a565 BW |
220 | ;; Return an augmented `path' or `load-path'. |
221 | (nconc (list image-directory) | |
222 | (delete image-directory (copy-sequence (or path load-path)))))) | |
223 | ||
7c565097 | 224 | |
b4ac6e8c GM |
225 | ;; Used to be in image-type-header-regexps, but now not used anywhere |
226 | ;; (since 2009-08-28). | |
8a8ef149 | 227 | (defun image-jpeg-p (data) |
9b78a6a3 RS |
228 | "Value is non-nil if DATA, a string, consists of JFIF image data. |
229 | We accept the tag Exif because that is the same format." | |
24c23999 JB |
230 | (setq data (ignore-errors (string-to-unibyte data))) |
231 | (when (and data (string-match-p "\\`\xff\xd8" data)) | |
8a8ef149 GM |
232 | (catch 'jfif |
233 | (let ((len (length data)) (i 2)) | |
234 | (while (< i len) | |
235 | (when (/= (aref data i) #xff) | |
236 | (throw 'jfif nil)) | |
237 | (setq i (1+ i)) | |
238 | (when (>= (+ i 2) len) | |
239 | (throw 'jfif nil)) | |
240 | (let ((nbytes (+ (lsh (aref data (+ i 1)) 8) | |
4a9bf8a4 GM |
241 | (aref data (+ i 2)))) |
242 | (code (aref data i))) | |
243 | (when (and (>= code #xe0) (<= code #xef)) | |
8a8ef149 | 244 | ;; APP0 LEN1 LEN2 "JFIF\0" |
71296446 | 245 | (throw 'jfif |
24c23999 JB |
246 | (string-match-p "JFIF\\|Exif" |
247 | (substring data i (min (+ i nbytes) len))))) | |
3bdbead3 | 248 | (setq i (+ i 1 nbytes)))))))) |
7840ced1 GM |
249 | |
250 | ||
251 | ;;;###autoload | |
162dec01 GM |
252 | (defun image-type-from-data (data) |
253 | "Determine the image type from image data DATA. | |
254 | Value is a symbol specifying the image type or nil if type cannot | |
7840ced1 | 255 | be determined." |
4fde92ef | 256 | (let ((types image-type-header-regexps) |
7840ced1 | 257 | type) |
4fde92ef | 258 | (while types |
7840ced1 | 259 | (let ((regexp (car (car types))) |
6642c904 | 260 | (image-type (cdr (car types)))) |
4fde92ef | 261 | (if (or (and (symbolp image-type) |
24c23999 | 262 | (string-match-p regexp data)) |
4fde92ef KS |
263 | (and (consp image-type) |
264 | (funcall (car image-type) data) | |
265 | (setq image-type (cdr image-type)))) | |
266 | (setq type image-type | |
267 | types nil) | |
268 | (setq types (cdr types))))) | |
269 | type)) | |
270 | ||
271 | ||
272 | ;;;###autoload | |
6642c904 | 273 | (defun image-type-from-buffer () |
4fde92ef | 274 | "Determine the image type from data in the current buffer. |
6642c904 JB |
275 | Value is a symbol specifying the image type or nil if type cannot |
276 | be determined." | |
4fde92ef KS |
277 | (let ((types image-type-header-regexps) |
278 | type | |
279 | (opoint (point))) | |
280 | (goto-char (point-min)) | |
281 | (while types | |
282 | (let ((regexp (car (car types))) | |
6642c904 | 283 | (image-type (cdr (car types))) |
4fde92ef KS |
284 | data) |
285 | (if (or (and (symbolp image-type) | |
24c23999 | 286 | (looking-at-p regexp)) |
4fde92ef KS |
287 | (and (consp image-type) |
288 | (funcall (car image-type) | |
289 | (or data | |
290 | (setq data | |
291 | (buffer-substring | |
292 | (point-min) | |
293 | (min (point-max) | |
294 | (+ (point-min) 256)))))) | |
295 | (setq image-type (cdr image-type)))) | |
6642c904 | 296 | (setq type image-type |
4fde92ef KS |
297 | types nil) |
298 | (setq types (cdr types))))) | |
299 | (goto-char opoint) | |
dce04f7f | 300 | (and type |
67645389 | 301 | (boundp 'image-types) |
dce04f7f CY |
302 | (memq type image-types) |
303 | type))) | |
7840ced1 GM |
304 | |
305 | ||
162dec01 GM |
306 | ;;;###autoload |
307 | (defun image-type-from-file-header (file) | |
308 | "Determine the type of image file FILE from its first few bytes. | |
309 | Value is a symbol specifying the image type, or nil if type cannot | |
310 | be determined." | |
4fde92ef KS |
311 | (unless (or (file-readable-p file) |
312 | (file-name-absolute-p file)) | |
313 | (setq file (image-search-load-path file))) | |
314 | (and file | |
315 | (file-readable-p file) | |
316 | (with-temp-buffer | |
317 | (set-buffer-multibyte nil) | |
318 | (insert-file-contents-literally file nil 0 256) | |
6642c904 | 319 | (image-type-from-buffer)))) |
4fde92ef KS |
320 | |
321 | ||
322 | ;;;###autoload | |
323 | (defun image-type-from-file-name (file) | |
324 | "Determine the type of image file FILE from its name. | |
325 | Value is a symbol specifying the image type, or nil if type cannot | |
326 | be determined." | |
ea1d4aac | 327 | (let (type first) |
11fef14a GM |
328 | (catch 'found |
329 | (dolist (elem image-type-file-name-regexps first) | |
330 | (when (string-match-p (car elem) file) | |
331 | (if (image-type-available-p (setq type (cdr elem))) | |
332 | (throw 'found type) | |
333 | ;; If nothing seems to be supported, return first type that matched. | |
334 | (or first (setq first type)))))))) | |
162dec01 | 335 | |
7840ced1 | 336 | ;;;###autoload |
7d88e015 | 337 | (defun image-type (source &optional type data-p) |
e7968373 | 338 | "Determine and return image type. |
7d88e015 | 339 | SOURCE is an image file name or image data. |
7840ced1 | 340 | Optional TYPE is a symbol describing the image type. If TYPE is omitted |
162dec01 | 341 | or nil, try to determine the image type from its first few bytes |
7d88e015 | 342 | of image data. If that doesn't work, and SOURCE is a file name, |
9ea8de1b | 343 | use its file extension as image type. |
7d88e015 CY |
344 | Optional DATA-P non-nil means SOURCE is a string containing image data." |
345 | (when (and (not data-p) (not (stringp source))) | |
346 | (error "Invalid image file name `%s'" source)) | |
162dec01 | 347 | (unless type |
7d88e015 CY |
348 | (setq type (if data-p |
349 | (image-type-from-data source) | |
350 | (or (image-type-from-file-header source) | |
351 | (image-type-from-file-name source)))) | |
352 | (or type (error "Cannot determine image type"))) | |
28681e35 | 353 | (or (memq type (and (boundp 'image-types) image-types)) |
7d88e015 | 354 | (error "Invalid image type `%s'" type)) |
e7968373 KS |
355 | type) |
356 | ||
6642c904 | 357 | |
82ff1d13 GM |
358 | (if (fboundp 'image-metadata) ; eg not --without-x |
359 | (define-obsolete-function-alias 'image-extension-data | |
360 | 'image-metadata' "24.1")) | |
361 | ||
2e288d54 JB |
362 | (define-obsolete-variable-alias |
363 | 'image-library-alist | |
364 | 'dynamic-library-alist "24.1") | |
aa360da1 | 365 | |
e7968373 KS |
366 | ;;;###autoload |
367 | (defun image-type-available-p (type) | |
368 | "Return non-nil if image type TYPE is available. | |
369 | Image types are symbols like `xbm' or `jpeg'." | |
370 | (and (fboundp 'init-image-library) | |
d07ff9db | 371 | (init-image-library type))) |
e7968373 KS |
372 | |
373 | ||
6642c904 JB |
374 | ;;;###autoload |
375 | (defun image-type-auto-detected-p () | |
4837b516 | 376 | "Return t if the current buffer contains an auto-detectable image. |
7d88e015 CY |
377 | This function is intended to be used from `magic-fallback-mode-alist'. |
378 | ||
379 | The buffer is considered to contain an auto-detectable image if | |
380 | its beginning matches an image type in `image-type-header-regexps', | |
1e83e2ca GM |
381 | and that image type is present in `image-type-auto-detectable' with a |
382 | non-nil value. If that value is non-nil, but not t, then the image type | |
383 | must be available." | |
6642c904 JB |
384 | (let* ((type (image-type-from-buffer)) |
385 | (auto (and type (cdr (assq type image-type-auto-detectable))))) | |
d567be22 | 386 | (and auto |
7d88e015 | 387 | (or (eq auto t) (image-type-available-p type))))) |
6642c904 JB |
388 | |
389 | ||
e7968373 KS |
390 | ;;;###autoload |
391 | (defun create-image (file-or-data &optional type data-p &rest props) | |
392 | "Create an image. | |
393 | FILE-OR-DATA is an image file name or image data. | |
394 | Optional TYPE is a symbol describing the image type. If TYPE is omitted | |
395 | or nil, try to determine the image type from its first few bytes | |
396 | of image data. If that doesn't work, and FILE-OR-DATA is a file name, | |
397 | use its file extension as image type. | |
398 | Optional DATA-P non-nil means FILE-OR-DATA is a string containing image data. | |
399 | Optional PROPS are additional image attributes to assign to the image, | |
400 | like, e.g. `:mask MASK'. | |
401 | Value is the image created, or nil if images of type TYPE are not supported. | |
402 | ||
2467875c GM |
403 | Images should not be larger than specified by `max-image-size'. |
404 | ||
405 | Image file names that are not absolute are searched for in the | |
406 | \"images\" sub-directory of `data-directory' and | |
407 | `x-bitmap-file-path' (in that order)." | |
408 | ;; It is x_find_image_file in image.c that sets the search path. | |
e7968373 | 409 | (setq type (image-type file-or-data type data-p)) |
7840ced1 | 410 | (when (image-type-available-p type) |
162dec01 GM |
411 | (append (list 'image :type type (if data-p :data :file) file-or-data) |
412 | props))) | |
7840ced1 GM |
413 | |
414 | ||
415 | ;;;###autoload | |
cedbd8d0 | 416 | (defun put-image (image pos &optional string area) |
1571b5ff | 417 | "Put image IMAGE in front of POS in the current buffer. |
7840ced1 | 418 | IMAGE must be an image created with `create-image' or `defimage'. |
46655c94 GM |
419 | IMAGE is displayed by putting an overlay into the current buffer with a |
420 | `before-string' STRING that has a `display' property whose value is the | |
cedbd8d0 | 421 | image. STRING is defaulted if you omit it. |
12dc863d | 422 | The overlay created will have the `put-image' property set to t. |
7840ced1 | 423 | POS may be an integer or marker. |
7840ced1 GM |
424 | AREA is where to display the image. AREA nil or omitted means |
425 | display it in the text area, a value of `left-margin' means | |
426 | display it in the left marginal area, a value of `right-margin' | |
46655c94 | 427 | means display it in the right marginal area." |
0ad550ba | 428 | (unless string (setq string "x")) |
1571b5ff | 429 | (let ((buffer (current-buffer))) |
cedbd8d0 | 430 | (unless (eq (car-safe image) 'image) |
1571b5ff GM |
431 | (error "Not an image: %s" image)) |
432 | (unless (or (null area) (memq area '(left-margin right-margin))) | |
433 | (error "Invalid area %s" area)) | |
46655c94 | 434 | (setq string (copy-sequence string)) |
1571b5ff | 435 | (let ((overlay (make-overlay pos pos buffer)) |
46655c94 GM |
436 | (prop (if (null area) image (list (list 'margin area) image)))) |
437 | (put-text-property 0 (length string) 'display prop string) | |
1571b5ff | 438 | (overlay-put overlay 'put-image t) |
bc72b5d9 LMI |
439 | (overlay-put overlay 'before-string string) |
440 | overlay))) | |
7840ced1 GM |
441 | |
442 | ||
443 | ;;;###autoload | |
5af275e0 | 444 | (defun insert-image (image &optional string area slice) |
7840ced1 | 445 | "Insert IMAGE into current buffer at point. |
46655c94 | 446 | IMAGE is displayed by inserting STRING into the current buffer |
0f0a88b9 | 447 | with a `display' property whose value is the image. STRING |
913c8291 | 448 | defaults to a single space if you omit it. |
7840ced1 GM |
449 | AREA is where to display the image. AREA nil or omitted means |
450 | display it in the text area, a value of `left-margin' means | |
451 | display it in the left marginal area, a value of `right-margin' | |
5af275e0 KS |
452 | means display it in the right marginal area. |
453 | SLICE specifies slice of IMAGE to insert. SLICE nil or omitted | |
454 | means insert whole image. SLICE is a list (X Y WIDTH HEIGHT) | |
455 | specifying the X and Y positions and WIDTH and HEIGHT of image area | |
456 | to insert. A float value 0.0 - 1.0 means relative to the width or | |
457 | height of the image; integer values are taken as pixel values." | |
0ad550ba DL |
458 | ;; Use a space as least likely to cause trouble when it's a hidden |
459 | ;; character in the buffer. | |
460 | (unless string (setq string " ")) | |
cedbd8d0 | 461 | (unless (eq (car-safe image) 'image) |
7840ced1 GM |
462 | (error "Not an image: %s" image)) |
463 | (unless (or (null area) (memq area '(left-margin right-margin))) | |
464 | (error "Invalid area %s" area)) | |
0dc91c57 DL |
465 | (if area |
466 | (setq image (list (list 'margin area) image)) | |
467 | ;; Cons up a new spec equal but not eq to `image' so that | |
468 | ;; inserting it twice in a row (adjacently) displays two copies of | |
469 | ;; the image. Don't try to avoid this by looking at the display | |
470 | ;; properties on either side so that we DTRT more often with | |
471 | ;; cut-and-paste. (Yanking killed image text next to another copy | |
472 | ;; of it loses anyway.) | |
473 | (setq image (cons 'image (cdr image)))) | |
46655c94 GM |
474 | (let ((start (point))) |
475 | (insert string) | |
476 | (add-text-properties start (point) | |
5af275e0 KS |
477 | `(display ,(if slice |
478 | (list (cons 'slice slice) image) | |
479 | image) rear-nonsticky (display))))) | |
480 | ||
481 | ||
f22c36d3 | 482 | ;;;###autoload |
5af275e0 | 483 | (defun insert-sliced-image (image &optional string area rows cols) |
b48bc937 KS |
484 | "Insert IMAGE into current buffer at point. |
485 | IMAGE is displayed by inserting STRING into the current buffer | |
913c8291 GM |
486 | with a `display' property whose value is the image. The default |
487 | STRING is a single space. | |
b48bc937 KS |
488 | AREA is where to display the image. AREA nil or omitted means |
489 | display it in the text area, a value of `left-margin' means | |
490 | display it in the left marginal area, a value of `right-margin' | |
491 | means display it in the right marginal area. | |
68ba6c49 | 492 | The image is automatically split into ROWS x COLS slices." |
5af275e0 KS |
493 | (unless string (setq string " ")) |
494 | (unless (eq (car-safe image) 'image) | |
495 | (error "Not an image: %s" image)) | |
496 | (unless (or (null area) (memq area '(left-margin right-margin))) | |
497 | (error "Invalid area %s" area)) | |
498 | (if area | |
499 | (setq image (list (list 'margin area) image)) | |
500 | ;; Cons up a new spec equal but not eq to `image' so that | |
501 | ;; inserting it twice in a row (adjacently) displays two copies of | |
502 | ;; the image. Don't try to avoid this by looking at the display | |
503 | ;; properties on either side so that we DTRT more often with | |
504 | ;; cut-and-paste. (Yanking killed image text next to another copy | |
505 | ;; of it loses anyway.) | |
506 | (setq image (cons 'image (cdr image)))) | |
507 | (let ((x 0.0) (dx (/ 1.0001 (or cols 1))) | |
508 | (y 0.0) (dy (/ 1.0001 (or rows 1)))) | |
509 | (while (< y 1.0) | |
510 | (while (< x 1.0) | |
511 | (let ((start (point))) | |
512 | (insert string) | |
513 | (add-text-properties start (point) | |
514 | `(display ,(list (list 'slice x y dx dy) image) | |
515 | rear-nonsticky (display))) | |
516 | (setq x (+ x dx)))) | |
517 | (setq x 0.0 | |
518 | y (+ y dy)) | |
82dc617b | 519 | (insert (propertize "\n" 'line-height t))))) |
5af275e0 | 520 | |
10e2102e | 521 | |
7840ced1 GM |
522 | |
523 | ;;;###autoload | |
524 | (defun remove-images (start end &optional buffer) | |
525 | "Remove images between START and END in BUFFER. | |
526 | Remove only images that were put in BUFFER with calls to `put-image'. | |
527 | BUFFER nil or omitted means use the current buffer." | |
528 | (unless buffer | |
529 | (setq buffer (current-buffer))) | |
530 | (let ((overlays (overlays-in start end))) | |
531 | (while overlays | |
532 | (let ((overlay (car overlays))) | |
533 | (when (overlay-get overlay 'put-image) | |
0c898dd9 DL |
534 | (delete-overlay overlay))) |
535 | (setq overlays (cdr overlays))))) | |
7840ced1 | 536 | |
4fde92ef KS |
537 | (defun image-search-load-path (file &optional path) |
538 | (unless path | |
539 | (setq path image-load-path)) | |
540 | (let (element found filename) | |
5fc5ac38 | 541 | (while (and (not found) (consp path)) |
93a75651 | 542 | (setq element (car path)) |
5fc5ac38 | 543 | (cond |
93a75651 | 544 | ((stringp element) |
5fc5ac38 CY |
545 | (setq found |
546 | (file-readable-p | |
4fde92ef | 547 | (setq filename (expand-file-name file element))))) |
93a75651 CY |
548 | ((and (symbolp element) (boundp element)) |
549 | (setq element (symbol-value element)) | |
550 | (cond | |
551 | ((stringp element) | |
552 | (setq found | |
553 | (file-readable-p | |
4fde92ef | 554 | (setq filename (expand-file-name file element))))) |
93a75651 | 555 | ((consp element) |
4fde92ef | 556 | (if (setq filename (image-search-load-path file element)) |
93a75651 | 557 | (setq found t)))))) |
5fc5ac38 | 558 | (setq path (cdr path))) |
4fde92ef | 559 | (if found filename))) |
7840ced1 GM |
560 | |
561 | ;;;###autoload | |
349c034d GM |
562 | (defun find-image (specs) |
563 | "Find an image, choosing one of a list of image specifications. | |
7840ced1 | 564 | |
cedbd8d0 | 565 | SPECS is a list of image specifications. |
7840ced1 GM |
566 | |
567 | Each image specification in SPECS is a property list. The contents of | |
568 | a specification are image type dependent. All specifications must at | |
bc283707 WP |
569 | least contain the properties `:type TYPE' and either `:file FILE' or |
570 | `:data DATA', where TYPE is a symbol specifying the image type, | |
571 | e.g. `xbm', FILE is the file to load the image from, and DATA is a | |
cedbd8d0 DL |
572 | string containing the actual image data. The specification whose TYPE |
573 | is supported, and FILE exists, is used to construct the image | |
574 | specification to be returned. Return nil if no specification is | |
575 | satisfied. | |
576 | ||
8646a62e CY |
577 | The image is looked for in `image-load-path'. |
578 | ||
579 | Image files should not be larger than specified by `max-image-size'." | |
7840ced1 GM |
580 | (let (image) |
581 | (while (and specs (null image)) | |
582 | (let* ((spec (car specs)) | |
583 | (type (plist-get spec :type)) | |
162dec01 | 584 | (data (plist-get spec :data)) |
7f228379 GM |
585 | (file (plist-get spec :file)) |
586 | found) | |
162dec01 GM |
587 | (when (image-type-available-p type) |
588 | (cond ((stringp file) | |
4fde92ef | 589 | (if (setq found (image-search-load-path file)) |
5fc5ac38 CY |
590 | (setq image |
591 | (cons 'image (plist-put (copy-sequence spec) | |
592 | :file found))))) | |
f64ae86c | 593 | ((not (null data)) |
162dec01 GM |
594 | (setq image (cons 'image spec))))) |
595 | (setq specs (cdr specs)))) | |
349c034d GM |
596 | image)) |
597 | ||
598 | ||
599 | ;;;###autoload | |
600 | (defmacro defimage (symbol specs &optional doc) | |
18c9f8a2 | 601 | "Define SYMBOL as an image, and return SYMBOL. |
349c034d GM |
602 | |
603 | SPECS is a list of image specifications. DOC is an optional | |
604 | documentation string. | |
605 | ||
606 | Each image specification in SPECS is a property list. The contents of | |
607 | a specification are image type dependent. All specifications must at | |
608 | least contain the properties `:type TYPE' and either `:file FILE' or | |
609 | `:data DATA', where TYPE is a symbol specifying the image type, | |
610 | e.g. `xbm', FILE is the file to load the image from, and DATA is a | |
611 | string containing the actual image data. The first image | |
612 | specification whose TYPE is supported, and FILE exists, is used to | |
613 | define SYMBOL. | |
614 | ||
615 | Example: | |
616 | ||
617 | (defimage test-image ((:type xpm :file \"~/test1.xpm\") | |
618 | (:type xbm :file \"~/test1.xbm\")))" | |
fd8e7a80 | 619 | (declare (doc-string 3)) |
349c034d | 620 | `(defvar ,symbol (find-image ',specs) ,doc)) |
7840ced1 | 621 | |
0608aa45 KS |
622 | \f |
623 | ;;; Animated image API | |
7840ced1 | 624 | |
99e619b6 GM |
625 | (defvar image-default-frame-delay 0.1 |
626 | "Default interval in seconds between frames of a multi-frame image. | |
627 | Only used if the image does not specify a value.") | |
628 | ||
ed8d7fca GM |
629 | (defun image-multi-frame-p (image) |
630 | "Return non-nil if IMAGE contains more than one frame. | |
631 | The actual return value is a cons (NIMAGES . DELAY), where NIMAGES is | |
632 | the number of frames (or sub-images) in the image and DELAY is the delay | |
633 | in seconds that the image specifies between each frame. DELAY may be nil, | |
634 | in which case you might want to use `image-default-frame-delay'." | |
9019d095 GM |
635 | (when (fboundp 'image-metadata) |
636 | (let* ((metadata (image-metadata image)) | |
637 | (images (plist-get metadata 'count)) | |
638 | (delay (plist-get metadata 'delay))) | |
639 | (when (and images (> images 1)) | |
640 | (if (or (not (numberp delay)) (< delay 0)) | |
641 | (setq delay image-default-frame-delay)) | |
642 | (cons images delay))))) | |
ed8d7fca | 643 | |
dd8620de GM |
644 | (defun image-animated-p (image) |
645 | "Like `image-multi-frame-p', but returns nil if no delay is specified." | |
646 | (let ((multi (image-multi-frame-p image))) | |
647 | (and (cdr multi) multi))) | |
648 | ||
649 | (make-obsolete 'image-animated-p 'image-multi-frame-p "24.4") | |
0608aa45 | 650 | |
eea14f31 | 651 | ;; "Destructively"? |
18af70d0 CY |
652 | (defun image-animate (image &optional index limit) |
653 | "Start animating IMAGE. | |
654 | Animation occurs by destructively altering the IMAGE spec list. | |
655 | ||
656 | With optional INDEX, begin animating from that animation frame. | |
657 | LIMIT specifies how long to animate the image. If omitted or | |
658 | nil, play the animation until the end. If t, loop forever. If a | |
659 | number, play until that number of seconds has elapsed." | |
ed8d7fca | 660 | (let ((animation (image-multi-frame-p image)) |
1100a63c CY |
661 | timer) |
662 | (when animation | |
18af70d0 CY |
663 | (if (setq timer (image-animate-timer image)) |
664 | (cancel-timer timer)) | |
f086804c | 665 | (plist-put (cdr image) :animate-buffer (current-buffer)) |
1100a63c CY |
666 | (run-with-timer 0.2 nil 'image-animate-timeout |
667 | image (or index 0) (car animation) | |
668 | 0 limit)))) | |
0608aa45 KS |
669 | |
670 | (defun image-animate-timer (image) | |
671 | "Return the animation timer for image IMAGE." | |
672 | ;; See cancel-function-timers | |
673 | (let ((tail timer-list) timer) | |
674 | (while tail | |
675 | (setq timer (car tail) | |
676 | tail (cdr tail)) | |
72eac303 PE |
677 | (if (and (eq (timer--function timer) 'image-animate-timeout) |
678 | (eq (car-safe (timer--args timer)) image)) | |
0608aa45 KS |
679 | (setq tail nil) |
680 | (setq timer nil))) | |
681 | timer)) | |
682 | ||
99e619b6 GM |
683 | (defconst image-minimum-frame-delay 0.01 |
684 | "Minimum interval in seconds between frames of an animated image.") | |
685 | ||
dc504515 GM |
686 | (defun image-current-frame (image) |
687 | "The current frame number of IMAGE, indexed from 0." | |
688 | (or (plist-get (cdr image) :index) 0)) | |
bb9dfee1 | 689 | |
dc504515 | 690 | (defun image-show-frame (image n &optional nocheck) |
c0211c4e GM |
691 | "Show frame N of IMAGE. |
692 | Frames are indexed from 0. Optional argument NOCHECK non-nil means | |
693 | do not check N is within the range of frames present in the image." | |
694 | (unless nocheck | |
695 | (if (< n 0) (setq n 0) | |
ed8d7fca | 696 | (setq n (min n (1- (car (image-multi-frame-p image))))))) |
c0211c4e | 697 | (plist-put (cdr image) :index n) |
c0211c4e GM |
698 | (force-window-update)) |
699 | ||
3a2ddc2d GM |
700 | (defun image-animate-get-speed (image) |
701 | "Return the speed factor for animating IMAGE." | |
702 | (or (plist-get (cdr image) :speed) 1)) | |
703 | ||
704 | (defun image-animate-set-speed (image value &optional multiply) | |
705 | "Set the speed factor for animating IMAGE to VALUE. | |
706 | With optional argument MULTIPLY non-nil, treat VALUE as a | |
707 | multiplication factor for the current value." | |
708 | (plist-put (cdr image) :speed | |
709 | (if multiply | |
710 | (* value (image-animate-get-speed image)) | |
711 | value))) | |
712 | ||
eea14f31 | 713 | ;; FIXME? The delay may not be the same for different sub-images, |
ed8d7fca | 714 | ;; hence we need to call image-multi-frame-p to return it. |
eea14f31 GM |
715 | ;; But it also returns count, so why do we bother passing that as an |
716 | ;; argument? | |
1100a63c | 717 | (defun image-animate-timeout (image n count time-elapsed limit) |
e8cbec34 CY |
718 | "Display animation frame N of IMAGE. |
719 | N=0 refers to the initial animation frame. | |
720 | COUNT is the total number of frames in the animation. | |
e8cbec34 CY |
721 | TIME-ELAPSED is the total time that has elapsed since |
722 | `image-animate-start' was called. | |
18af70d0 | 723 | LIMIT determines when to stop. If t, loop forever. If nil, stop |
e8cbec34 | 724 | after displaying the last animation frame. Otherwise, stop |
eea14f31 | 725 | after LIMIT seconds have elapsed. |
3a2ddc2d GM |
726 | The minimum delay between successive frames is `image-minimum-frame-delay'. |
727 | ||
728 | If the image has a non-nil :speed property, it acts as a multiplier | |
729 | for the animation speed. A negative value means to animate in reverse." | |
f086804c GM |
730 | (when (buffer-live-p (plist-get (cdr image) :animate-buffer)) |
731 | (image-show-frame image n t) | |
732 | (let* ((speed (image-animate-get-speed image)) | |
733 | (time (float-time)) | |
734 | (animation (image-multi-frame-p image)) | |
735 | ;; Subtract off the time we took to load the image from the | |
736 | ;; stated delay time. | |
737 | (delay (max (+ (* (or (cdr animation) image-default-frame-delay) | |
738 | (/ 1 (abs speed))) | |
739 | time (- (float-time))) | |
740 | image-minimum-frame-delay)) | |
741 | done) | |
742 | (setq n (if (< speed 0) | |
743 | (1- n) | |
744 | (1+ n))) | |
745 | (if limit | |
746 | (cond ((>= n count) (setq n 0)) | |
747 | ((< n 0) (setq n (1- count)))) | |
748 | (and (or (>= n count) (< n 0)) (setq done t))) | |
749 | (setq time-elapsed (+ delay time-elapsed)) | |
750 | (if (numberp limit) | |
751 | (setq done (>= time-elapsed limit))) | |
752 | (unless done | |
753 | (run-with-timer delay nil 'image-animate-timeout | |
754 | image n count time-elapsed limit))))) | |
0608aa45 KS |
755 | |
756 | \f | |
60b5f187 | 757 | (defvar imagemagick-types-inhibit) |
95f520b5 | 758 | (defvar imagemagick-enabled-types) |
60b5f187 GM |
759 | |
760 | (defun imagemagick-filter-types () | |
761 | "Return a list of the ImageMagick types to be treated as images, or nil. | |
762 | This is the result of `imagemagick-types', including only elements | |
95f520b5 | 763 | that match `imagemagick-enabled-types' and do not match |
60b5f187 GM |
764 | `imagemagick-types-inhibit'." |
765 | (when (fboundp 'imagemagick-types) | |
95f520b5 | 766 | (cond ((null imagemagick-enabled-types) nil) |
60b5f187 | 767 | ((eq imagemagick-types-inhibit t) nil) |
60b5f187 GM |
768 | (t |
769 | (delq nil | |
770 | (mapcar | |
771 | (lambda (type) | |
772 | (unless (memq type imagemagick-types-inhibit) | |
95f520b5 | 773 | (if (eq imagemagick-enabled-types t) type |
43f5c7ae | 774 | (catch 'found |
95f520b5 | 775 | (dolist (enable imagemagick-enabled-types nil) |
43f5c7ae GM |
776 | (if (cond ((symbolp enable) (eq enable type)) |
777 | ((stringp enable) | |
778 | (string-match enable | |
779 | (symbol-name type)))) | |
780 | (throw 'found type))))))) | |
60b5f187 GM |
781 | (imagemagick-types))))))) |
782 | ||
c505aaeb CY |
783 | (defvar imagemagick--file-regexp nil |
784 | "File extension regexp for ImageMagick files, if any. | |
785 | This is the extension installed into `auto-mode-alist' and | |
786 | `image-type-file-name-regexps' by `imagemagick-register-types'.") | |
3de25479 JV |
787 | |
788 | ;;;###autoload | |
ce07fa9a | 789 | (defun imagemagick-register-types () |
d66c4c7c | 790 | "Register file types that can be handled by ImageMagick. |
c505aaeb | 791 | This function is called at startup, after loading the init file. |
60b5f187 | 792 | It registers the ImageMagick types returned by `imagemagick-filter-types'. |
5319014e CY |
793 | |
794 | Registered image types are added to `auto-mode-alist', so that | |
795 | Emacs visits them in Image mode. They are also added to | |
796 | `image-type-file-name-regexps', so that the `image-type' function | |
797 | recognizes these files as having image type `imagemagick'. | |
d66c4c7c | 798 | |
32d72c2f | 799 | If Emacs is compiled without ImageMagick support, this does nothing." |
d66c4c7c | 800 | (when (fboundp 'imagemagick-types) |
60b5f187 GM |
801 | (let* ((types (mapcar (lambda (type) (downcase (symbol-name type))) |
802 | (imagemagick-filter-types))) | |
803 | (re (if types (concat "\\." (regexp-opt types) "\\'"))) | |
32d72c2f GM |
804 | (ama-elt (car (member (cons imagemagick--file-regexp 'image-mode) |
805 | auto-mode-alist))) | |
806 | (itfnr-elt (car (member (cons imagemagick--file-regexp 'imagemagick) | |
807 | image-type-file-name-regexps)))) | |
808 | (if (not re) | |
809 | (setq auto-mode-alist (delete ama-elt auto-mode-alist) | |
810 | image-type-file-name-regexps | |
811 | (delete itfnr-elt image-type-file-name-regexps)) | |
812 | (if ama-elt | |
813 | (setcar ama-elt re) | |
814 | (push (cons re 'image-mode) auto-mode-alist)) | |
815 | (if itfnr-elt | |
816 | (setcar itfnr-elt re) | |
72834e10 CY |
817 | ;; Append to `image-type-file-name-regexps', so that we |
818 | ;; preferentially use specialized image libraries. | |
819 | (add-to-list 'image-type-file-name-regexps | |
820 | (cons re 'imagemagick) t))) | |
c505aaeb CY |
821 | (setq imagemagick--file-regexp re)))) |
822 | ||
041df390 CY |
823 | (defcustom imagemagick-types-inhibit |
824 | '(C HTML HTM INFO M TXT PDF) | |
95f520b5 | 825 | "List of ImageMagick types that should never be treated as images. |
c505aaeb | 826 | This should be a list of symbols, each of which should be one of |
95f520b5 | 827 | the ImageMagick types listed by `imagemagick-types'. The listed |
c505aaeb CY |
828 | image types are not registered by `imagemagick-register-types'. |
829 | ||
830 | If the value is t, inhibit the use of ImageMagick for images. | |
831 | ||
87eb79c2 GM |
832 | If you change this without using customize, you must call |
833 | `imagemagick-register-types' afterwards. | |
834 | ||
c505aaeb CY |
835 | If Emacs is compiled without ImageMagick support, this variable |
836 | has no effect." | |
837 | :type '(choice (const :tag "Support all ImageMagick types" nil) | |
838 | (const :tag "Disable all ImageMagick types" t) | |
839 | (repeat symbol)) | |
32d72c2f | 840 | :initialize 'custom-initialize-default |
c505aaeb CY |
841 | :set (lambda (symbol value) |
842 | (set-default symbol value) | |
843 | (imagemagick-register-types)) | |
2a1e2476 | 844 | :version "24.3" |
c505aaeb | 845 | :group 'image) |
3de25479 | 846 | |
95f520b5 | 847 | (defcustom imagemagick-enabled-types |
47b36b94 | 848 | '(3FR ART ARW AVS BMP BMP2 BMP3 CAL CALS CMYK CMYKA CR2 CRW |
041df390 CY |
849 | CUR CUT DCM DCR DCX DDS DJVU DNG DPX EXR FAX FITS GBR GIF |
850 | GIF87 GRB HRZ ICB ICO ICON J2C JNG JP2 JPC JPEG JPG JPX K25 | |
851 | KDC MIFF MNG MRW MSL MSVG MTV NEF ORF OTB PBM PCD PCDS PCL | |
852 | PCT PCX PDB PEF PGM PICT PIX PJPEG PNG PNG24 PNG32 PNG8 PNM | |
853 | PPM PSD PTIF PWP RAF RAS RBG RGB RGBA RGBO RLA RLE SCR SCT | |
854 | SFW SGI SR2 SRF SUN SVG SVGZ TGA TIFF TIFF64 TILE TIM TTF | |
855 | UYVY VDA VICAR VID VIFF VST WBMP WPG X3F XBM XC XCF XPM XV | |
856 | XWD YCbCr YCbCrA YUV) | |
32d72c2f | 857 | "List of ImageMagick types to treat as images. |
95f520b5 CY |
858 | Each list element should be a string or symbol, representing one |
859 | of the image types returned by `imagemagick-types'. If the | |
860 | element is a string, it is handled as a regexp that enables all | |
861 | matching types. | |
32d72c2f | 862 | |
95f520b5 CY |
863 | The value of `imagemagick-enabled-types' may also be t, meaning |
864 | to enable all types that ImageMagick supports. | |
32d72c2f GM |
865 | |
866 | The variable `imagemagick-types-inhibit' overrides this variable. | |
867 | ||
eda82a31 | 868 | If you change this without using customize, you must call |
32d72c2f GM |
869 | `imagemagick-register-types' afterwards. |
870 | ||
871 | If Emacs is compiled without ImageMagick support, this variable | |
872 | has no effect." | |
873 | :type '(choice (const :tag "Support all ImageMagick types" t) | |
874 | (const :tag "Disable all ImageMagick types" nil) | |
875 | (repeat :tag "List of types" | |
876 | (choice (symbol :tag "type") | |
877 | (regexp :tag "regexp")))) | |
878 | :initialize 'custom-initialize-default | |
879 | :set (lambda (symbol value) | |
880 | (set-default symbol value) | |
881 | (imagemagick-register-types)) | |
2a1e2476 | 882 | :version "24.3" |
32d72c2f GM |
883 | :group 'image) |
884 | ||
885 | (imagemagick-register-types) | |
886 | ||
7840ced1 GM |
887 | (provide 'image) |
888 | ||
e43367a0 | 889 | ;;; image.el ends here |