home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / EFFO / forum23.lzh / f23b / SOFTWARE / PDRAW / pdraw.doc < prev    next >
Text File  |  1992-01-19  |  9KB  |  265 lines
  1.  
  2.  
  3.  
  4. PDRAW(L)                 LOCAL COMMANDS                  PDRAW(L)
  5.  
  6.  
  7.  
  8. NAME
  9.      pdraw - 3D plot program for X-windows and Postscript
  10.  
  11. SYNOPSIS
  12.      pdraw [-v _v_x _v_y _v_z] [-o _o_p_t_i_o_n_s-_f_i_l_e] [-P_p_r_i_n_t_e_r] [-s _s_c_a_l_e]
  13.      [-e] [-h] [-nosort] [-ps] plotfile1 plotfile2...
  14.  
  15. DESCRIPTIONS
  16.      Pdraw is a program for drawing 3D plots on X10 or  X11  win-
  17.      dows.  The program will also produce a POSTSCRIPT plot which
  18.      can be dumped out to an APPLE Laserwriter.  Pdraw  reads  in
  19.      x-y-z  data  from  a  _p_l_o_t-_f_i_l_e  and  manipulates  that data
  20.      according to options specified either in the command-line or
  21.      in  a  _o_p_t_i_o_n_s-_f_i_l_e.   The  _p_l_o_t-_f_i_l_e can be compressed (see
  22.      compress[1]); compressed files will be uncompressed automat-
  23.      ically.   The  program then plots lines on a screen or dumps
  24.      the plots to a POSTSCRIPT file.
  25.  
  26.      The _p_l_o_t-_f_i_l_e input data consists of alternating x, y and  z
  27.      values, in the format shown below.
  28.  
  29.           Data File Format (plot-file)
  30.  
  31.            xmin xmax ymin ymax zmin zmax
  32.            ncurves
  33.            npts
  34.            z1
  35.            z2
  36.            ..
  37.            ..
  38.            ..
  39.            npts
  40.            z1
  41.            z2
  42.            ..
  43.            ..
  44.            ..
  45.  
  46.      In the above, _x_m_i_n, _x_m_a_x, _y_m_i_n,  _y_m_a_x,  _z_m_i_n  and  _z_m_a_x  are
  47.      lower  and upper bounds of the desired plot, _n_c_u_r_v_e_s are the
  48.      number of curves to be plotted, and _n_p_t_s are the  number  of
  49.      points  in  each  curve.   The data file can consist of more
  50.      than one set of curves to be plotted; each set (i.e. one set
  51.      for  each  separate  graph)  is separated from the next by a
  52.      blank line.
  53.  
  54.      Upon starting up the program, pdraw will read  in  the  data
  55.      stored  in  the  _p_l_o_t-_f_i_l_e,  as well as any plotting options
  56.      specified either in the command line or in the _o_p_t_i_o_n_s-_f_i_l_e.
  57.      Pdraw  then  uses  the  given  view  direction to rotate and
  58.      transform the plot onto a plane perpendicular to the viewing
  59.      vector.   Currently,  only parallel projection is supported.
  60.  
  61.  
  62.  
  63. Sun Release 4.0   Last change: 4 September 1990                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PDRAW(L)                 LOCAL COMMANDS                  PDRAW(L)
  71.  
  72.  
  73.  
  74.      If the program is being run under X-windows, the  plot  will
  75.      then  be  drawn  on  the  screen.  The viewing vector can be
  76.      changed using the "H", "J", "K", "L" and "O" keys on the the
  77.      keyboards;  the  plot  on the screen can be rotated sideways
  78.      using the "H" or "L" keys, rotated up or down using the  "J"
  79.      and  "K"  keys,  and  drawn with the original viewing vector
  80.      using "O".  The "A", "S", "D" and "F" keys will produce  90o
  81.      rotations.   "Z"  will  plot  the image projected on the x-y
  82.      plane (z=constant), "Y" will plot the image projected on the
  83.      x-z  plane  (y=constant),  and  "X" will plot the image pro-
  84.      jected on the y-z plane (x=constant).  The final view  angle
  85.      will be saved and used for the POSTCRIPT plot.  Finally, the
  86.      user will be prompted as to whether or  not  the  POSTSCRIPT
  87.      plot is to be sent to a printer.
  88.  
  89. OPTIONS
  90.      -v _v_x _v_y _v_z
  91.           reads in the viewing eye position, relative to (0,0,0).
  92.           The  plot  will  be rotated and transformed so that the
  93.           z-axis is parallel to this position.   For  example,  a
  94.           view position of (1,0,0) means that the 3D structure is
  95.           being viewed with parallel projection from the x-axis.
  96.  
  97.      -o _o_p_t_i_o_n_s-_f_i_l_e
  98.           reads plotting  options  from  the  file  _o_p_t_i_o_n_s-_f_i_l_e.
  99.           Each option specification consists of a keyword and its
  100.           corresponding value.  The parser recognizes only a lim-
  101.           ited  set of keywords; their values are either numbers,
  102.           quoted strings, or the words "on" and "off".   All  the
  103.           words  in  the option specification must be on the same
  104.           line.  The pound sign (#) indicates that the  remainder
  105.           of the line is a comment to be ignored by the parser.
  106.  
  107.           List of Options (options-file)
  108.  
  109.                xlabel   "LABEL"        #[default   =    "X-Axis"]
  110.                        - for the x-label
  111.                ylabel   "LABEL"        #[default   =    "Y-Axis"]
  112.                        - for the y-label
  113.                zlabel    "LABEL"      #[default    =    "Z-Axis"]
  114.                        - for the z-label
  115.                toplabel "LABEL"    #[default =  "3D  Line  Plot"]
  116.                  - for the top-label
  117.                equalscale    on/off       #[default     =     on]
  118.                              - for equal x-y scaling
  119.                postscript   on/off          #[default    =    on]
  120.                              - for postscript (PS) plot
  121.                printplot   on/off           #[default   =    off]
  122.                             - send PS file to printer
  123.                noplot    on/off          #[default     =     off]
  124.                             - no graphics plot
  125.                printer          "PRINTER"   #[default           =
  126.  
  127.  
  128.  
  129. Sun Release 4.0   Last change: 4 September 1990                 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PDRAW(L)                 LOCAL COMMANDS                  PDRAW(L)
  137.  
  138.  
  139.  
  140.                $PRINTER]         - define the printer
  141.                line    on/off             #[default     =     on]
  142.                              - draw the line
  143.                linechange    on/off      #[default     =     off]
  144.                             - change the linetypes
  145.                marker    on/off          #[default     =     off]
  146.                             - draw the marker
  147.                markerchange   on/off        #[default   =    off]
  148.                             - change the markertypes
  149.                hiddenline    on/off      #[default     =     off]
  150.                             - for hidden-line drawings
  151.                nosort    on/off          #[default     =     off]
  152.                             - for hidden-line drawings
  153.                scale  [0.1  -  1.0]         #[default   =   1.00]
  154.                       - scales the PS plot
  155.                xticks  [1   -   20]            #[default   =   2]
  156.                               - no. of x-divisions
  157.                yticks  [1   -   20]            #[default   =   2]
  158.                               - no. of y-divisions
  159.                zticks  [1   -   20]            #[default   =   2]
  160.                               - no. of z-divisions
  161.  
  162.      -P_p_r_i_n_t_e_r
  163.           specifies which printer to which to send the postscript
  164.           plot.  The current default sets the printer name to the
  165.           environment variable $PRINTER.  If this variable is not
  166.           set,  then  the  printer  used is the lp550M printer in
  167.           550M Cory.
  168.  
  169.      -s _s_c_a_l_e
  170.           sets a scale factor.  This is used only for  POSTSCRIPT
  171.           plotting.
  172.  
  173.      -e   forces _u_n_e_q_u_a_l scales to be applied to the x, y  and  z
  174.           axes.  The boundary of the 3D object will then resemble
  175.           a cube.
  176.  
  177.      -h   draws polygons with hidden-lines.
  178.  
  179.      -nosort
  180.           prevents sorting for the hidden-line option.
  181.  
  182.      -noplot
  183.           prevents plots on the graphics display.
  184.  
  185.      -print
  186.           sends plots to the printer automatically.
  187.  
  188.      -ps  turns the postscript plotting option off.
  189.  
  190.      _h_o_s_t:_d_i_s_p_l_a_y
  191.           opens a window on the given host and display
  192.  
  193.  
  194.  
  195. Sun Release 4.0   Last change: 4 September 1990                 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PDRAW(L)                 LOCAL COMMANDS                  PDRAW(L)
  203.  
  204.  
  205.  
  206.      =geom
  207.  
  208.      -rv
  209.  
  210.      -bw _b_o_r_d_e_r-_w_i_d_t_h
  211.  
  212.      -bd _c_o_l_o_r
  213.  
  214.      -fg _c_o_l_o_r
  215.  
  216.      -bg _c_o_l_o_r
  217.           sets input options for the X-window system.
  218.  
  219. BUGS
  220.      Not really that many.  The  POSTSCRIPT  labels  need  to  be
  221.      adjusted.   The  labels don't come out well when the picture
  222.      is rotated beyond the default view.  The parser needs to  be
  223.      improved.   There should be a better way to put change line-
  224.      types and markertypes.  Log axes might be nice.  Also should
  225.      incorporate drawplot modifications here.
  226.  
  227. AUTHOR
  228.      Kenny K.H. Toh (ktoh@mascot.berkeley.edu)
  229.  
  230. FILES
  231.      _d_a_t_a_p_l_o_t._p_s    temporary POSTSCRIPT file
  232.  
  233. SEE ALSO
  234.      contour(L), drawplot(L)
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sun Release 4.0   Last change: 4 September 1990                 4
  262.  
  263.  
  264.  
  265.