home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / PRINTING / DVIPS54.ZIP / EMTEX / DOC / DVIPS.DOC < prev   
Text File  |  1990-11-25  |  32KB  |  793 lines
  1.  
  2.  
  3.  
  4. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      dvips - convert a TeX DVI file to PostScript (PostScript is
  10.      a trademark of Adobe Systems, Inc.)
  11.  
  12. SSYYNNOOPPSSIISS
  13.      dvips [ --cc _n_u_m ] [ --dd _n_u_m ] [ --ee _n_u_m ] [ --ff ] [ --hh _f_i_l_e ] [
  14.      --ll _n_u_m ] [ --mm ] [ --nn _n_u_m ] [ --oo _f_i_l_e ] [ --pp _n_u_m ] [ --qq ] [
  15.      --rr ] [ --ss ] [ --tt _m_o_d_e_n_a_m_e ] [ --xx _n_u_m ] [ --CC _n_u_m ] [ --DD _n_u_m ]
  16.      [ --FF ] [ --KK ] [ --NN ] [ --PP _p_r_i_n_t_e_r_n_a_m_e ] [ --UU ] [ --XX _n_u_m ] [
  17.      --YY _n_u_m ] [ --ZZ ] [ --?? ] _f_i_l_e[.dvi]
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      The program ddvviippss converts a DVI file _f_i_l_e[.dvi] produced by
  21.      TeX (or by some other processor like GFtoDVI) and converts
  22.      it to PostScript, normally sending the result directly to
  23.      the laserprinter.  The DVI file may be specified without the
  24.      ._d_v_i extension.  Fonts used may either be resident in the
  25.      printer or defined as bitmaps in PK files, or a `virtual'
  26.      combination of both.  If the MMaakkeeTTeeXXPPKK program is installed,
  27.      ddvviippss will automatically invoke METAFONT to generate fonts
  28.      that don't already exist.
  29.  
  30. OOPPTTIIOONNSS
  31.      Boolean flags that are turned on by certain letters (such as
  32.      -r to reverse pages) can be turned off by following the
  33.      option immediately with a 0 (as in -r0).  The options that
  34.      this can be used with are ffmmqqrrFFKKNNUUZZ.  The command line
  35.      switches are:
  36.  
  37.      --cc _n_u_m
  38.           Generate _n_u_m copies of every page.  Default is 1. (For
  39.           collated copies, see the --CC option below.)
  40.  
  41.      --dd _n_u_m
  42.           Set the debug flags.  This is intended only for emer-
  43.           gencies or for unusual fact-finding expeditions; it
  44.           will work only if ddvviippss has been compiled with the
  45.           DEBUG option.  The file _d_e_b_u_g._h in the sources indi-
  46.           cates what the values of _n_u_m can be.  Use a value of -1
  47.           for maximum output.
  48.  
  49.      --ee _n_u_m
  50.           Make sure that each character is placed at most this
  51.           many pixels from its `true' resolution-independent
  52.           position on the page. The default value of this parame-
  53.           ter is resolution dependent (it is the number of
  54.           entries in the list [100, 200, 300, 400, 500, 600, 800,
  55.           1000, 1200, 1600, 2000, 2400, 2800, 3200, ...] that are
  56.           less than or equal to the resolution in dots per inch).
  57.           Allowing individual characters to `drift' from their
  58.           correctly rounded positions by a few pixels, while
  59.           regaining the true position at the beginning of each
  60.  
  61.  
  62.  
  63. Printed 11/25/90          9 August 1990                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  71.  
  72.  
  73.  
  74.           new word, improves the spacing of letters in words.
  75.  
  76.      --ff   Run as a filter.  Read the DVI file from standard input
  77.           and write the PostScript to standard output.  The stan-
  78.           dard input must be seekable, so it cannot be a pipe.
  79.           If you must use a pipe, write a shell script that
  80.           copies the pipe output to a temporary file and then
  81.           points dvips at this file.
  82.  
  83.      --hh _n_a_m_e
  84.           Prepend file _n_a_m_e as an additional header file. (How-
  85.           ever, if the name is simply `-', suppress all header
  86.           files from the output.)  This header file gets added to
  87.           the PostScript userdict.
  88.  
  89.      --ll _n_u_m
  90.           The last page printed will be the first one numbered
  91.           _n_u_m. Default is the last page in the document.
  92.  
  93.      --mm   Specify manual feed for printer.
  94.  
  95.      --nn _n_u_m
  96.           At most _n_u_m pages will be printed out.  Default is
  97.           100000.
  98.  
  99.      --oo _n_a_m_e
  100.           The output will be sent to file _n_a_m_e. If no file name
  101.           is given, the default name is _f_i_l_e.ps; if this option
  102.           isn't given, the default name is !lpr.  If the first
  103.           character of the file name is an exclamation mark, then
  104.           the remainder will be used as an argument to popen;
  105.           thus, specifying !lpr as the output file will automati-
  106.           cally queue the file for printing.
  107.  
  108.      --pp _n_u_m
  109.           The first page printed will be the first one numbered
  110.           _n_u_m. Default is the first page in the document.
  111.  
  112.      --qq   Run in quiet mode.  Don't chatter about pages con-
  113.           verted, etc.; report nothing but errors to stderr.
  114.  
  115.      --rr   Stack pages in reverse order.  Normally, page one will
  116.           be printed first.
  117.  
  118.      --ss   Causes the entire global output to be enclosed in a
  119.           save/restore pair.  This causes the file to not be
  120.           truly conformant, and is thus not recommended, but is
  121.           useful if you are driving the printer directly and
  122.           don't care too much about the portability of the out-
  123.           put.
  124.  
  125.      --tt _m_o_d_e_n_a_m_e
  126.  
  127.  
  128.  
  129. Printed 11/25/90          9 August 1990                         2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  137.  
  138.  
  139.  
  140.           This sets the mode to _m_o_d_e_n_a_m_e.  Currently, the only
  141.           modes allowable are: lleetttteerr, which selects _l_e_t_t_e_r size
  142.           (8.5 by 11 inch page); aa33, which selects _a_3 size; aa44,
  143.           which selects _a_4 size; lleeggaall, which selects _l_e_g_a_l size
  144.           (8.5 by 14 inches); lleeddggeerr, which selects _l_e_g_a_l size
  145.           (11 by 17 inches); llaannddssccaappee, which rotates the docu-
  146.           ment by ninety degrees.  The default page size is
  147.           _l_e_t_t_e_r.  The llaannddssccaappee option may be combined with any
  148.           of the others; doing so requires giving the --tt option
  149.           twice.  The upper left corner of each page in the DVI
  150.           file is placed one inch from the left and one inch from
  151.           the top.
  152.  
  153.      --xx _n_u_m
  154.           Set the magnification ratio to _n_u_m /1000. Overrides the
  155.           magnification specified in the DVI file.  Must be
  156.           between 10 and 100000.
  157.  
  158.      --CC _n_u_m
  159.           Create _n_u_m copies, but collated (by replicating the
  160.           data in the PostScript file).  Slower than the --cc
  161.           option, but easier on the humans.
  162.  
  163.      --DD _n_u_m
  164.           Set the resolution in dpi (dots per inch) to _n_u_m. This
  165.           affects the choice of bitmap fonts that are loaded and
  166.           also the positioning of letters in resident PostScript
  167.           fonts. Must be between 10 and 10000.  This affects both
  168.           the horizontal and vertical resolution.
  169.  
  170.      --FF   Causes control-D (ASCII code 4) to be appended as the
  171.           very last character of the PostScript file.  This is
  172.           useful when ddvviippss is driving the printer directly, as
  173.           is common on extremely small systems, instead of work-
  174.           ing through a spooler.
  175.  
  176.      --KK   Removes comments from included graphics files.  Only
  177.           necessary when using brain-damaged spoolers or
  178.           PostScript postprocessors that don't properly interpret
  179.           structured comments.
  180.  
  181.      --NN   Turns off structured comments; this might be necessary
  182.           on some systems that try to interpret PostScript com-
  183.           ments in weird ways, or on some PostScript printers.
  184.  
  185.      --PP _p_r_i_n_t_e_r_n_a_m_e
  186.           Sets up the output for the appropriate printer.  This
  187.           is implemented by reading in _c_o_n_f_i_g._p_r_i_n_t_e_r_n_a_m_e, which
  188.           can then set the output pipe (as in, o !lpr -Pprinter-
  189.           name) as well as the font paths and any other defaults
  190.           for that printer only.  It is recommended that all
  191.           standard defaults go in the one master _c_o_n_f_i_g._p_s file
  192.  
  193.  
  194.  
  195. Printed 11/25/90          9 August 1990                         3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  203.  
  204.  
  205.  
  206.           and only things that vary printer to printer go in the
  207.           _c_o_n_f_i_g._p_r_i_n_t_e_r_n_a_m_e files.  Note that _c_o_n_f_i_g._p_s is read
  208.           before _c_o_n_f_i_g._p_r_i_n_t_e_r_n_a_m_e. In addition, another file
  209.           called ~/._d_v_i_p_s_r_c is searched for immediately after
  210.           _c_o_n_f_i_g._p_s; this file is intended for user defaults.  If
  211.           no --PP command is given, the environment variable
  212.           PPRRIINNTTEERR is checked.  If that variable exists, and a
  213.           corresponding _c_o_n_f_i_g.PPRRIINNTTEERR exists, then that confi-
  214.           guration file is read in.
  215.  
  216.      --UU   Turns off a virtual memory saving optimization that
  217.           triggers a bug in the Xerox 4045 PostScript inter-
  218.           preter; not recommended unless you must generate output
  219.           to this printer.
  220.  
  221.      --XX _n_u_m
  222.           Set the horizontal resolution in dpi (dots per inch) to
  223.           _n_u_m.
  224.  
  225.      --YY _n_u_m
  226.           Set the horizontal resolution in dpi (dots per inch) to
  227.           _n_u_m.
  228.  
  229.      --ZZ   Causes bitmap fonts to be compressed before they are
  230.           downloaded, thereby reducing the size of the PostScript
  231.           font-downloading information.  Especially useful at
  232.           high resolutions or when very large fonts are used.
  233.           Will slow down printing somewhat, especially on early
  234.           68000-based PostScript printers.
  235.  
  236.      --??   Print out the banner identifying the program.
  237.  
  238. CCOONNFFIIGG FFIILLEE OOPPTTIIOONNSS
  239.      The file _c_o_n_f_i_g._p_s (and the user's own ~/._d_v_i_p_s_r_c) can be
  240.      used to set many of the options to configure ddvviippss for a
  241.      particular site and printer.  These will probably be set up
  242.      by the installer, so normal users can skip this section.
  243.      The name and location of the config file can be changed at
  244.      installation time.  The environment variable TTEEXXCCOONNFFIIGG (if
  245.      it exists) is used as the path to configuration files.  Each
  246.      line of the file specifies a configuration option.  If the
  247.      initial character is a space, an asterisk, a pound sign, or
  248.      a semicolon, the line is ignored.  But if the initial char-
  249.      acter is an option like "o", for example, the remainder of
  250.      the line is considered to be a parameter.  The options are:
  251.  
  252.      ee _n_u_m
  253.           Sets the maximum drift parameter to _n_u_m dots (pixels)
  254.           as explained above.
  255.  
  256.      ff    Run as a filter by default.
  257.  
  258.  
  259.  
  260.  
  261. Printed 11/25/90          9 August 1990                         4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  269.  
  270.  
  271.  
  272.      hh _n_a_m_e
  273.           Add _n_a_m_e as a PostScript header file to be downloaded
  274.           at the beginning.
  275.  
  276.      mm _n_u_m
  277.           _n_u_m is the virtual memory available for fonts and
  278.           strings in the printer.  Default is 180000.
  279.  
  280.      oo _n_a_m_e
  281.           The default output file is set to _n_a_m_e. As above, it
  282.           can be a pipe.
  283.  
  284.      qq    Run in quiet mode by default.
  285.  
  286.      rr    Reverse the order of pages by default.
  287.  
  288.      ss    Enclose the entire document in a global save/restore
  289.           pair by default.  Not recommended, but useful in some
  290.           environments; this breaks the `conformance' of the
  291.           document.
  292.  
  293.      tt _m_o_d_e_n_a_m_e
  294.           This sets the mode to _m_o_d_e_n_a_m_e.  Currently, the only
  295.           modes allowable are: lleetttteerr, which selects _l_e_t_t_e_r size
  296.           (8.5 by 11 inch page); aa44, which selects _a_4 size;
  297.           lleeggaall, which selects _l_e_g_a_l size (8.5 by 14 inches);
  298.           llaannddssccaappee, which rotates a _l_e_t_t_e_r size document by
  299.           ninety degrees.  The default mode is _l_e_t_t_e_r. The upper
  300.           left corner of each page in the DVI file is placed one
  301.           inch from the left and one inch from the top.  The --tt
  302.           _m_o_d_e_n_a_m_e option will override this.
  303.  
  304.      DD _n_u_m
  305.           Sets the vertical and horizontal resolution to _n_u_m dots
  306.           per inch (dpi).
  307.  
  308.      EE _c_o_m_m_a_n_d
  309.           Executes the command listed; can be used to get the
  310.           current date into a header file for inclusion, for
  311.           instance.  Possibly dangerous; in many installations
  312.           this may be disabled, in which case a warning message
  313.           will be printed if the option is used.
  314.  
  315.      HH _p_a_t_h
  316.           The (colon-separated) path to search for PostScript
  317.           header files is _p_a_t_h.
  318.  
  319.      KK    Removes PostScript comments from included PostScript
  320.           graphics files.
  321.  
  322.      MM _m_o_d_e
  323.           Set _m_o_d_e as the METAFONT mode to be used when
  324.  
  325.  
  326.  
  327. Printed 11/25/90          9 August 1990                         5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  335.  
  336.  
  337.  
  338.           generating fonts.  This is passed along to MakeTeXPK
  339.           and overrides mode derivation from the base resolution.
  340.  
  341.      NN    Disable PostScript comments by default.
  342.  
  343.      PP _p_a_t_h
  344.           The (colon-separated) path to search for bitmap (PK)
  345.           font files is _p_a_t_h. The TEXPKS environment variable
  346.           will override this.  If a % character is found in _p_a_t_h,
  347.           the following substitutions will be made, and then a
  348.           search will be made for the resulting filenames.  A %f
  349.           is replaced by the font name.  A %d is replaced by the
  350.           font size in dots per inch (dpi).  A %p is replaced by
  351.           the font family.  This is always "pk".  A %m is
  352.           replaced by the font mode.  This is the _m_o_d_e given in
  353.           the MM option.
  354.  
  355.      SS _p_a_t_h
  356.           The (colon-separated) path to search for special illus-
  357.           trations (encapsulated PostScript files or psfiles) is
  358.           _p_a_t_h. The TEXINPUTS environment variable will override
  359.           this.
  360.  
  361.      TT _p_a_t_h
  362.           The (colon-separated) path to search for the tfm files
  363.           is _p_a_t_h. The TEXFONTS environment variable will over-
  364.           ride this. This path is used for resident fonts and
  365.           fonts that can't be otherwise found. It's usually best
  366.           to make it identical to the path used by TeX.
  367.  
  368.      UU    Turns off a memory-saving optimization; see the command
  369.           line option for more information.
  370.  
  371.      VV _p_a_t_h
  372.           The (colon-separated) path to search for virtual font
  373.           (VF) files is _p_a_t_h. This may be device-dependent, if
  374.           you use virtual fonts to simulate actual fonts on dif-
  375.           ferent devices.
  376.  
  377.      WW _s_t_r_i_n_g
  378.           Sends _s_t_r_i_n_g to stderr, if it exists; otherwise it can-
  379.           cels another previous message.  This is useful in the
  380.           default configuration file if you want to require the
  381.           user to specify a printer, for instance, or if you want
  382.           to notify the user that the resultant output has spe-
  383.           cial characteristics.
  384.  
  385.      XX _n_u_m
  386.           Sets the horizontal resolution to _n_u_m dots per inch
  387.           (dpi).
  388.  
  389.      YY _n_u_m
  390.  
  391.  
  392.  
  393. Printed 11/25/90          9 August 1990                         6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  401.  
  402.  
  403.  
  404.           Sets the vertical resolution to _n_u_m dots per inch
  405.           (dpi).
  406.  
  407.      RR _n_u_m _n_u_m ...
  408.           Sets up a list of default resolutions to search for PK
  409.           fonts, if the requested size is not available.  The
  410.           output will then scale the font found using PostScript
  411.           scaling to the requested size.  Note that the resultant
  412.           output will be ugly, and thus a warning is issued.  To
  413.           turn this off, simply don't use such a line in the con-
  414.           figuration file.
  415.  
  416.      ZZ    Compress all downloaded fonts by default.
  417.  
  418. PPAATTHH IINNTTEERRPPRREETTAATTIIOONN
  419.      All paths variables are the names of directories (path ele-
  420.      ments), separated by colons.  Each path element can be
  421.      either the literal name of a directory or one of the ~ forms
  422.      common under Unix.  If a path element is a single tilde, it
  423.      is replaced by the contents of the environment variable
  424.      HOME, which is normally set to the user's home directory.
  425.      If the path element is a tilde followed by anything, the
  426.      part after the tilde is interpreted as a user name, and his
  427.      home directory is fetched from the system password file and
  428.      used as the real path element.
  429.  
  430.      Where environment variables can override paths, an addi-
  431.      tional path element form is allowed.  If a path element is
  432.      the empty string, it is replaced with the system defaults.
  433.      Thus, to say (with an environment variable) to search the
  434.      user's home directory, followed by the system default paths,
  435.      the following command would be used:
  436.  
  437.                          setenv TEXINPUTS ~:
  438.  
  439.      This is a path of two elements.  The first is the user's
  440.      home directory.  The second path element is the empty
  441.      string, indicating that the system defaults should be
  442.      searched.
  443.  
  444. PPOOSSTTSSCCRRIIPPTT FFOONNTT SSUUPPPPOORRTT
  445.      This version of dvips supports PostScript fonts.  You need
  446.      TFM (TeX Font Metric) files for all fonts seen by TeX; they
  447.      can be generated from AFM (Adobe Font Metric) files by run-
  448.      ning the program aaffmm22ttffmm (which is described on its own
  449.      manual page). That program also creates virtual fonts with
  450.      which you can use normal plain TeX conventions.  The set of
  451.      all resident fonts known to ddvviippss appears in the file
  452.      _p_s_f_o_n_t_s._m_a_p, which should be updated whenever you install a
  453.      new resident font. See aaffmm22ttffmm for examples and more infor-
  454.      mation on this file.
  455.  
  456.  
  457.  
  458.  
  459. Printed 11/25/90          9 August 1990                         7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  467.  
  468.  
  469.  
  470. \\ssppeecciiaall OOPPTTIIOONNSS
  471.      This DVI driver allows the inclusion of PostScript code to
  472.      be inserted in a TeX file via TeX's \special command.  For
  473.      compatibility with other systems, several different conven-
  474.      tions are supported.
  475.  
  476.      First, there's a flexible key-and-value scheme:
  477.  
  478.         \special{psfile="filename"[ key=value]*}
  479.  
  480.      This will download the PostScript file called _f_i_l_e_n_a_m_e  such
  481.      that  the current point will be the origin of the PostScript
  482.      coordinate system.  If the _f_i_l_e_n_a_m_e string begins with the `
  483.      (grave  accent) character then the remainder of the _f_i_l_e_n_a_m_e
  484.      field is treated as a Unix Bourne shell script  to  be  exe-
  485.      cuted with its _s_y_s_o_u_t down loaded as a PostScript file.  For
  486.      example:
  487.  
  488.         \special{psfile="`zcat packed.ps" ...}
  489.  
  490.      will uncompress the file _p_a_c_k_e_d._p_s._Z for inclusion in  ddvviippss
  491.      output.
  492.  
  493.      The optional key/value  assignments  allow  you  to  specify
  494.      transformations  on the PostScript in _f_i_l_e_n_a_m_e. The possible
  495.      keys are:
  496.  
  497.      hoffset             The horizontal offset (default 0)
  498.      voffset             The vertical offset (default 0)
  499.      hsize               The horizontal clipping size (default 612)
  500.      vsize               The vertical clipping size (default 792)
  501.      hscale              The horizontal scaling factor (default 100)
  502.      vscale              The vertical scaling factor (default 100)
  503.      angle               The rotation (default 0)
  504.  
  505.      The  hoffset,  voffset,  hsize,  and  vsize  are  given   in
  506.      PostScript  units  (1/72 of an inch), called bp elsewhere in
  507.      TeX; these are the units of the  default  coordinate  system
  508.      assumed  to be valid in the PostScript file.  The hscale and
  509.      vscale are given in non-dimensioned  percentage  units,  and
  510.      the rotate value is specified in degrees.  Thus
  511.  
  512.         \special{psfile=foo.ps hoffset=72 hscale=90 vscale=90}
  513.  
  514.      will shift the graphics produced by file _f_o_o._p_s right by 1",
  515.      and  will  draw  it  at 0.9 normal size.  If either hsize or
  516.      vsize is specified, the figure will be  clipped  to  a  rec-
  517.      tangular region from (0,0) to (hsize,vsize) in default coor-
  518.      dinates, after scaling, translation, and/or rotation. Other-
  519.      wise  no  clipping will be done.  Offsets are given relative
  520.      to the point of the \special command, and are unaffected  by
  521.      scaling  or  rotation.  Rotation  is  counterclockwise about
  522.  
  523.  
  524.  
  525. Printed 11/25/90          9 August 1990                         8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  533.  
  534.  
  535.  
  536.      (0,0).  The order of operations is: Take the PostScript fig-
  537.      ure, rotate it, then scale it, then offset it, then clip it.
  538.      For example, if you want to extract a one-inch-square figure
  539.      bounded by (100,200), (172,200), (172,272), and (100,272) in
  540.      the PostScript coordinates of the  graphic  in  cropthis.ps,
  541.      you would say
  542.  
  543.      \special{psfile=cropthis.ps hoffset=-100 yoffset=-200 hsize=72 vsize=72}
  544.  
  545.      Secondly, if your file conforms  to  the  _E_n_c_a_p_s_u_l_a_t_e_d  _P_o_s_t
  546.      _S_c_r_i_p_t  (EPS)  conventions,  then  it  is  possible to use a
  547.      simpler \\ssppeecciiaall command that will automatically reserve the
  548.      required space.
  549.  
  550.      To use, simply say
  551.  
  552.      \input epsf           % at the beginning of your TeX document
  553.      \epsfbox{filename.ps} % at the place where you want the figure
  554.  
  555.      A _v_b_o_x of the appropriate size for the bounding box will  be
  556.      built.  The height and width of this vbox will be the height
  557.      and width of the figure; the depth of the vbox will be zero.
  558.      By  default,  the graphic will have its `natural' width.  If
  559.      you wish to enlarge or reduce it, simply set  the  dimension
  560.      `\epsfxsize' to something else, such as `\hsize'; the figure
  561.      will be scaled so that \epsfxsize is  its  final  width.   A
  562.      more  general  facility  for sizing is available by defining
  563.      the `\epsfsize' macro.  This macro is used to  give  \epsfx-
  564.      size  a  value  each time \epsffile is called.  It takes two
  565.      parameters; the first is the horizontal natural size of  the
  566.      PostScript  figure,  and  the second is the vertical natural
  567.      size.   (Natural  size,  in  this  case,  is  the  size   in
  568.      PostScript  points  from  the  bounding  box  comment.)  The
  569.      default definition of this macro is
  570.  
  571.      \def\epsfsize#1#2{\epsfxsize}
  572.  
  573.      which just means to take the value that was set  before  the
  574.      macro  was  invoked.   Note  that the variable \epsfxsize is
  575.      reset to zero at the end of each call to \epsffile.  You can
  576.      redefine  this  macro to do almost anything.  It must return
  577.      the xsize to use, or 0 if natural scaling  is  to  be  used.
  578.      Common uses include:
  579.  
  580.      \epsfxsize  % just leave the old value alone
  581.      0pt         % use the natural sizes
  582.      #1          % use the natural sizes
  583.      \hsize      % scale to full width
  584.      0.5#1       % scale to 50% of natural size
  585.      \ifnum#1>\hsize\hsize\else#1\fi  % smaller of natural, hsize
  586.  
  587.      The resultant vbox can  be  centered  with  \centerline,  or
  588.  
  589.  
  590.  
  591. Printed 11/25/90          9 August 1990                         9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  599.  
  600.  
  601.  
  602.      treated  as  any other vbox.  If you are using LaTeX and the
  603.      center environment, be sure to execute a \leavevmode  before
  604.      each  use  of  \epsffile,  so that LaTeX leaves the vertical
  605.      mode and enters the paragraph  making  mode.   (This  should
  606.      probably be provided by the LaTeX macros themselves.)
  607.  
  608.      (The \epsfbox macro does its job by scanning filename.ps for
  609.      a  standard  `BoundingBox' comment. The figure is clipped to
  610.      the size of that bounding box. If the bounding  box  is  not
  611.      found, a bounding box of `72 72 540 720' is assumed.  If the
  612.      PostScript file to be included is not EPSF, you are probably
  613.      better off using the _p_s_f_i_l_e special instead.)
  614.  
  615.      Thirdly, there are special  commands  for  drawing  diagrams
  616.      using    the    conventions    of    `TPIC'   (a   portable,
  617.      non-PostScript-dependent  program  by   Tim   Morgan,   with
  618.      PostScript  implementation  by  Dorab  Patel).  For example,
  619.      `\special{pn 2}' in this language sets the pen size to  .002
  620.      inch.
  621.  
  622.      A fourth type of \special allows  you  to  write  PostScript
  623.      instructions that will be passed literally to dvips's output
  624.      file. These are intended for people whose favorite  graphics
  625.      language is raw PostScript.
  626.  
  627.                            \special{" _t_e_x_t}
  628.  
  629.      includes _t_e_x_t literally in the output  PostScript  document,
  630.      after  translating  the origin to the current page position,
  631.      opening a special user dictionary, and and reverting to  the
  632.      PostScript convention of 72 units=1in.
  633.  
  634.                            \special{! _t_e_x_t}
  635.  
  636.      includes _t_e_x_t literally in the prolog (before  all  typeset-
  637.      ting  is  done), putting definitions in the special diction-
  638.      ary; this is good for definitions you  intend  to  use  with
  639.      \special{"}.   Note that _d_v_i_p_s will always include such spe-
  640.      cials in the prolog, unless they occur on  pages  after  the
  641.      last page printed.  This allows correct printing of selected
  642.      pages, even when literal PostScript  definitions  are  used,
  643.      provided that you give definitions before their first use.
  644.  
  645.      A fifth type of \special allows literal PostScript  instruc-
  646.      tions  to be inserted _w_i_t_h_o_u_t enclosing them in an invisible
  647.      protective shield; users of this  feature  are  supposed  to
  648.      understand  what  they  are doing (and they shouldn't change
  649.      the PostScript graphics state unless  they  are  willing  to
  650.      take  the  consequences).  This command can take many forms,
  651.      because it has had a tortuous history; any of the  following
  652.      will work:
  653.  
  654.  
  655.  
  656.  
  657. Printed 11/25/90          9 August 1990                        10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  665.  
  666.  
  667.  
  668.              \special{ps:_t_e_x_t}
  669.              \special{ps::_t_e_x_t}
  670.              \special{ps::[begin]_t_e_x_t}
  671.              \special{ps::[end]_t_e_x_t}
  672.      (with longer forms taking  precedence  over  shorter  forms,
  673.      when they are used).  Exception: The command
  674.  
  675.                        \special{ps: plotfile _f_i_l_e_n_a_m_e}
  676.  
  677.      will copy the commands from _f_i_l_e_n_a_m_e verbatim  into  dvips's
  678.      output  (but  omitting lines that begin with %).  An example
  679.      of the proper use of literal specials can be  found  in  the
  680.      file  rroottaattee..tteexx,, which makes it easy to typeset text turned
  681.      90 degrees.
  682.  
  683.      Finally, there are two special cases of \special, which pro-
  684.      vide alternatives to certain dvips command-line options: (1)
  685.      You may put the command
  686.  
  687.                        \\ssppeecciiaall{{llaannddssccaappee}}
  688.  
  689.      anywhere in your  document  (except  after  the  final  page
  690.      selected  for  printing),  and  the  entire document will be
  691.      printed in landscape mode.  (2) The command
  692.  
  693.                     \\ssppeecciiaall{{hheeaaddeerr==_f_i_l_e_n_a_m_e}}
  694.  
  695.      may be used to add _f_i_l_e_n_a_m_e as a header file (i.e.,  a  file
  696.      that  will  be  downloaded  before the start of processing).
  697.      This is usually used for Macintosh header files.  The header
  698.      file will be added to the PostScript userdict.
  699.  
  700.      For  special  effects,  if  any  of  the  macros   _b_o_p-_h_o_o_k,
  701.      _e_o_p-_h_o_o_k,   _s_t_a_r_t-_h_o_o_k,  or  _e_n_d-_h_o_o_k  are  defined  in  the
  702.      PostScript userdict, they will be executed at the  beginning
  703.      of  a page, end of a page, start of the document, and end of
  704.      a document, respectively.  When these macros  are  executed,
  705.      the default PostScript coordinate system is in effect.  Such
  706.      macros can be defined in headers added by the --hh  option  or
  707.      the  hheeaaddeerr==  special,  and might be useful for writing, for
  708.      instance, DRAFT across the entire page, or, with the aid  of
  709.      a  shell script, dating the document.  These macros are exe-
  710.      cuted outside of the save/restore context of the  individual
  711.      pages, so it is possible for them to accumulate information,
  712.      but if a document must be divided into sections  because  of
  713.      memory  constraints,  such  added  information  will be lost
  714.      across section breaks.
  715.  
  716.      Several of the above tricks can  be  used  nicely  together.
  717.      For  instance,  a --PP file can be set up to print the date on
  718.      each page; the particular configuration file will execute  a
  719.      command  to  put  the date into a header file, which is then
  720.  
  721.  
  722.  
  723. Printed 11/25/90          9 August 1990                        11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. DVIPS(1)          Pyramid OSx Operating System           DVIPS(1)
  731.  
  732.  
  733.  
  734.      included with a hh line in the configuration file.  Note that
  735.      multiple --PP options can be used.
  736.  
  737.      If the filename in any of the PostScript  inclusion  options
  738.      begins  with a backtick, that name is interpreted instead as
  739.      a command to be executed to generate the  appropriate  file.
  740.      The  PostScript  must be generated to standard output by the
  741.      command.  This is useful, for  instance,  for  uncompressing
  742.      large PostScript files using zcat.
  743.  
  744. FFIILLEESS
  745.      Files used by dvips are usually system  dependent,  but  the
  746.      following are typical:
  747.  
  748.      the prolog dir        /usr/lib/tex/ps
  749.      the config dir                      /usr/lib/tex/ps
  750.      the tfm dir                         /usr/lib/tex/fonts/tfm
  751.      the font dir                        /usr/lib/tex/fonts/pk
  752.      the virtual font dir  /usr/lib/tex/fonts/vf
  753.      the epsf/psfile dir   .:..:/usr/lib/tex/inputs
  754.  
  755. SSEEEE AALLSSOO
  756.      mf(1), afm2tfm(1), tex(1), latex(1), lpr(1)
  757.  
  758. AAUUTTHHOORR
  759.      Tomas Rokicki <rokicki@neon.stanford.edu>; extended to  vir-
  760.      tual fonts by Don Knuth.
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789. Printed 11/25/90          9 August 1990                        12
  790.  
  791.  
  792.  
  793.