(texinfo) Images

Info Catalog

(texinfo) Footnotes

(texinfo) Insertions

 
 Inserting Images
 ================
 
   You can insert an image given in an external file with the `@image'
 command:
 
      @image{FILENAME, [WIDTH], [HEIGHT]}
 
   The FILENAME argument is mandatory, and must not have an extension,
 because the different processors support different formats:
    * TeX reads the file `FILENAME.eps' (Encapsulated PostScript format).
 
    * PDFTeX reads `FILENAME.pdf' (Adobe's Portable Document Format).
 
    * `makeinfo' uses `FILENAME.txt' verbatim for Info output (more or
      less as if it was an `@example').
 
    * `makeinfo' producing HTML output tries `FILENAME.png'; if that
      does not exist, it tries `FILENAME.jpg'.  If that does not exist
      either, it complains.  (We cannot support GIF format due to
      patents.)
 
   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
      dido^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 available from `ftp://tug.org/tex/epsf.tex'.
 
   `@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.
 

Info Catalog

(texinfo) Footnotes

(texinfo) Insertions