home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Extra 1996 #6 / AmigaPlus-eXtra-6-96.iso.7z / AmigaPlus-eXtra-6-96.iso / programme / a-render / doc / a-render.doc < prev    next >
Text File  |  1987-03-22  |  5KB  |  128 lines
  1.  
  2. A-Render Instructions:
  3. ----------------------
  4.  
  5. Type 'render heart' to start the render program.
  6.  
  7. There are only a few menu choices in render, and one of those is quit, so
  8. that only leaves 2 menu items of importance.  The menu selection Save 
  9. Picture will save the current rendering to the current picture file as 
  10. named in the world file.  The menu selection Next Picture will skip 
  11. rendering the rest of the current picture and move to the next line of the 
  12. world file.  The menu selections can also be chosen by holding the 'A' key
  13. to the right of the space bar, and typing 'N', 'S', or 'Q'.
  14.  
  15.  
  16. Most of the different options of render are controlled by a file called the
  17. world file.  This file will have a .world suffix added to it (like 
  18. heart.world).  The program Edworld was created to make the editing of the 
  19. world file as easy as possible,  but you'll need to understand the function
  20. of the options before you can use A-Render the best.
  21.  
  22.  
  23. You enter Edworld by typing 'edworld heart' (or any .world filename).
  24. If a world file is found, it is read and the frames are listed.  If no
  25. world file is found, the message 'Couldn't find world file' is displayed,
  26. along with a listing of no frames, just the heading line.
  27.  
  28.  
  29. If you have no frames defined, you'll have to add one before you can edit 
  30. it.  For example, type '2' to add a frame, then '1' to add it as frame 1.
  31. Then, to edit a frame, type '1 <RETURN>' followed by the frame number.
  32.  
  33.  
  34.  
  35.  
  36. Here is a description of the options functions:
  37. (with a general range of the options values)
  38.  
  39.  
  40.   1.  Print level -  Selects the print messages for the background screen.
  41.       Level 0 prints only minimal messages.
  42.       Level 1 also prints the R.G.B. value for each pixel.
  43.       Level 2 and beyond print debugging messages.
  44.       (Range: 0 - 2)
  45.  
  46.  
  47.   2.  Render mode -  Selects the render mode.
  48.       Mode 0 render's the picture to the HAM screen, and waits for the
  49.         user to select Next Picture in the menu.
  50.       Mode 1 duplicates mode 0, but automatically saves the HAM picture to
  51.         the specified picture file, and proceeds to the next picture.
  52.       Mode 2 renders the picture to disk in 3 files, (pic.r, .g, .b),
  53.         in an 8 bit per color mode.  
  54.       (Range: 0 - 2)
  55.  
  56.  
  57.   3.  Intensity multiplier -  An overall intensity setting for a scene.
  58.       This will allow you to adjust the overall lighting in a world, 
  59.         depending on the specific lighting conditions.  The more light
  60.         sources you have, the lower this number should be.
  61.       (Range: .1  - 100)
  62.      
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.   4.  Resolution multiplier -  Sets the rendering resolution.
  70.       Since rendering takes so long, we have a method for making a rough
  71.       image in a short time.  Render does this by calculating rays for a 
  72.       lower resolution screen, and blowing the dots up when displayed.
  73.       For example, we can calculate an image in 1/4 the time by making
  74.       the calculated pixels equal 4 pixels on the screen.  The ray traced
  75.       pixel in this case would be 2x2 screen pixels, and the value for
  76.       RESOLUTION MULTIPLIER would be 2.  Try a few different values and 
  77.       you'll understand what it does.
  78.       (Range: 1 to 40)
  79.  
  80.  
  81.   5.  Shadows on -  Sets the shadows to ON or OFF.
  82.       Calculating shadows takes a considerable amount of time.  A picture
  83.       with one light source and shadows ON takes twice as long to calculate
  84.       than with shadows off.  A picture with two light sources will take 
  85.       three times longer, three lights would be four times longer.
  86.       Type in a '1' and shadows will be ON, '0' means OFF.
  87.  
  88.  
  89.   6.  Start line -  You set a pixel line as the top starting line for
  90.       rendering.  This is feature that is useful in restarting picture
  91.       calculations.  There are 400 lines in the display.  If you set
  92.       RESOLUTION MULTIPLIER to 5, and START LINE to 10, it will start
  93.       rendering at screen line 50, skipping the top 1/8 of the picture.
  94.  
  95.  
  96.   7.  Transparency -  When no object is to displayed at a pixel, and this
  97.       is 0, then a black pixel is plotted.  If this is a 1, then nothing
  98.       is plotted, leaving the pixel as it was, for a transparency to the
  99.       background.
  100.  
  101.  
  102.   8.  Physical file name -  This specifies the file that render will load
  103.       as the 3-D database for this frame.  A name like heart.phys or
  104.       heart.phys.1 is appropriate.
  105.  
  106.  
  107.   9.  View file name -  Specifies the view pyramid to use for this frame.
  108.       The views are kept in the subdirectory /VIEWS and have names like
  109.       'front', 'top', 'left', 'angle'.
  110.  
  111.  
  112.  10.  Lights file name -  Specifies the light file to use for this frame.
  113.  
  114.  
  115.  11.  Picture file name -  Sets the Filename for the save of the IFF 
  116.       picture.  If render mode is 1, then the HAM image is saved in the 
  117.       picture file.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124. This is a good place to take a break if you like.  If you come back to
  125. A-Render later, simply type
  126. 'cd HEART' 
  127. to change back to the HEART directory, where you left off.
  128.