# Image data file specials

dviout can read Image data files in the PS/EPS, raw PBM, and monochrome and color BMP/BMC formats. Using Susie plug-in(cf. spi:), dviout can read other formats(PNG/JPEG/TIFF/PCD/PPM etc). The images can also be printed by Including printer control codes into TeX file.
For an encapsulated PostScript file (EPSF), Ghostscript can be used to import images. The \specials supported by dviout are
epsfile=epsf_file [parameters]
which is used by (ecl)spsf.sty or epsfig.sty, or
PSfile=epsf_file [parameters]
which is used to output graphicx.sty in the LaTex2e graphics package to dvips.
epsf_file is the name of the EPS file. The name can be enclosed by double quotes ("") as in "foo.ps" or not as in foo.ps. Of course, these specifications can be directly written in the TeX text as \special{...}.
In addition,
postscriptbox{widthpt}{heightpt}{epsf_file}
that is output by epsbox.sty is also supported. PSfrag can also be used.
For information about [parameters], see "PostScript special parameters" or "Examples using PostScript specials".
The following \specials are supported respectively for PostScript files not containing %%BoundingBox:, raw PBM files (can omit the .pbm extension), Windows Metafiles/monochrome or color BMP files (can omit the .bmp extension)/files handled by Susie plug-in:
psfile=ps_file [parameters]
pbmfile=pbm_file [parameters]
bmpfile=graphic_file [parameters]
(The raw PBM style file called pbmf.sty is provided with dviout.) [parameters] can be hsize, vsize, height, width, hscale, vscale, scale, truesize and reverse (cf. PostScript special parameters).
ps: PS code
or
" PS code
can be processed (in the latter, one space is required after the double quote ") if PS code is a complete PostScript code to draw a picture.
The following are also supported to include a graphic file which is not a PostScript file. The former is used by emTeX and MikTeX+yap and the latter by dvipdfm.
em: graph graphic_file[,width[,height]]
pdf: image width widthpt height heightpt(graphic_file)
When the graphicx.sty of the LaTeX2e graphics package is used in dvips output, all the key words in the package can be handled with the following limitations.
1. The image written by PostScript can be rotated by the angle of interger multiple of 90 degree. The rotations by other angle is not supported. The rotations of the image in EMF/WMF and the colored image in any other file format are not supported, neither.
2. Scalings of colored images not written in the PostScript are ignored.
3. The last parameter of \DeclareGraphicRules should not be a command.
4. \pagecolor is only valid in the page where is is declared.
5. dviout makes files in BMC format to handle Postscript files but BMC files can be handled by dviout as if they are BMP files. When BMP files are requested, dviout first searches the corresponding BMC files and uses them if they exist.
6. The location of the image data file can be indicated by the relative path from the location of the DVI file. In this case, the character / can be used as a separator of the directory names.
7. The file name of a gzipped image data file should be added .gz at the tail ot the original one and the program gzip should be executed by the command gzip -d <file>.gz or gunzip <file>.gz.
The following are examples.
\includegraphics[<key val list>]{file}
\includegraphics*[<key val list>]{file}
\rotatebox[<key val list>]{angle}{text}
\scalebox{<h scale>}[<v scale>]{text}
\textcolor{<name>}{text}