Variable: image-auto-resize

image-auto-resize is a customizable variable defined in image-mode.el.gz.

Value

t

Documentation

Non-nil to resize the image upon first display.

Its value should be one of the following:
 - nil, meaning no resizing.
 - t, meaning to scale the image down to fit in the window.
 - fit-window, meaning to fit the image to the window.
 - A number, which is a scale factor (the default size is 1).

Resizing will always preserve the aspect ratio of the image.

This variable was added, or its default value changed, in Emacs 29.1.

View in manual

Probably introduced at or before Emacs version 27.1.

Source Code

;; Defined in /usr/src/emacs/lisp/image-mode.el.gz
(defcustom image-auto-resize t
  "Non-nil to resize the image upon first display.
Its value should be one of the following:
 - nil, meaning no resizing.
 - t, meaning to scale the image down to fit in the window.
 - `fit-window', meaning to fit the image to the window.
 - A number, which is a scale factor (the default size is 1).

Resizing will always preserve the aspect ratio of the image."
  :type '(choice (const :tag "No resizing" nil)
                 (const :tag "Fit to window" fit-window)
                 (other :tag "Scale down to fit window" t)
                 (number :tag "Scale factor" 1))
  :version "29.1"
  :group 'image)