home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / useful / dist / text / tex / pastex / man / fig / xfig.man < prev   
Text File  |  1991-07-18  |  18KB  |  480 lines
  1.  
  2.  
  3.  
  4. XFIG(1)                  USER COMMANDS                    XFIG(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      xfig - Facility for Interactive Generation of figures  under
  10.      X11
  11.  
  12. SYNOPSIS
  13.      xfig [ -ri[ght] ] [ -le[ft] ] [ -L[andscape] ] [ -P[ortrait]
  14.      ]  [ -w[idth] inches ] [ -h[eight] inches ] [ -no[track] ] [
  15.      -tr[ack] ] [ file ]
  16.  
  17. DESCRIPTION
  18.      Xfig is a menu-driven tool that allows the user to draw  and
  19.      manipulate  objects  interactively  in an X window.  It runs
  20.      under X version 11 release 2  and  requires  a  three-button
  21.      mouse.   File specifies the name of a file to be edited. The
  22.      description of objects in the file will be read at the start
  23.      of xfig.
  24.  
  25.      The output from xfig can be printed in several ways
  26.  
  27.      troff - f2p (xfig to pic(1) translator, also  known  by  its
  28.      previous name ftop(1L)) is used to translate xfig files into
  29.      pic(1) language.  The resulting file may then  be  processed
  30.      in the same maner as any other pic file.
  31.  
  32.      postscript - f2ps (xfig to postscript translator) is used to
  33.      produce a postscript file from an xfig file.  The postscript
  34.      file can be sent directly to a postscript printer.
  35.  
  36.      LaTeX - fig2latex (xfig  to  LaTeX  translator)  produces  a
  37.      LaTeX file from an xfig file.  This file contains LaTeX pic-
  38.      ture environment commands and can be  processed  along  with
  39.      other LaTeX commands.
  40.  
  41.      PiCTeX - fig2tex (xfig  to  PiCTeX  translator)  produces  a
  42.      PiCTeX  file  from  an xfig file.  This file contains macros
  43.      that can be used with the PiCTeX environment  under  TeX  or
  44.      LaTeX.
  45.  
  46. OPTIONS
  47.      -ri  Change the position of the panel window to the right of
  48.           the canvas window (default: left).
  49.  
  50.      -le  Change the position of the panel window to the left  of
  51.           the canvas window.
  52.  
  53.      -L   Make xfig come up in landscape mode (10" x 7.5").
  54.  
  55.      -P   Make xfig come up in portrait mode (7.5" x  10").  This
  56.           is the default.
  57.  
  58.      -w inches
  59.           Make xfig come up inches wide.
  60.  
  61.      -h inches
  62.           Make xfig come up inches high.
  63.  
  64.      -tr  Turn on cursor (mouse) tracking arrows.
  65.  
  66.      -no  Turn off cursor (mouse) tracking arrows.
  67.  
  68. GRAPHICAL OBJECTS
  69.      The objects in xfig are divided into primitive  objects  and
  70.      compound  object.  The  primitive  objects are: ARC, CIRCLE,
  71.      CLOSED SPLINE, ELLIPSE, POLYLINE, POLYGON, SPLINE, and TEXT.
  72.      A  primitive  can  be  moved,  rotated,  flipped,  copied or
  73.      erased.  A compound object is composed of primitive objects.
  74.      The  primitive objects that constitute a compound can not be
  75.      individually modified, but they can  be  manipulated  as  an
  76.      entity; a compound can be moved, rotated, flipped, copied or
  77.      erased.  An extra function that can be applied to a compound
  78.      object  is  scaling,  which  is  not available for primitive
  79.      objects.
  80.  
  81. DISPLAY WINDOWS
  82.      Five windows comprise the display  area  of  xfig:  the  top
  83.      ruler, the side ruler, the panel window, the message window,
  84.      and the canvas window. The  message  window  always  appears
  85.      below  the others; it is the area in which messages are sent
  86.      and received.  The panel window can be placed to the left or
  87.      right of the the canvas window (default: left).
  88.  
  89. POP-UP MENU
  90.      The pop-up menu appears  when  the  right  mouse  button  is
  91.      pressed with the cursor positioned within the canvas window.
  92.      Positioning the cursor  over  the  desired  menu  entry  and
  93.      releasing the button selects a menu entry.
  94.  
  95.      There are a number of file accessing functions in the pop-up
  96.      menu.   Most  of  the  time  when  one of these functions is
  97.      selected, the user will be asked for a file  name.   If  the
  98.      specified  file can be located and the access permission are
  99.      granted, xfig will carry out the function.  However in  case
  100.      things  go  wrong,  xfig will abort the function and printed
  101.      the causes on the message window.
  102.  
  103.      Undo Undo the last object creation or modification.
  104.  
  105.      Redisplay
  106.           Redraw the canvas.
  107.  
  108.      Remove all
  109.           Remove  all  objects  on  the  canvas  window  (can  be
  110.           undone).
  111.  
  112.      Edit file ...
  113.           The current contents of  the  canvas  are  cleared  and
  114.           objects  are  read  from  the specified file.  The user
  115.           will be asked for a file name.  This file  will  become
  116.           the current file.
  117.  
  118.      Save Save the current contents of the canvas in the  current
  119.           file.   If  no  file  is being edited, the user will be
  120.           asked for a file name as in the "Save in ..." function.
  121.  
  122.      Read file ...
  123.           Read objects from the specified  file  and  merge  them
  124.           with  objects  already  shown on the canvas.  (The user
  125.           will be asked for a file name.)
  126.  
  127.      Save as ...
  128.           Save objects on the screen into a file specified by the
  129.           user.  (The user will be asked for a file name.)
  130.  
  131.      Status
  132.           Show the name of the current file and directory.
  133.  
  134.      Change Directory
  135.           Change the working directory.  Any file name without  a
  136.           full  path  name will employ the current working direc-
  137.           tory.
  138.  
  139.      Save & Exit
  140.           Save the objects in the  current  file  and  exit  from
  141.           xfig.   If  there  is no current file, the user will be
  142.           asked for a file name.  No confirmation will be asked.
  143.  
  144.      Quit Exit from xfig, discarding all objects. The  user  will
  145.           be  asked  to  confirm the action, by clicking the left
  146.           button.
  147.  
  148.      Save as BITMAP ...
  149.           Create a bitmap picture of the drawings  for  use  with
  150.           other  tools  (for  example,  for use as an icon).  The
  151.           smallest rectangular area of  pixels  that  encompasses
  152.           the  figure is written to the named file (the user will
  153.           be asked for a file name) from top row  to  bottom  and
  154.           left  to  right  (in  Sun  raster  format).   Only TEXT
  155.           objects that are parts  of  compound  objects  will  be
  156.           treated  as parts of the picture; other texts are saved
  157.           as objects in xfig format following  the  bitmap  data.
  158.           The  coordinates  of  these text objects can be used to
  159.           identify locations on the bitmap.
  160.  
  161. PANEL WINDOW MANIPULATION FUNCTIONS
  162.      Icons in the  panel  window  represent  object  manipulation
  163.      functions,  modes  and  other  drawing or modification aids.
  164.      Manipulation  functions  are  selected  by  positioning  the
  165.      cursor  over  it  and  clicking  the left mouse button.  The
  166.      selected icon is highlighted, and a message  describing  its
  167.      function appears in the message window.
  168.  
  169.      The left and middle buttons are used  to  creat  and  modify
  170.      objects  in  the  canvas  window.   Most  actions start with
  171.      clicking of the left button and end  with  clicking  of  the
  172.      right  button.  There is no need to hold down a button while
  173.      positioning the cursor.
  174.  
  175. PANEL WINDOW COMMAND DESCRIPTIONS
  176.      Entries in the panel  window  can  be  classified  into  two
  177.      categories:  object  creation/modification/removal  commands
  178.      (only one of which may be active at any one time), and draw-
  179.      ing aids (which act as toggle switches).  There are two ways
  180.      for drawing circles, two for ellipses, two for  splines  and
  181.      two  for  closed splines.  There are two basic splines.  One
  182.      is the interpolated spline in which the spline pass thorough
  183.      the  entered points (knots).  The other is the normal spline
  184.      in which on control points are passed by the spline  (except
  185.      for the two end points in the open spline).
  186.  
  187. OBJECT CREATION/MODIFICATION/REMOVAL
  188.      Multiple commands are grouped thematically in the  following
  189.      descriptions (which is listed alphabetically).
  190.  
  191.      ADD/DELETE ARROWS
  192.           Add or delete arrow heads for POLYLINE, POLYGON, SPLINE
  193.           or  CLOSED  SPLINE  objects (points of a BOX can not be
  194.           added or deleted).
  195.  
  196.      ADD/DELETE POINTS
  197.           Add or delete points for POLYLINE, POLYGON,  SPLINE  or
  198.           CLOSED SPLINE objects (points of a BOX can not be added
  199.