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-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.