home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / texmf / doc / fig / fig2dev.man < prev    next >
Text File  |  1991-06-27  |  7KB  |  173 lines
  1.  
  2.  
  3.  
  4. FIG2DEV(1)               USER COMMANDS                 FIG2DEV(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      fig2dev - translates Fig code to various graphics languages
  10.  
  11.  
  12. SYNOPSIS
  13.      fig2dev -L language [ -m mag ] [ -f font ] [ -s  fsize  ]  [
  14.      other options ] [ fig-file [ out-file ] ]
  15.  
  16.  
  17. DESCRIPTION
  18.      Fig2dev translates fig code in the named fig-file  into  the
  19.      specified  graphics  language and puts them in out-file. The
  20.      default fig-file and out-file are standard input  and  stan-
  21.      dard output, respectively
  22.  
  23.      Fig (Facility for Interactive Generation of  figures)  is  a
  24.      screen-oriented tool which allows the user to draw and mani-
  25.      pulate objects interactively.  Various versions of  Fig  run
  26.      under the Suntools/Sunview window environment and under ver-
  27.      sion 11 of the X Windows System.  Fig2dev is compatible with
  28.      Fig versions 1.3, 1.4-TFX, and 2.0.
  29.  
  30.  
  31. OPTIONS
  32.      -L   Set the output graphics language.  Valid languages  are
  33.           box,  epic,  eepic, eepicemu, latex, null, pic, pictex,
  34.           and ps.
  35.  
  36.      -m   Set the magnification at which the figure  is  rendered
  37.           to mag. The default is 1.0.
  38.  
  39.      -f   Set the default font used for text objects to font. The
  40.           default  is Roman; the format of this option depends on
  41.           the graphics language in use.  In TeX-based  languages,
  42.           the  font  is the base of the name given in lfonts.tex,
  43.           for instance In PostScript, it is any font  name  known
  44.           to the printer or interpreter.
  45.  
  46.      -s   Set the default font size (in points) for text  objects
  47.           to  fsize. The default is 11*mag, and thus is scaled by
  48.           the -m option.  If there is  no  scaling,  the  default
  49.           font is eleven point Roman."
  50.  
  51.      other options
  52.           The other options are specific to the choice of  graph-
  53.           ics language, as described below.
  54.  
  55.  
  56. EPIC OPTIONS
  57.      EPIC is an enhancement to LaTeX picture drawing environment.
  58.      It  was  developed  by Sunil Podar of Department of Computer
  59.      Science in S.U.N.Y at Stony Brook.
  60.  
  61.      EEPIC is an extension to  EPIC  and  LaTeX  picture  drawing
  62.      environment  which  uses tpic specials as a graphics mechan-
  63.      ism.  It was written by Conrad Kwok of Division of  Computer
  64.      Science at University of California, Davis.
  65.  
  66.      EEPIC-EMU is an EEPIC emulation package which does  not  use
  67.      tpic specials.
  68.  
  69.      -S   Set the scale to which the figure  is  rendered.   This
  70.           option automatically sets the magnification and size to
  71.           scale / 12 and scale respectively.
  72.  
  73.      -l   Use "\thicklines" when width of the line is wider  than
  74.           lwidth. The default is 2.
  75.  
  76.      -v   Include comments in the output file.
  77.  
  78.      -P   Generate a complete LaTeX file.  In  other  words,  the
  79.           ouput  file  can  be  formatted  without  requiring any
  80.           changes. The additional text inserted in the  beginning
  81.           and  at the end of the file is controlled by the confi-
  82.           guration parameter "Preamble" and "Postamble".
  83.  
  84.      -W   Enable variable line width
  85.  
  86.      -w   Disable variable line width. Only "\thicklines"  and/or
  87.           "\thinlines"  commands  will be generated in the output
  88.           file.
  89.  
  90.      When variable line width  option  is  enabled,  "\thinlines"
  91.      command  is  still used when line width is less than LineTh-
  92.      ick. One potential problem is that the width of "\thinlines"
  93.      is  0.4pt  but  the  resolution of Fig is 1/80 inch (approx.
  94.      1pt). If LineThick is set to 2, normal lines will  be  drawn
  95.      in  0.4pt wide lines but the next line width is already 2pt.
  96.      One possible solution is to set LineThick to 1 and  set  the
  97.      width  of  the  those  lines you want to be drawn in "\thin-
  98.      lines"  to 0.
  99.  
  100.      Due  to  this  problem,  Varible  line  width  VarWidth   is
  101.      defaulted to be false.
  102.  
  103.  
  104. LATEX OPTIONS
  105.      -l   Sets the threshold between LaTeX thin and  thick  lines
  106.           to  lwidth  pixels.   LaTeX supports only two different
  107.           line width: \thinlines and \thicklines.  Lines of width
  108.           greater  than  lwidth  pixels are drawn as \thicklines.
  109.           Also affects the size of dots  in  dotted  line  style.
  110.           The default is 0.
  111.  
  112.      -d   Set a seperate magnification for  the  length  of  line
  113.           dashes to dmag.
  114.  
  115.      -v   Verbose mode.
  116.  
  117.      LaTeX cannot accurately represent all the  graphics  objects
  118.      which  can  be  described by Fig.  For example, the possible
  119.      slopes which lines may have are limited.  Some objects, such
  120.      as spline curves, cannot be drawn at all.  Fig2latex chooses
  121.      the closest possible line slope, and prints  error  messages
  122.      when objects cannot be drawn accurately
  123.  
  124.  
  125. PICTEX OPTIONS
  126.      -p Set the symbol used by  PiCTeX  for  plotting  lines  and
  127.      curves to psymbol. The default is "\sevrm ."
  128.  
  129.      -l   Set the width of any rules used to draw lines and boxes
  130.           within the picture to lwidth. The default is "0.7pt".
  131.  
  132.      In order to include PiCTeX pictures into a document,  it  is
  133.      necessary to load the PiCTeX macros.
  134.  
  135.      PiCTeX uses TeX  integer  register  arithmetic  to  generate
  136.      curves,  and  so  it  is  very slow.  PiCTeX draws curves by
  137.      \put-ing the psymbol repeatedly, and  so  requires  a  large
  138.      amount  of  TeX's  internal  memory, and generates large DVI
  139.      files.  The size of TeX's memory limits the number  of  plot
  140.      symbols in a picture.  As a result, it is best to use PiCTeX
  141.      to generate small pictures.
  142.  
  143.  
  144. POSTSCRIPT OPTIONS
  145.      -c   option centers the figure on the page.   The  centering
  146.           may  not be accurate if there are texts in the fig_file
  147.           that extends too far to the right of other objects.
  148.  
  149.      -P   indicates that the figure describes a full  page  which
  150.           will  not  necessarily be inserted into a document, but
  151.           can be sent directly to a  PS  printer.   This  ensures
  152.           that  a  showpage command is inserted at the end of the
  153.           figure, and inhibits translation of the figure  coordi-
  154.           nate system.
  155.  
  156.      -l   Rotate figure to landscape mode.
  157.  
  158.  
  159. SEE ALSO
  160.      [x]fig(1), pic(1) pic2fig(1), transfig(1)
  161.  
  162. AUTHORS
  163.      Micah Beck (beck@svax.cs.cornell.edu)
  164.      Cornell University
  165.      May 7 1989
  166.  
  167.      and Frank Schmuck (then of Cornell University)
  168.      and Conrad Kwok (then of the U.C. Davis).
  169.  
  170.      Modified from f2p (fig to PIC), by the author of Fig
  171.      Supoj Sutanthavibul (supoj@sally.utexas.edu)
  172.      University of Texas at Austin.
  173.