source: 2013/24/AamosR/asteroid/readme.html @ 4075

<h1>Asteroid rendering shell script</h1>

<p>Inspired on <a href="http://i-simplicity.de/tutorials.html">this tutorial</a>,
uses <a href="http://povray.org/">povray</a> to render asteroids. Annoyingly povray
doesn&rsquo;t do parameters, so hence the shell script. I have only run it on linux.</p>

<h3>Useage:</h3>

<p>export variables or define them right before the call. Defaults are intended
to be reasonable. It will also output a file which indicates what the
parameters where.</p>

<h3>Examples:</h3>

<pre><code>sh asteroid.sh
size=0.5 sh asteroid.sh
lz = -800 sh asteroid.lsh
</code></pre>

<h3>Variables:</h3>

<pre><code>w,h:       width and height. (800,800)

size:      size of asteroid(0.5 to 0.7 is ok) (0.5)
x,y,z:     camera position. (17,0,0)
angle:     angle of view. (10)
           (has to be tuned with size and x,y,z)

lx,ly,lz:  light source position (500,500,800)
to_pov:    .pov file to output.  (/tmp/`date +%s`.pov)
to_png:    .png file to output. (/output/`date +%s`.png)

version:   povray version. (3.7)
</code></pre>

<h2>Caveits</h2>

<p>Things could be better, no terrible shell-script, it is probably possible, but
difficult, to turn the isosurface into a mesh, and also generate the texture.
But that is a whole project on itself.</p>

<h2>Author</h2>

<p>Jasper den Ouden</p>

<h2>License</h2>

<p>CC0, or public domain, whichever one chooses.</p>