home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fonts 1 / freshfonts1.bin / programs / amiga / pastex / man / fig / fig.man < prev    next >
Text File  |  1991-07-18  |  15KB  |  379 lines
  1.  
  2.  
  3.  
  4. FIG(1)                   USER COMMANDS                     FIG(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      fig - Facility for Interactive Generation of figures
  10.  
  11. SYNOPSIS
  12.      fig [ -r ] [ file ]
  13.  
  14. DESCRIPTION
  15.      Fig is a menu-driven tool that allows the user to  draw  and
  16.      manipulate  objects  interactively  on  the  screen of a Sun
  17.      Workstation. It  can  only  be  run  within  the  SunWindows
  18.      environment  and requires a three-button mouse.  File speci-
  19.      fies the name of a file to be  edited.  The  description  of
  20.      objects in the file will be read at the start of fig.
  21.  
  22.      The output from fig can be printed by first using  f2p  (fig
  23.      to  pic(1)  translator,  also  known  by  its  previous name
  24.      ftop(1L)) to translate it into pic(1) language.  The  pic(1)
  25.      file  can  be  saved and edited like ordinary text file.  To
  26.      print the file one should issue the command:
  27.      pic file | troff
  28.      adding any required options to the invocation  of  troff(1).
  29.      The  file may be used in conjunction with any other troff(1)
  30.      preprocessors.
  31.  
  32.      Another way to produce a hrad copy is to use f2ps  (the  fig
  33.      to  postscript translator) to produce a postscript file from
  34.      fig file.  The postscript file can be  sent  directly  to  a
  35.      postscript printer via lpr(1).
  36.  
  37. OPTIONS
  38.      -r   Change the position of the panel window to the right of
  39.           the canvas window (default: left).
  40.  
  41. GRAPHICAL OBJECTS
  42.      The objects in fig are divided into  primitive  objects  and
  43.      compound  object.  The  primitive  objects are: ARC, CIRCLE,
  44.      CLOSED SPLINE, ELLIPSE, POLYLINE, POLYGON, SPLINE, and TEXT.
  45.      A  primitive  can  be  moved,  rotated,  flipped,  copied or
  46.      erased.  A compound object is composed of primitive objects.
  47.      The  primitive objects that constitute a compound can not be
  48.      individually modified, but they can  be  manipulated  as  an
  49.      entity; a compound can be moved, rotated, flipped, copied or
  50.      erased.  An extra function that can be applied to a compound
  51.      object  is  scaling,  which  is  not available for primitive
  52.      objects.
  53.  
  54. DISPLAY WINDOWS
  55.      Three windows comprise the display area of  fig:  the  panel
  56.      window  the  message window, and the canvas window. The mes-
  57.      sage window always appears below the others; it is the  area
  58.      in  which  messages are sent and received. from the The menu
  59.      window can be placed to the left or right of the the  canvas
  60.      window (default: left).
  61.  
  62. POP-UP MENU
  63.      The pop-up menu appears  when  the  right  mouse  button  is
  64.      pressed with the cursor positioned within the canvas window.
  65.      Positioning the cursor  over  the  desired  menu  entry  and
  66.      releasing the button selects a menu entry.
  67.  
  68.      There are a number of file accessing functions in the pop-up
  69.      menu.   Most  of  the  time  when  one of these functions is
  70.      selected, the user will be asked for a file  name.   If  the
  71.      specified  file can be located and the access permission are
  72.      granted, fig will carry out the function.  However  in  case
  73.      things go wrong, fig will abort the function and printed the
  74.      causes on the message window.
  75.  
  76.      Undo Undo the last object creation or modification.
  77.  
  78.      Redisplay
  79.           Redraw the canvas.
  80.  
  81.      Remove all
  82.           Remove  all  objects  on  the  canvas  window  (can  be
  83.           undone).
  84.  
  85.      Edit file ...
  86.           The current contents of  the  canvas  are  cleared  and
  87.           objects  are  read  from  the specified file.  The user
  88.           will be asked for a file name.  This file  will  become
  89.           the current file.
  90.  
  91.      Save Save the current contents of the canvas in the  current
  92.           file.   If  no  file  is being edited, the user will be
  93.           asked for a file name as in the "Save in ..." function.
  94.  
  95.      Read file ...
  96.           Read objects from the specified  file  and  merge  them
  97.           with  objects  already  shown on the canvas.  (The user
  98.           will be asked for a file name.)
  99.  
  100.      Save as ...
  101.           Save objects on the screen into a file specified by the
  102.           user.  (The user will be asked for a file name.)
  103.  
  104.      Status
  105.           Show the name of the current file and directory.
  106.  
  107.      Change Directory
  108.           Change the working directory.  Any file name without  a
  109.           full  path  name will employ the current working direc-
  110.           tory.
  111.  
  112.      Save & Exit
  113.           Save the objects in the current file and exit from fig.
  114.           If there is no current file, the user will be asked for
  115.           a file name.  No confirmation will be asked.
  116.  
  117.      Quit Exit from fig, discarding all objects. The user will be
  118.           asked  to confirm the action, by clicking the left but-
  119.           ton.
  120.  
  121.      Save as BITMAP ...
  122.           Create a bitmap picture of the drawings  for  use  with
  123.           other  tools  (for  example,  for use as an icon).  The
  124.           smallest rectangular area of  pixels  that  encompasses
  125.           the  figure is written to the named file (the user will
  126.           be asked for a file name) from top row  to  bottom  and
  127.           left  to  right  (in  Sun  raster  format).   Only TEXT
  128.           objects that are parts  of  compound  objects  will  be
  129.           treated  as parts of the picture; other texts are saved
  130.           as objects in fig format  following  the  bitmap  data.
  131.           The  coordinates  of  these text objects can be used to
  132.           identify locations on the bitmap.
  133.  
  134. MENU WINDOW MANIPULATION FUNCTIONS
  135.      Icons in the menu window represent object manipulation func-
  136.      tions,  modes and other drawing or modification aids.  Mani-
  137.      pulation functions are selected by  positioning  the  cursor
  138.      over  it  and  clicking the left mouse button.  The selected
  139.      icon is highlighted, and a message describing  its  function
  140.      appears in the message window.
  141.  
  142.      The left and middle buttons are used  to  creat  and  modify
  143.      objects  in  the  canvas  window.   Most  actions start with
  144.      clicking of the left button and end  with  clicking  of  the
  145.      right  button.  There is no need to hold down a button while
  146.      positioning the cursor.
  147.  
  148. MENU WINDOW COMMAND DESCRIPTIONS
  149.      Entries in the panel  window  can  be  classified  into  two
  150.      categories:  object  creation/modification/removal  commands
  151.      (only one of which may be active at any one time), and draw-
  152.      ing aids (which act as toggle switches).  There are two ways
  153.      for drawing circles, two for ellipses, two for  splines  and
  154.      two  for  closed splines.  There are two basic splines.  One
  155.      is the interpolated spline in which the spline pass thorough
  156.      the  entered points (knots).  The other is the normal spline
  157.      in which on control points are passed by the spline  (except
  158.      for the two end points in the open spline).
  159.  
  160. OBJECT CREATION/MODIFICATION/REMOVAL
  161.      Multiple commands are grouped thematically in the  following
  162.      descriptions (which is listed alphabetically).
  163.  
  164.      ADD/DELETE ARROWS
  165.           Add or delete arrow heads for POLYLINE, POLYGON, SPLINE
  166.           or  CLOSED  SPLINE  objects (points of a BOX can not be
  167.           added or deleted).
  168.  
  169.      ADD/DELETE POINTS
  170.           Add or delete points for POLYLINE, POLYGON,  SPLINE  or
  171.           CLOSED SPLINE objects (points of a BOX can not be added
  172.           or deleted).
  173.  
  174.      ARC  Create an arc.  Specify three  points  using  the  left
  175.           button.
  176.  
  177.      BOX  Create rectangular boxes.  Start with the  left  button
  178.           and terminate with the right button.
  179.  
  180.      BREAK COMPOUND
  181.           Break  a compound object to allow manipulation  of  its
  182.           component parts.  Click the left button on the bounding
  183.           box of the compound object.
  184.  
  185.      CIRCLE
  186.           Create circles by specifying their radii or  diameters.
  187.           Click  the  left  button on the canvas window, move the
  188.           cursor until the desired radius or diameter is reached,
  189.           then  click  the middle button to terminate. The circle
  190.           will be drawn after the pressing of the middle button.
  191.  
  192.      CLOSED INTERPOLATED SPLINE
  193.           Create closed or periodic  splines.