home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 058.lha / 3D.doc < prev    next >
Text File  |  1986-11-20  |  8KB  |  217 lines
  1.     --------------------------------------------------------
  2.     Documentation for 3DGrapher, copyright 1987 Randy Finch.
  3.     --------------------------------------------------------
  4.  
  5.     This program consumes mucho memory.  Therefore if you only have
  6.     512K, do not load Workbench and resize CLI window very small.  The
  7.     program makes AmigaDOS calls, thus it must be loaded from CLI.
  8.     Make sure AmigaBASIC, 3DGrapher, dos.bmap, and graphics.bmap are
  9.     on the same disk.  Insert in df1:.  If you have no df1:, then buy
  10.     one quickly, OR make sure you change curdir$ near the beginning of
  11.     the program to df0:, or dh0: (lucky you!), or whatever.  First
  12.     change the current directory to df1: or whatever you've chosen,
  13.     run AmigaBASIC, enter CLEAR,75000 in immediate mode, and then load
  14.     3D (it is in ASCII format).  If you have a 512K machine,
  15.     resize the output window to a small size, close the list window
  16.     and run the program.  The program is menu driven; the text below
  17.     explains these menus.
  18.  
  19.  
  20.     There are four main menu items: SET, COLOR, FILE, and FUNCTION.
  21.  
  22.     ------------------------------------------------------------------
  23.  
  24.     Under SET are the following:
  25.  
  26.     Origin:
  27.  
  28.          Just click the LMB with the pointer over the point on the
  29.     screen where the axes origin is to be.  If the origin is
  30.     offscreen, click in the extreme upper left hand corner of the
  31.     screen and a requester will allow you to enter the point.  This
  32.     origin point is actually the point where the line from the origin
  33.     to your eyeball intersects the projection plane.  (See Projection
  34.     Plane below).
  35.  
  36.     Rotation:
  37.  
  38.          This allows you to set the rotation angles from the default
  39.     axes orientation.  The default is X positive to the right, Y
  40.     positive upward, and Z positive perpendicular to the screen
  41.     towards YOU!  A positive rotation about an axis is accomplished by
  42.     holding the positive half of the axis and rotating clockwise.  (I
  43.     know this is opposite to what some of you are used to, but I like
  44.     to be different.)
  45.  
  46.     Scale:
  47.  
  48.          This sets the number of screen pixels that represent one
  49.     unit along the axes.  The larger this number, the more magnified
  50.     the graph will be.
  51.  
  52.     View Distance:
  53.  
  54.          This is the distance in units the viewer is from the
  55.     projection plane.  (Don't go holding a ruler from your eyeball to
  56.     the screen.)
  57.  
  58.     Projection Plane:
  59.  
  60.          This is the distance along the Z axis (default orientation)
  61.     that the projection plane is from the axes origin.  It can be
  62.     positive or negative.  The CRT screen is always the projection
  63.     plane, so this determines whether the origin is in front of or
  64.     behind the screen and how far away it is.
  65.  
  66.     Line Spacing:
  67.  
  68.          The program draws a wire frame of the graph.  This menu item
  69.     allows the user to set the spacing of the wires in the X and Y
  70.     directions (by units, not pixels).
  71.  
  72.     Plot Precision:
  73.  
  74.          This sets how far apart each plotted point, along individual
  75.     wires, is in units.  3DGrapher tries to prevent a point farther
  76.     away from the viewer from overwriting a point closer to the
  77.     viewer.  This will be more effective if the plot precision is high
  78.     (small value for spacing).  Also, the plot will look smoother with
  79.     a high precision.  Typically, while experimenting with a new
  80.     graph, it is good to plot with a wide line spacing and a low
  81.     precision until the graph is oriented the way you want.  Then set
  82.     the line spacing to a smaller value and increase precision for the
  83.     final plot since this will take longer.
  84.  
  85.     Plot Span:
  86.  
  87.          The range for the plot along the X and Y axes.
  88.  
  89.     Axes Span:
  90.  
  91.          The range for plotting the axes along the X, Y, and Z axes.
  92.     Also, the precision of the axes plot can be set here.  Unlike the
  93.     plot of the graph, which connects points with a line, the axes is
  94.     drawn as a series of dots.  The precision sets how far apart these
  95.     dots are in units.
  96.  
  97.     Crosshatch On:
  98.  
  99.          This will cause the program to plot the graph as a
  100.     crosshatched wireframe, drawing wires along the X and Y axes.
  101.  
  102.     Crosshatch Off:
  103.  
  104.          This will cause the program to draw along only one axis.  You
  105.     choose which axis it will be.  This setting is recommended if the
  106.     line spacing is very small because there is no need to crosshatch
  107.     if the graph is nearly solid anyway.
  108.  
  109.     Axes On:
  110.  
  111.          Plot the axes.
  112.  
  113.     Axes Off:
  114.  
  115.          Do NOT plot the axes.
  116.  
  117.     ------------------------------------------------------------------
  118.  
  119.     Under COLOR are the following:
  120.  
  121.     Background:
  122.  
  123.          This selection brings up some RGB sliders that allow the
  124.     screen color to be set.
  125.  
  126.     Graph:
  127.  
  128.          The actual graph is plotted using 16 colors.  The default
  129.     colors range from a deep blue to white with shades of blue in
  130.     between.  The deep blue represents points far from the viewer,
  131.     while white represents points near the viewer.  This requester
  132.     allows the user to change the far and near colors; the program
  133.     will create an even transition for the 14 colors in the middle.
  134.  
  135.     Axes:
  136.  
  137.          Set the color of the axes.
  138.  
  139.     Border:
  140.  
  141.          Set the screen border color.
  142.  
  143.     Text:
  144.  
  145.          Set the color of any text the program puts on the screen.
  146.  
  147.     ----------------------------------------------------------------
  148.  
  149.     Under FILE are the following:
  150.  
  151.     Save Picture:
  152.  
  153.          Save the screen bitmap to disk.  The program will add the
  154.     extension ".3D" to the filename.  You will be warned if the file
  155.     exists.  This routine using AmigaDOS calls so make sure the C:
  156.     directory is available.  The save takes about 90 seconds so be
  157.     patient.  (NOTE: I like to use a popup IFF saver to save the
  158.     screen as an ILBM file that can be read into DPaint.)  The
  159.     settings will be saved also.
  160.  
  161.     Save Settings:
  162.  
  163.          This will allow you to save all those settings under the menu
  164.     SET to disk.  An extension of ".SET" will be added.
  165.  
  166.     Get Picture:
  167.  
  168.          Retrieve a bitmap from disk.  You can view the directory;
  169.     only .3D files will be seen.  You can also change directories from
  170.     this routine.  This is a lengthy process like Save was.  The
  171.     settings will also be retrieved.
  172.  
  173.     Get Settings:
  174.  
  175.          Retrieve settings from disk.
  176.  
  177.     ------------------------------------------------------------------
  178.  
  179.     Under FUNCTION are the following:
  180.  
  181.     Plot:
  182.  
  183.          Begin plotting the graph.
  184.  
  185.     Stop Plot:
  186.  
  187.          Interrupt the graph plotting.
  188.  
  189.     Input Equation:
  190.  
  191.          There is no direct way to input the equation.  When you
  192.     choose this option, the program will end and the list window will
  193.     appear with the equation definition statement at the top of the
  194.     window.  Edit this equation and then copy it to the string
  195.     equation$ defined under the DEF FN statement.  This string is
  196.     used for viewing the equation when the Show Equation menu item
  197.     is chosen, and is also used to make sure there is no mismatch of
  198.     picture and settings after saving and loading.  Please note that
  199.     this equation is in the form Z=F(X,Y).  By only defining either X
  200.     or Y in the equation and carefully selecting plot ranges and
  201.     rotation angles, a two-dimensional plot can be made.
  202.  
  203.     Show Equation:
  204.  
  205.          Displays the current equation (assuming you followed the
  206.     directions above).
  207.  
  208.     Show Settings:
  209.  
  210.          Displays all the settings that can be changed under SET on
  211.     the screen at once.  No changes can be made from here.
  212.  
  213.     Quit:
  214.  
  215.          Stop running this program. I'm sick and tired of looking at
  216.     graphs.
  217.