9.2.2 Image Scaling

The optional width and height arguments to the @image command (see the previous section) specify the size to which to scale the image. They are only taken into account in TeX. 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 likely 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.

Image scaling is presently implemented only in TeX, not in HTML or any other sort of output.