Read Me

Gneiss is compiled to one executable. Output is written in BMP files in a sub-
directory. Renders/ is for single images, render/ for animations. Some output
is also in tmp/. If the right directory doesn't exist, gneiss will just silently
not write output.

Different use cases are documented below:

*********************
* Planet generation *
*********************

run the fresh gneiss executable.


******************************
* Nebula graphics generation *
******************************

to access the nebula, you got to comment line 37 in mathUT.h and rebuild.




**********************
* Coding conventions *
**********************

An effort-like thing is made to use standard SI units if not specified otherwise.
So here's a key that just might help with variable names:

x, y, z			Cartesian coordinates
x1, x2, x3, face	Internal coordinates for cubed sphere. -1 .. 1, -1 .. 1, N levels, 0 .. 5 face
r, th, ph		Spherical coordinates in radians. Radius meters, theta 0 .. pi, phi 0 .. 2pi.
r, theta, phi		Same
h, lat, lon		height above mean radius, latitude -90 .. 90 degrees, longitude 0 .. 360 deg.
R0			Mean radius