Scene Class


Summary

Class scene encapsulates a lot of 3Dengine data.  It provides a method for
reading scene files, and methods for setting up background flats and
environment cubes(skyboxes).  A method for writing scene files will be added
eventually.


State

 window	*win		window pointer

 camera	*cam		camara pointer

 Color	bgcolor		background color
			Default [0, 0, 0, 0] (black)

 Color	ambient		ambient material color which is applied to newly
			imported models
			Default [.2, .2, .2, 1] (dark gray)

 Color	diffuse		diffuse material color which is applied to newly
			imported models
			Default [.8, .8, .8, 1] (light gray)

 Color	specular	specular material color which is applied to newly
			imported models
			Default [0, 0, 0, 0] (black)

 Color	emission	emissive material color which is applied to newly
			imported models
			Default [0, 0, 0, 0] (black)

 float shininess	specular falloff which is applied to newly imported
			models
			Default: 1

 vectd	mapmin		minumum XYZ coordinates of the scene
			Default: -1000
			Element range: double precision floating point numbers

 vectd	mapmax		maximum XYZ coordinates of the scene
			Default: 1000
			Element range: double precision floating point numbers

 double	speed		speed factor for changes in camera position
			Default: 25
			Suggested range [1, 100]

 double	rotspeed	speed factor for changes in camera rotation
			Default: 0.25
			Suggested range [0, 1]

 double	rotaccel	acceleration factor for changes in camera rotation
			Default: 7.5
			Suggested range [1, 20]

 double	eyespacing	distance between eyes for stereo rendering
			Default: 0.04
			Suggested range [.01, .1]

 model	*background	pointer to a model consisting of a textured quad to be
			used as a static background image

 model	*skybox		pointer to a model consisting of a textured cube to be
			use as an environment cube

 sllist<terrain>
  *terrainlist		list off terrains contained in the scene

 sllist<model>
  *modellist		list of models contained in the scene

 sllist<model>
  *hierarchy		list of models without parents contained in the scene

 sllist<texture>
  *texturelist		list of textures contained in the scene

 light
  lights[GL_MAX_LIGHTS]	array of lights

 fog_state *fog		fog state structure


Methods

	scene()

		Set default values as listed above.  Pointers are set to NULL.

 void	read(FILE *ENV)

		Read a scene(.sce) file from the given file pointer.

 void	write(FILE *SCE)

		Write a scene(.sce) file to the given file pointer.
		--not implemented at the moment :(

 void	background_setup()

		Setup a background flat, compiling it into a displaylist.

 int	skybox_setup(cave_object *cave)

		Setup a skybox(env cube), compiling it into a displaylist.

		Return zero upon success, less-than-zero upon failure.