5.2 Variables related to images

w3m-default-display-inline-images

Non-nil means display images inline in emacs-w3m buffers. You can toggle the visibility of images with the w3m-toggle-inline-images command. See also w3m-toggle-inline-images-permanently.

w3m-favicon-cache-expire-wait

The cache will be expired after specified seconds passed since retrieval. If this variable is nil, never expired.

w3m-favicon-cache-file

Filename of saving favicon cache. It defaults to the file named ‘.favicon’ under the directory specified by the w3m-profile-directory variable.

w3m-favicon-size

Size of favicon. This value is used as geometry argument for convert.

w3m-favicon-type

Image type of display favicon.

w3m-favicon-use-cache-file

If non-nil, use favicon cache file.

w3m-favicon-default-background

Color name used as transparent color of favicon image. Nil means to use the background color of the Emacs frame. The null string "" is special, that will be replaced with the background color of the header line or the mode line on which the favicon is displayed. Note that this value is effective only with Emacs 22 and greater.

w3m-icon-directory

Directory where emacs-w3m should find icon files.

w3m-imagick-convert-program

Program name of ImageMagick’s ‘convert’.

w3m-treat-image-size

Non-nil means let the ‘w3m’ command mind the ratio of the size of images and text. The default value is t.

If it is non-nil, the ‘w3m’ command will make a ‘halfdump’ which reserves rectangle spaces in which images will be put, and also ‘alt’ texts will be truncated or padded with spaces so that their display width will be the same as the width of images.

See also w3m-pixels-per-character and w3m-pixels-per-line. Those values will be passed to the ‘w3m’ command in order to compute columns and lines which images occupy.

w3m-pixels-per-character

Integer used for the -ppc argument of the ‘w3m’ command. If nil, the width of the default face is used. It is valid only when w3m-treat-image-size is non-nil. The default value is nil. If you want to use emacs-w3m in a character terminal and make w3m-treat-image-size effective, you need to set this variable properly.

w3m-pixels-per-line

Integer used for the ‘-ppl’ argument of the ‘w3m’ command. If nil, the height of the default face is used. It is valid only when w3m-treat-image-size is non-nil. Note that a small value may not induce a good result. The default value is ‘64’. If you want to use emacs-w3m in a character terminal and make w3m-treat-image-size effective, you need to set this variable properly.

w3m-resize-image-scale

Number of steps in percent used when resizing images.

w3m-resize-images

If non-nil, resize images to the specified width and height.

w3m-show-graphic-icons-in-header-line

Non-nil means show graphic status indicators in the header-line. If it is nil, also the favicon won’t be shown in the header-line even if w3m-use-favicon is non-nil. This variable is currently meaningless under XEmacs.

w3m-show-graphic-icons-in-mode-line

Non-nil means show graphic status indicators in the mode-line. If it is nil, also the favicon won’t be shown in the mode-line even if w3m-use-favicon is non-nil.

w3m-toggle-inline-images-permanently

Non-nil means let the visibility of images continue permanently. The visibility of images is initialized according to w3m-default-display-inline-images at the first time, and except that it may be toggled by the w3m-toggle-inline-images command, it does not change hereafter, if it is non-nil. Otherwise, whether images are visible is initialized according to w3m-default-display-inline-images whenever you visit a new page or reload the current page in an emacs-w3m buffer.

w3m-use-favicon

Non-nil means show favicon images if they are available. It will be set to nil automatically if ImageMagick’s convert program does not support the ico format.

w3m-image-default-background

Color name used as transparent color of image. Nil means to use the background color of the Emacs frame. The null string "" is special, that will be replaced with the background color of the buffer. Note that this value is effective only with Emacs 22 and greater.

This document was generated by TSUCHIYA Masatoshi on January 30, 2019 using texi2html 1.82.