home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / grafix / 3d / iiutilities.lha / IIUtilities / Stars.ReadMe < prev    next >
Encoding:
Text File  |  1995-01-19  |  4.4 KB  |  111 lines
  1.  
  2.                              --- Stars V1.2 ---
  3.  
  4. What is it?
  5.  
  6.  Stars is a program that will generate starfields in TDDD format.
  7.  (Thats the file format for Imagine 3D)
  8.  
  9. Usage is pretty simple.  All you need to supply is a filename, number
  10. of stars and the distance from the axis that they are to be placed.
  11.  
  12.  Ex: "Stars Universe.iob 500 160"
  13.  
  14. This will generate a sphere of 500 stars placed 160 Imagine units from
  15. the axis of the object.  There are more paramaters to further customise
  16. your starfield.  A template can be listed by typing "Stars ?" and the
  17. paramaters can be given out of order by supplying the keyword.
  18.  
  19.  Ex: "Stars SPHERESIZE 160 FILE Universe.iob NUMSTARS 500"
  20.  
  21. Explanations of all the paramaters are listed below...
  22.  
  23. FILE: (Required/String)
  24.  
  25.   This is the filename to save the imagine TDDD file to.
  26.  
  27. NUMSTARS: (Required/Number)
  28.  
  29.   How many stars in your universe?
  30.  
  31. SPHERESIZE: (Number)
  32.  
  33.   This is how far from the center of the object the stars are
  34.   placed at.  The stars are distributed over the surface of a
  35.   sphere by default and this is the radius of that sphere.
  36.  
  37. MINSTARSIZE, MAXSTARSIZE: (Number)
  38.  
  39.   How big are the stars?  If just MINSTARSIZE is given the stars
  40.   will all be the same size.  If both MAX and MIN values are given
  41.   the stars will be randomly sized between these two values.
  42.  
  43. RANDSPHERESIZE: (Number)
  44.  
  45.   Normally the stars are placed to cover the outside of a sphere.
  46.   This will randomly vary the sphere radius for each star by the
  47.   specified amount.  Use a value equal to the SPHERESIZE to have
  48.   a sphere volume of stars instead of a surface.
  49.  
  50. MINRED, MAXRED, MINGREEN, MAXGREEN, MINBLUE, MAXBLUE: (Number)
  51.  
  52.   Each star can be randomly colored.  This sets the colors for
  53.   the stars.  The colors are picked between the min and max
  54.   values.  If you set MIN to 255,255,100 and MAX to 0,0,0 you
  55.   will get a color range from black to yellow.
  56.  
  57. SEED: (Number)
  58.  
  59.   By default Stars seeds the random number generator with the
  60.   Amiga's clock to give diffrent starmaps each rendering.  But
  61.   sometimes you might want to render with the same seed.  For
  62.   example, render two starfields exactly the same except for
  63.   the star sizes.  You could then have the star sizes change in
  64.   an animation.  Or better, change the SPHERESIZE from very
  65.   small to very large.  Use states to make an explosion of stars.
  66.  
  67. SQUARE: (Switch)
  68.  
  69.   If this switch is on, the stars will fill a cube instead of
  70.   a sphere. RANDSPHERESIZE is ignored.
  71.  
  72. PARTICLES: (Switch)
  73.  
  74.   Normally stars are made up of four sided objects.  This switch
  75.   tells stars to make them out of a single triangle.  It also 
  76.   turns on Particles for this object, setting the Type to Sphere
  77.   and Alignment to Faces.  This is useful for when you want to get a
  78.   little closer to the stars or want to use a diffrent shape than
  79.   the one Stars generates.  This produces the best looking stars
  80.   in my opinion since CSG spheres will not have angles no matter
  81.   how close you get to them.  NOTE!  Remember to use trace mode
  82.   unless you set the particle type to somethign diffrent.  CSG
  83.   spheres are made up of triangles in Scanline and it will eat all
  84.   your memory if you use lots of CSG stars in Scanline.  In trace
  85.   mode it is pretty memory efficent.
  86.  
  87. Ok.. to get an idea of what this looks like do the following...
  88.  
  89.  "Stars universe.iob 2500 2000 1 25 PARTICLES"
  90.  
  91. Now load this object into the detail editor.  Your view should be inside
  92. the sphere of stars.  Use "Reset View" if this is not the case.
  93. Now render this in full TRACE mode in hires.  You should se a nice
  94. starfield full of stars of differing size and brightness.  And better
  95. yet, the stars will not dissapear when you render a 1280x800 project like
  96. the Imagineones do.  Imagine's stars are only a single pixel, so the
  97. entire look of them changes when you change screen modes.  Not good.
  98.  
  99. For an interesting swarming effect make a project and copy the included
  100. staging file into it.  Next go to the Ram Disk and make six starfields
  101. named Stars0.iob to Stars5.iob with the command... "Stars <name> 20 160 75"
  102. Now make a preview looping anim in the Stage editor...  since each starfield
  103. is random it makes a pretty interecting scene for such a simple setup.  There
  104. are lots of possibilities here..  you could make the SPHERESIZE 1 at the
  105. start of the anim and 160 at the end to have the objects swarm outward
  106. randomly.  Let me know anything neat you do!  :-)
  107.  
  108. --
  109. IanSmith@psu.edu <-- Use first
  110. Ian.Smith@f564.n2601.z1.fidonet.org
  111.