3.1.2 Images

The alternate text or the file name of images is shown in rendered HTML pages. To view an image, type ‘i’ (‘wwe-image-at-point’) with point on the text. If Emacs can display the image (it’s running in a window-system and the image type is supported) it’s inserted into the buffer placed over the text as an overlay (change ‘wwe-display-inline-images’ to nil if you don’t want to use inline images). Type ‘I’ (‘wwe-image-at-point-same/new-buffer’) to retrieve the image in its own buffer or inline depending on the value of the ‘wwe-display-inline-images’ variable. Use ‘M-i’ (‘wwe-images-in-buffer’) to retrieve and display all the page’s images inline in the current buffer regardless of the setting of ‘wwe-display-inline-images’. If an image couldn’t be inserted, a message appears in the mini-buffer.

You can set the maximum width and height for images, so they’ll fit in your windows. The default maximum width is 500 and maximum height is 320. See ‘wwe-image-max-width’ and ‘wwe-image-max-height’ to change these. To zoom in on an image type ‘+’ (‘image-increase-size’) and to zoom out type ‘-’ (‘image-decrease-size’) with point on the image.

You can customize ‘wwe-content-type-rules’ if you don’t want Emacs itself to display any images/if you’d rather have an external program display images.

To find out the location (src attribute) of the inline image at point type ‘o l’ (‘wwe-show-link-url’). If this image is also a link button, use a prefix argument like ‘C-u o l’ because ‘o l’ shows the link URL in this case. Type ‘o i’ (‘wwe-show-image-title’) to see the image’s title.

Type ‘_ i’ (‘wwe-undo-image-at-point’) to "undo" the image at point and show its alternate text again. Type ‘_ I’ (‘wwe-undo-images-in-buffer’) to undo all inline images in the current buffer (rerendering the page also removes all images).

When you visit an image file in its own buffer the point is placed after the image if ‘blink-cursor-mode’ is enabled. See ‘wwe-image-move-point’ to always move the cursor or disable this feature.

Sometimes there are <img> tags in HTML with no src attribute set. These nonexistent images are shown as such. Change the variable ‘wwe-render-nonexistent-image’ to an empty string "" if you don’t need to see that there was an image at that place in the HTML code.

Functionality of certain image types:

• SVG images contained in <svg> tags are shown as "[svg]" in the ‘wwe-svg’ face (by default inherits ‘wwe-image’ face). You can interact with them like other images, but you can’t load them in a separate buffer.
• Inline animated GIFs only show the first frame. To view them as an animation, load them in a separate, dedicated buffer and run ‘M-x image-toggle-animation RET’ with point on the image.