Editing Glome tutorial (section)

===File Reference===

First, an overview of the source code files.  Glome is currently split amongst many source files and between GlomeTrace and GlomeVec is about 3500 lines of code.  Some of the interesting files are:

;Vec.hs
:This is the vector library.  It contains all the things you might want to do with vectors: add, subtract, normalize, take dot products and cross products, reverse a vector, etc...  It also includes the transformation matrix code, and routines for transforming vectors, points, and normals.  A data type "Flt" is defined for floating point numbers.  Switching from Float to Double or vice versa is a matter of changing the definition of Flt in Vec.hs and CFlt in Clr.hs.

;Clr.hs
:Color library.  Colors are records of three floats in RGB format.  There's nothing surprising or particularly clever here.

;Solid.hs
:This is where most of the interesting definitions are: definitions of the Solid typeclass and SolidItem existential type, definitions of the Rayint type, and a few of the base primitives (like Group, Void, and Instance).

;Trace.hs
:This contains the "trace" function, which converts a ray and a scene into a color to be drawn to the screen.

;Shader.hs
:This provides an illumination model.  (You can implement your own, but most of the time you'll want to stick with materialShader.)

;Bih.hs
:The BIH acceleration structure.

;Sphere.hs, Triangle.hs, Box.hs, Plane,hs, Cone.hs, etc..
:Basic geometric primitives.

;Glome.hs
:The main loop of the program, part of the GlomeView package.  All SDL-related code resides in this module.  Also included is a get_color function that accepts screen coordinates and a scene, and computes the ray for that screen coordinate, traces the ray, and returns the color.

;TestScene.hs
:This is what gets rendered if no input file is specified.  This is meant to be edited by users.  Provided in GlomeView package.

;SolidTexture.hs
:Perlin noise and other related texture functions.  Part of GlomeVec package.

;Spd.hs
:NFF file parser for SPD scenes.