Node:Images, Previous:Footnotes, Up:Insertions



Inserting Images

You can insert an image given in an external file with the @image command:

     @image{filename, [width], [height], [alttext], [extension]}
     

The filename argument is mandatory, and must not have an extension, because the different processors support different formats:

The optional width and height arguments specify the size to scale the image to (they are ignored for Info output). If neither is specified, the image is presented in its natural size (given in the file); if only one is specified, the other is scaled proportionately; and if both are specified, both are respected, thus possibly distorting the original image by changing its aspect ratio.

The width and height may be specified using any valid TeX dimension, namely:

pt
point (72.27pt = 1in)
pc
pica (1pc = 12pt)
bp
big point (72bp = 1in)
in
inch
cm
centimeter (2.54cm = 1in)
mm
millimeter (10mm = 1cm)
dd
didôt point (1157dd = 1238pt)
cc
cicero (1cc = 12dd)
sp
scaled point (65536sp = 1pt)

For example, the following will scale a file ridt.eps to one inch vertically, with the width scaled proportionately:

     @image{ridt,,1in}
     

For @image to work with TeX, the file epsf.tex must be installed somewhere that TeX can find it. (The standard location is texmf/tex/generic/dvips/epsf.tex, where texmf is a root of your TeX directory tree.) This file is included in the Texinfo distribution and is also available from ftp://tug.org/tex/epsf.tex, among other places.

@image can be used within a line as well as for displayed figures. Therefore, if you intend it to be displayed, be sure to leave a blank line before the command, or the output will run into the preceding text.

When producing html, makeinfo sets the alt attribute for inline images to the optional fourth argument to @image, if supplied. If not supplied, makeinfo uses the full file name of the image being displayed.