home *** CD-ROM | disk | FTP | other *** search
/ Power DOS 1995 July / Power_DOS_CD-ROM_Walnut_Creek_July_1995.iso / graphics / raytrace / raypack.doc < prev    next >
Text File  |  1993-04-04  |  5KB  |  176 lines
  1.           RAYPACK - Basic include file generators for Vivid 2 (tm)
  2.           ********************************************************
  3.  
  4.                                            Paul Smith  9th March 1993
  5.                                            **************************
  6.  
  7. RAYPACK is a group of Qbasic source files that are designed to create
  8. "XXX.vi" include files for use with Stephen Coy's excellent Vivid 
  9. Raytracer.
  10.  
  11. They are each invoked from the command line with a command of the format :
  12.  
  13. QBASIC /run progname > incfile.vi
  14.  
  15. Qbasic is supplied "free" with MS DOS version 5, and it's a pretty useful
  16. basic, with a pretty useful editor built in. All these little programs 
  17. will take much longer to trace than to generate the incfile, so don't 
  18. feel too bad about using BASIC. Real programmers do use basic sometimes. 
  19.  
  20. The use of "command line redirection" captures the output of the Qbasic
  21. PRINT command to a disc file. This makes for easy development and debugging.
  22.  
  23. It is hoped that you will load the programs into Qbasic and edit parameters 
  24. in order to vary or extend the effects or patterns provided. This is a 
  25. really excellent place to start if you are new to programming ! Working
  26. with a short tested program, with a visible output sure beats the pants off
  27. fumbling around blind !
  28.  
  29. While the comments in the programs are fairly limited, in most cases 
  30. the functions and variables should become pretty obvious following a bit 
  31. of study.
  32.  
  33.  
  34. Having generated a incfile.vi file you will want to feed this to VIVID,
  35. I use a standard file called "do.v" and an example is included here. It
  36. works as follows :
  37.  
  38. DO.V
  39.  
  40. #include colors.vo
  41.  
  42. camera definition
  43.  
  44. studio definition
  45.  
  46. light definition
  47.  
  48. texture definition
  49.  
  50. #include xxx.vi <=============== reads output from RAYPACK program
  51.  
  52. floor definition
  53.  
  54.                         ****************************
  55.  
  56. Descriptions of individual programs :
  57.  
  58.  
  59. GRAD     BAS      
  60.  
  61. Designed to generate a graduated background. A large number of adjacent
  62. rectangular panels are defined with gradually changing colours. Use as
  63. a sunset or night sky on the Horizon.
  64.  
  65.  
  66.  
  67. LISS     BAS
  68.  
  69. Generates a series of sphere definitions following a complex curved path. 
  70. There are some variable definitions at the start of the program which are
  71. well worth playing with for a wide range of effects.
  72.  
  73.  
  74.      
  75. STARS    BAS      
  76.  
  77. Generates an overhead starfield.
  78.  
  79.  
  80.  
  81. CAUSEWAY BAS      
  82.  
  83. Generates crazy hexagonal paving, similar to the crystalline Giant's
  84. Causeway in Ireland
  85.  
  86.  
  87.  
  88. DODEC    BAS      
  89.  
  90. Generates a Dodecahedron (10 equal pentagonal faces). I'm sure that there
  91. are better methods, but hey, this does work ...
  92.  
  93.  
  94.  
  95. SPIRAL   BAS      
  96.  
  97. Generates a string of spheres in a spiral pattern.
  98.  
  99.  
  100.  
  101. STELDOD  BAS      
  102.  
  103. Generates a stellated dodecahedron. (10 pentagonal faces, with a 
  104. pentagonal pyramid stuck on each face. The Pyramid may be sticky-out 
  105. or sticky-in depending on the value. 
  106.  
  107.  
  108.  
  109. SURFPAT  BAS      
  110.  
  111. This outputs smooth triangle data from a mathmatical function. The 
  112. included function is "sin(x)/x", but can readily be changed.
  113.  
  114.  
  115.  
  116. CBALL    BAS      
  117.  
  118. Generates a "spikey ball" made of cones.
  119.  
  120.  
  121. GRID     BAS      
  122.  
  123. Generates a criss cross matrix of rods. 
  124.  
  125.  
  126.                     **************************
  127.  
  128.  
  129. Disclaimer :
  130.  
  131. These programs are supplied "as is" without warranty of any kind. If you 
  132. decide to use them you assume the entire risk, including, but not limited,
  133. to damage to hardware or software, loss of data, unexpected rainstorms and
  134. visitations by alien beings.
  135.  
  136. RAYPACK is not guaranteed to do anything at all. 
  137.  
  138.  
  139.  
  140.  
  141. Limited Licence :
  142.  
  143. You are entitled to use this program for up to 30 days for the purposes
  144. of evaluation. If you wish to continue to use it beyond that time you 
  145. should make a small payment to the author.
  146.  
  147. This program and the accompanying documentation are copyright Paul Smith
  148. 1992 / 1993. They are not public domain or freeware and a small payment 
  149. should be made to the author if found useful.
  150.  
  151. For a non-commercial use on a single machine the author suggests a single
  152. payment of 5 pounds stirling. Different offers of payment will be accepted.
  153. Whatever you think is right will probably be fine by me.
  154.  
  155.  
  156.                           **************************
  157.  
  158. Vivid is a trademark of the most excellent God of Raytracing - Stephen Coy
  159. MS DOS and QBasic are a trademarks of Microsoft
  160. RAYPACK is a trademark of Paul Smith
  161.  
  162.                           **************************
  163.  
  164.  
  165. RAYPACK programs and documentation are copyright : 
  166.  
  167. Paul Smith                    Author's  BBS : RAYTECH BBS +44 86288 340
  168. Rubicon                             fidonet : 2:259/49
  169. Clashmore                           PCGnet  : 9:/526/464   
  170. near Dornoch
  171. Sutherland                          or FAX  : +44 86288 377
  172. Scotland
  173. IV25 3RG
  174.  
  175. Comments are welcome.      Enjoy !
  176.