GNU Info

(elisp)Images

---

Next: Blinking Prev: Display Property Up: Display

---

Enter node , (file) or (file)node

Images
======

   To display an image in an Emacs buffer, you must first create an
image descriptor, then use it as a display specifier in the `display'
property of text that is displayed (Note: Display Property).  Like the
`display' property, this feature is available starting in Emacs 21.

   Emacs can display a number of different image formats; some of them
are supported only if particular support libraries are installed on your
machine.  The supported image formats include XBM, XPM (needing the
libraries `libXpm' version 3.4k and `libz'), GIF (needing `libungif'
4.1.0), Postscript, PBM, JPEG (needing the `libjpeg' library version
v6a), TIFF (needing `libtiff' v3.4), and PNG (needing `libpng' 1.0.2).

   You specify one of these formats with an image type symbol.  The
image type symbols are `xbm', `xpm', `gif', `postscript', `pbm',
`jpeg', `tiff', and `png'.

 - Variable: image-types
     This variable contains a list of those image type symbols that are
     supported in the current configuration.

Image Descriptors

How to specify an image for use in `:display'.

XBM Images

Special features for XBM format.

XPM Images

Special features for XPM format.

GIF Images

Special features for GIF format.

Postscript Images

Special features for Postscript format.

Other Image Types

Various other formats are supported.

Defining Images

Convenient ways to define an image for later use.

Showing Images

Convenient ways to display an image once it is defined.

Image Cache

Internal mechanisms of image display.