Function: image-mode

image-mode is an autoloaded, interactive and byte-compiled function defined in image-mode.el.gz.

Signature

(image-mode)

Documentation

Major mode for image files.

You can use C-c C-c (image-toggle-display) or C-c C-x (image-toggle-hex-display) to toggle between display as an image and display as text or hex.

Key bindings:
                         image-scroll-down
                         image-scroll-up
- negative-argument
0 digit-argument
1 digit-argument
2 digit-argument
3 digit-argument
4 digit-argument
5 digit-argument
6 digit-argument
7 digit-argument
8 digit-argument
9 digit-argument
< beginning-of-buffer
<keymap> C-<mouse-4> image-mouse-increase-size
<keymap> C-<mouse-5> image-mouse-decrease-size
<keymap> C-<wheel-down> image-mouse-decrease-size
<keymap> C-<wheel-up> image-mouse-increase-size
<keymap> i + image-increase-size
<keymap> i - image-decrease-size
<keymap> i c image-crop
<keymap> i o image-save
<keymap> i x image-cut
<left> image-backward-hscroll
<right> image-forward-hscroll
> end-of-buffer
? describe-mode
C-a image-bol
C-b image-backward-hscroll
C-c C-c image-toggle-display
C-c C-x image-toggle-hex-display
C-e image-eol
C-f image-forward-hscroll
C-n image-next-line
C-p image-previous-line
C-v image-scroll-up
C-x < image-scroll-left
C-x > image-scroll-right
DEL image-scroll-down
DEL scroll-down-command
F image-goto-frame
M-< image-bob
M-> image-eob
M-v image-scroll-down
RET image-toggle-animation
S-SPC image-scroll-down
S-SPC scroll-down-command
SPC image-scroll-up
SPC scroll-up-command
SPC..~ undefined
W image-mode-wallpaper-set
a + image-increase-speed
a - image-decrease-speed
a 0 image-reset-speed
a r image-reverse-speed
b image-previous-frame
f image-next-frame
g revert-buffer
h describe-mode
m image-mode-mark-file
n image-next-file
p image-previous-file
q quit-window
s 0 image-transform-reset-to-initial
s b image-transform-fit-both
s f image-mode-fit-frame
s h image-transform-fit-to-height
s i image-transform-fit-to-width
s m image-transform-set-smoothing
s o image-transform-reset-to-original
s p image-transform-set-percent
s r image-transform-set-rotation
s s image-transform-set-scale
s w image-transform-fit-to-window
u image-mode-unmark-file
w image-mode-copy-file-name-as-kill

View in manual

Probably introduced at or before Emacs version 23.2.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/image-mode.el.gz
;;;###autoload
(defun image-mode ()
  "Major mode for image files.
You can use \\<image-mode-map>\\[image-toggle-display] or \
\\[image-toggle-hex-display] to toggle between display
as an image and display as text or hex.

Key bindings:
\\{image-mode-map}"
  (interactive)
  (unless (display-images-p)
    (error "Display does not support images"))

  (unless (eq major-mode 'image-mode)
    (major-mode-suspend)
    (setq major-mode 'image-mode))
  (setq image-transform-resize image-auto-resize)

  ;; Bail out early if we have no image data.
  (if (zerop (buffer-size))
      (funcall (if (called-interactively-p 'any) 'error 'message)
               (if (stringp buffer-file-name)
                   (if (file-exists-p buffer-file-name)
                       "Empty file"
                     "(New file)")
                 "Empty buffer"))
    (image-mode--display)
    (setq-local image-crop-buffer-text-function
                ;; Use the binary image data directly for the buffer text.
                (lambda (_text image) image))
    ;; Ensure that we recognize externally parsed image formats in
    ;; commands like `n'.
    (when image-use-external-converter
      (require 'image-converter)
      (image-converter-initialize))))