Code Overview

Code Overview for Assignment 3 (OpenGL)

This web page describes the code that is used for assignment 3. (Pretty similar to the code for assignment 2.) It contains:

File List
Class And Struct List
Function List
Class And Struct Description
Members And Methods List
Function Description
Class and Struct Members and Methods Description

Note:

As a matter of notation, all colors are specified by a 3D array where the first coordinate specifies the red color, the second specifies the green color, and the third specifies the blue color.
Flt is a typedef for double. This can be changed in the code but should not be.

FILE LIST:

Main Ray Tracing Code:

rayView.[cpp/h] The code responsible for managing all of the OpenGL commands responsible for displaying the scene.

Shape Classes:

shape.h The abstract base class that all shapes must implement
group.[cpp/h] Code for the Shape subclass describing a scene-graph
rayFileInstance.[cpp/h] Code for the Shape subclass describing the scene graph specified in a .ray file
triangle.[cpp/h] Code for the Shape subclass describing a triangle
sphere.[cpp/h] Code for the Shape subclass describing a sphere
cone.[cpp/h] Code for the Shape subclass describing a cone
cylinder.[cpp/h] Code for the Shape subclass describing a cylinder
box.[cpp/h] Code for the Shape subclass describing a box
line.[cpp/h] Code for the Shape subclass describing a line segment

Light Classes:

light.[cpp/h] The abstract base class that all lights must implement
pointLight.[cpp/h] Code for the Light subclass describing a point light
directionalLight.[cpp/h] Code for the Light subclass describing a directional light
spotLight.[cpp/h] Code for the Light subclass describing a spot light

Other Code:

main.cpp This parses apart the command line arguments and invokes the raytracer
scene.[cpp/h] Code for the classes that store environmental information, textures, materials, rayFiles etc.
geometry.[cpp/h] Most of the code for the geometric manipulation you will need (matrix multiplication, vector addition etc.)
bmp.[cpp/h] Code responsible for reading and writing BMP files
boundingBox.[cpp/h] Code for defining bounding boxes

Return to top.

CLASS AND STRUCT LIST:

File Name	Type	Name	Subclass Of
shape.h	class	Shape
group.[cpp/h]	class	ShapeListElement
group.[cpp/h]	class	Group	Shape
rayFileInstance.[cpp/h]	class	RayFileInstance	Shape
triangle.[cpp/h]	class	Triangle	Shape
sphere.[cpp/h]	class	Sphere	Shape
cone.[cpp/h]	class	Cone	Shape
cylinder.[cpp/h]	class	Cylinder	Shape
box.[cpp/h]	class	Box	Shape
line.[cpp/h]	class	Line	Shape
light.[cpp/h]	class	Light
pointLight.[cpp/h]	class	PointLight	Light
directionalLight.[cpp/h]	class	DirectionalLight	Light
spotLight.[cpp/h]	class	SpotLight	Light
scene.[cpp/h]	class	Camera
scene.[cpp/h]	class	Vertex
scene.[cpp/h]	class	Material
scene.[cpp/h]	class	Texture
scene.[cpp/h]	class	RayFile
scene.[cpp/h]	class	Scene
geometry.[cpp/h]	class	Point2D
geometry.[cpp/h]	class	Point3D
geometry.[cpp/h]	class	Ray
geometry.[cpp/h]	class	Matrix
bmp.[cpp/h]	struct	Pixel
bmp.[cpp/h]	struct	Image
boundingBox.[cpp/h]	class	BoundingBox

Return to top.

FUNCTION LIST:

File Name	Function Name
rayView.[cpp/h]	void RayView(const char* fileName, int width, int height, int cplx)
rayView.[cpp/h]	void Init(void)
rayView.[cpp/h]	void Keyboard(unsigned char c, int x, int y)
rayView.[cpp/h]	void SpecialKeys(int key, int x, int y)
rayView.[cpp/h]	void DepressedMotion(int x, int y)
rayView.[cpp/h]	void Motion(int x, int y)
rayView.[cpp/h]	void Mouse(int button, int state, int x, int y)
rayView.[cpp/h]	void DrawModeMenu(int entry)
rayView.[cpp/h]	void MainMenu(int entry)
rayView.[cpp/h]	void TakeSnapshot(char* fileName)
rayView.[cpp/h]	void Draw(void)
rayView.[cpp/h]	void Reshape(int width, int height)
main.cpp	int main(int argc, char** argv)
geometry.[cpp/h]	Matrix IdentityMatrix(void)
bmp.[cpp/h]	Image* ImageNew(int width, int height)
bmp.[cpp/h]	void ImageFree(Image** img)
bmp.[cpp/h]	void ImageCopy(Image* src, Image* dst)
bmp.[cpp/h]	int ImageIsValid(Image* img)
bmp.[cpp/h]	Pixel* ImageGetPixel(Image* img, int x, int y)
bmp.[cpp/h]	void ImageSetPixel(Image* img, int x, int y, Pixel* p)

Return to top.

CLASS AND STRUCT DESCRIPTION:

Shape: This abstract class is used to describe all shapes that are draw-able.
ShapeListElement: This class is used to store a linked list of shapes
Group: This subclass of Shape represents a single node of the scene-graph
RayFileInstance: This subclass of Shape is used to point to an instance of a scene-graph that is read out of a .ray file
Triangle: This subclass of Shape represents a triangle
Sphere: This subclass of Shape represents a sphere
Cone: This subclass of Shape represents a cone
Cylinder: This subclass of Shape represents a cylinder
Box: This subclass of Shape represents a box
Line: This subclass of Shape represents a line segment
Light: This abstract is used to describe all the different lights within the scene
PointLight: This subclass of Light is used to describe a point-light
DirectionalLight: This subclass of Light is used to describe a directional-light
SpotLight: This subclass of Light is used to describe a spot-light
Camera: This class is used to describe the location and orientation of the camera in the scene
Vertex: This class represents a vertex, it stores the vertex position, normal, and texture coordinate
Material: This class is used to store material information about a Shape
Texture: For Shapes that support texture-mapping this class stores the Image corresponding to the texture
RayFile: This class stores the instance of a scene-graph that is read out of a .ray file
Scene: This class is used to store all the information read out from a .ray file
Point2D: This class represents a 2D vector
Point3D: This class represents a 3D vector
Ray: This class represents a directed ray
Matrix: This class represents a 4x4 matrix, used to describe local transformations
BoundingBox: This class is used to describe the bounding box of a Shape
Pixel: This stores the red, green, and blue components of a pixel
Image: This describes a 2D array of pixels which store an image

Return to top.

MEMBERS AND METHODS LIST:

File Name	Method/Member Name
Shape
shape.h	virtual char* Shape::name(void)
shape.h	virtual void Shape::write(int indent, FILE* fp=stdout)
shape.h	virtual BoundingBox Shape::getBoundingBox(void)
shape.h	virtual void Shape::draw(int cplx)
shape.h	void Shape::free(void)
ShapeListElement
group.[cpp/h]	ShapeListElement* ShapeListElement::next
group.[cpp/h]	Shape* ShapeListElement::shape
group.[cpp/h]	ShapeListElement::ShapeListElement(Shape* shape)
group.[cpp/h]	void ShapeListElement::addShape(Shape* shape)
Group
group.[cpp/h]	Matrix Group::localTransform
group.[cpp/h]	ShapeListElement* Group::shapeList
group.[cpp/h]	Group::Group(FILE* fp)
group.[cpp/h]	Group::Group(Matrix localTransform)
group.[cpp/h]	void Group::addShape(Shape* shape)
group.[cpp/h]	char* Group::name(void)
group.[cpp/h]	void Group::write(int indent, FILE* fp=stdout)
group.[cpp/h]	BoundingBox Group::getBoundingBox(void)
group.[cpp/h]	void Group::draw(int cplx)
group.[cpp/h]	void Group::free(void)
RayFileInstance
rayFileInstance.[cpp/h]	RayFileInstance::RayFileInstance(RayFile* rayFile)
rayFileInstance.[cpp/h]	char* RayFileInstance::name(void)
rayFileInstance.[cpp/h]	void RayFileInstance::write(int indent, FILE* fp=stdout)
rayFileInstance.[cpp/h]	BoundingBox RayFileInstance::getBoundingBox(void)
rayFileInstance.[cpp/h]	void RayFileInstance::draw(int cplx)
Triangle
triangle.[cpp/h]	Vertex* Triangle::v[3]
triangle.[cpp/h]	Material* Triangle::material
triangle.[cpp/h]	Triangle::Triangle(Vertex* v1, Vertex* v2, Vertex* v3, Material* material)
triangle.[cpp/h]	Triangle::Triangle(FILE* fp, int* materialIndex, Vertex* vList, int vSize)
triangle.[cpp/h]	char* Triangle::name(void)
triangle.[cpp/h]	void Triangle::write(int indent, FILE* fp=stdout)
triangle.[cpp/h]	BoundingBox Triangle::getBoundingBox(void)
triangle.[cpp/h]	void Triangle::draw(int cplx)
Sphere
sphere.[cpp/h]	Point3D Sphere::center
sphere.[cpp/h]	Flt Sphere::radius
sphere.[cpp/h]	Material* Sphere::material
sphere.[cpp/h]	Sphere::Sphere(Point3D center, Flt radius, Material* material)
sphere.[cpp/h]	Sphere::Sphere(FILE* fp, int* materialIndex)
sphere.[cpp/h]	char* Sphere::name(void)
sphere.[cpp/h]	void Sphere::write(int indent, FILE* fp=stdout)
sphere.[cpp/h]	BoundingBox Sphere::getBoundingBox(void)
sphere.[cpp/h]	void Sphere::draw(int cplx)
Cone
cone.[cpp/h]	Point3D Cone::center
cone.[cpp/h]	Flt Cone::height
cone.[cpp/h]	Flt Cone::radius
cone.[cpp/h]	Material* Cone::material
cone.[cpp/h]	Cone::Cone(Point3D center, Flt height, Flt radius, Material* material)
cone.[cpp/h]	Cone::Cone(FILE* fp, int* materialIndex)
cone.[cpp/h]	char* Cone::name(void)
cone.[cpp/h]	void Cone::write(int indent, FILE* fp=stdout)
cone.[cpp/h]	BoundingBox Cone::getBoundingBox(void)
cone.[cpp/h]	void Cone::draw(int cplx)
Cylinder
cylinder.[cpp/h]	Point3D Cylinder::center
cylinder.[cpp/h]	Flt Cylinder::height
cylinder.[cpp/h]	Flt Cylinder::radius
cylinder.[cpp/h]	Material* Cylinder::material
cylinder.[cpp/h]	Cylinder::Cylinder(Point3D center, Flt height, Flt radius, Material* material)
cylinder.[cpp/h]	Cylinder::Cylinder(FILE* fp, int* materialIndex)
cylinder.[cpp/h]	char* Cylinder::name(void)
cylinder.[cpp/h]	void Cylinder::write(int indent, FILE* fp=stdout)
cylinder.[cpp/h]	BoundingBox Cylinder::getBoundingBox(void)
cylinder.[cpp/h]	void Cylinder::draw(int cplx)
Box
box.[cpp/h]	Point3D Box::center
box.[cpp/h]	Point3D Box::length
box.[cpp/h]	Material* Box::material
box.[cpp/h]	Box::Box(Point3D center, Point3D length, Material* material)
box.[cpp/h]	Box::Box(FILE* fp, int* materialIndex)
box.[cpp/h]	char* Box::name(void)
box.[cpp/h]	void Box::write(int indent, FILE* fp=stdout)
box.[cpp/h]	BoundingBox Box::getBoundingBox(void)
box.[cpp/h]	void Box::draw(int cplx)
Line
line.[cpp/h]	Point3D Line::start
line.[cpp/h]	Point3D Line::end
line.[cpp/h]	Material* Line::material
line.[cpp/h]	Line::Line(Point3D start, Point3D end, Material* material)
line.[cpp/h]	Line::Line(FILE* fp, int* materialIndex)
line.[cpp/h]	Line::Line(Ray ray, Material* material)
line.[cpp/h]	char* Line::name(void)
line.[cpp/h]	void Line::write(int indent, FILE* fp=stdout)
line.[cpp/h]	BoundingBox Line::getBoundingBox(void)
line.[cpp/h]	void Line::draw(int cplx)
Light
light.h	Point3D Light::color
light.h	virtual int Light::read(FILE* fp)
light.h	virtual void Light::write(FILE* fp=stdout)
light.h	virtual void Light::draw(int lightNum)
PointLight
pointLight.[cpp/h]	Point3D PointLight::location
pointLight.[cpp/h]	Flt PointLight::constAtten
pointLight.[cpp/h]	Flt PointLight::linearAtten
pointLight.[cpp/h]	Flt PointLight::quadAtten
pointLight.[cpp/h]	int PointLight::read(FILE* fp)
pointLight.[cpp/h]	void PointLight::write(FILE* fp=stdout)
pointLight.[cpp/h]	void PointLight::draw(int lightNum)
DirectionalLight
directionalLight.[cpp/h]	Point3D DirectionalLight::direction
directionalLight.[cpp/h]	int DirectionalLight::read(FILE* fp)
directionalLight.[cpp/h]	void DirectionalLight::write(FILE* fp=stdout)
directionalLight.[cpp/h]	void DirectionalLight::draw(int lightNum)
SpotLight
spotLight.[cpp/h]	Point3D SpotLight::location
spotLight.[cpp/h]	Point3D SpotLight::direction
spotLight.[cpp/h]	Flt SpotLight::constAtten
spotLight.[cpp/h]	Flt SpotLight::linearAtten
spotLight.[cpp/h]	Flt SpotLight::quadAtten
spotLight.[cpp/h]	Flt SpotLight::cutOffAngle
spotLight.[cpp/h]	Flt SpotLight::dropOffRate
spotLight.[cpp/h]	int SpotLight::read(FILE* fp)
spotLight.[cpp/h]	void SpotLight::write(FILE* fp=stdout)
spotLight.[cpp/h]	void SpotLight::draw(int lightNum)
Camera
scene.[cpp/h]	Flt Camera::heightAngle
scene.[cpp/h]	Flt Camera::aspectRatio
scene.[cpp/h]	Point3D Camera::position
scene.[cpp/h]	Point3D Camera::direction
scene.[cpp/h]	Point3D Camera::up
scene.[cpp/h]	Point3D Camera::right
scene.[cpp/h]	int Camera::read(FILE* fp)
scene.[cpp/h]	void Camera::write(FILE* fp=stdout)
scene.[cpp/h]	void Camera::draw(void)
Vertex
scene.[cpp/h]	int Vertex::index
scene.[cpp/h]	Point3D Vertex::position
scene.[cpp/h]	Point3D Vertex::normal
scene.[cpp/h]	Point2D Vertex::texCoordinate
scene.[cpp/h]	int Vertex::read(FILE* fp)
scene.[cpp/h]	void Vertex::write(FILE* fp=stdout)
Material
scene.[cpp/h]	int Material::index
scene.[cpp/h]	Point3D Material::ambient
scene.[cpp/h]	Point3D Material::diffuse
scene.[cpp/h]	Point3D Material::specular
scene.[cpp/h]	Point3D Material::emmisive
scene.[cpp/h]	Flt Material::kspec
scene.[cpp/h]	Flt Material::ktran
scene.[cpp/h]	Flt Material::refind
scene.[cpp/h]	Texture* Material::tex
scene.[cpp/h]	char Material::foo[ ]
scene.[cpp/h]	GLuint Material::handle
scene.[cpp/h]	int Material::read(FILE* fp)
scene.[cpp/h]	void Material::write(FILE* fp=stdout)
scene.[cpp/h]	void Material::draw(void)
Texture
scene.[cpp/h]	int Texture::index
scene.[cpp/h]	char Texture::filename[ ]
scene.[cpp/h]	Image* Texture::img
scene.[cpp/h]	GLuint Texture::handle
scene.[cpp/h]	int Texture::read(FILE* fp)
scene.[cpp/h]	void Texture::write(FILE* fp=stdout)
scene.[cpp/h]	void Texture::draw(void)
RayFile
scene.[cpp/h]	int RayFile::index
scene.[cpp/h]	char RayFile::filename[ ]
scene.[cpp/h]	Scene* RayFile::scene
scene.[cpp/h]	int RayFile::read(FILE* fp)
scene.[cpp/h]	void RayFile::write(FILE* fp=stdout)
scene.[cpp/h]	void RayFile::free(void)
Scene
scene.[cpp/h]	Point3D Scene::ambient
scene.[cpp/h]	Point3D Scene::background
scene.[cpp/h]	Camera Scene::camera
scene.[cpp/h]	Light Scene::lights**
scene.[cpp/h]	int Scene::lightNum
scene.[cpp/h]	Shape* Scene::shape
scene.[cpp/h]	Scene::Scene(void)
scene.[cpp/h]	void Scene::read(const char* filename)
scene.[cpp/h]	void Scene::write(FILE* fp=stdout)
scene.[cpp/h]	void Scene::draw(int cplx)
Point2D
geometry.[cpp/h]	Point2D::Point2D(void)
geometry.[cpp/h]	Point2D::Point2D(Flt x, Flt y)
geometry.[cpp/h]	Flt& Point2D::operator[ ] (int index)
geometry.[cpp/h]	void Point2D::print(void)
geometry.[cpp/h]	void Point2D::printnl(void)
geometry.[cpp/h]	Flt Point2D::dot(Point2D pt)
geometry.[cpp/h]	Flt Point2D::length(void)
geometry.[cpp/h]	Point2D Point2D::unit(void)
geometry.[cpp/h]	Point2D Point2D::negate(void)
geometry.[cpp/h]	Point2D Point2D::operator- (void)
geometry.[cpp/h]	Point2D Point2D::scale(Flt scl)
geometry.[cpp/h]	Point2D Point2D::operator* (Flt scale)
geometry.[cpp/h]	Point2D Point2D::operator/ (Flt scale)
geometry.[cpp/h]	Point2D Point2D::add(Point2D pt)
geometry.[cpp/h]	Point2D Point2D::operator+ (Point2D pt)
geometry.[cpp/h]	Point2D Point2D::subtract(Point2D pt)
geometry.[cpp/h]	Point2D Point2D::operator- (Point2D pt)
geometry.[cpp/h]	Point2D Point2D::mult(Point2D pt)
Point3D
geometry.[cpp/h]	Point3D::Point3D(void)
geometry.[cpp/h]	Point3D::Point3D(Flt x, Flt y, Flt z)
geometry.[cpp/h]	Flt& Point3D::operator[ ] (int index)
geometry.[cpp/h]	void Point3D::print(void)
geometry.[cpp/h]	void Point3D::printnl(void)
geometry.[cpp/h]	Flt Point3D::dot(Point3D pt)
geometry.[cpp/h]	Flt Point3D::length(void)
geometry.[cpp/h]	Point3D Point3D::unit(void)
geometry.[cpp/h]	Point3D Point3D::negate(void)
geometry.[cpp/h]	Point3D Point3D::operator- (void)
geometry.[cpp/h]	Point3D Point3D::scale(Flt scl)
geometry.[cpp/h]	Point3D Point3D::operator* (Flt scale)
geometry.[cpp/h]	Point3D Point3D::operator/ (Flt scale)
geometry.[cpp/h]	Point3D Point3D::add(Point3D pt)
geometry.[cpp/h]	Point3D Point3D::operator+ (Point3D pt)
geometry.[cpp/h]	Point3D Point3D::subtract(Point3D pt)
geometry.[cpp/h]	Point3D Point3D::operator- (Point3D pt)
geometry.[cpp/h]	Point3D Point3D::crossProduct(Point3D pt)
geometry.[cpp/h]	Point3D Point3D::mult(Point3D pt)
Ray
geometry.[cpp/h]	Point3D Ray::p
geometry.[cpp/h]	Point3D Ray::d
geometry.[cpp/h]	Ray::Ray(void)
geometry.[cpp/h]	Ray::Ray(Point3D p,Point3D d)
geometry.[cpp/h]	void Ray::print(void)
geometry.[cpp/h]	void Ray::printnl(void)
geometry.[cpp/h]	Ray Ray::translate(Point3D pt)
geometry.[cpp/h]	Point3D Ray::operator( ) (Flt param)
geometry.[cpp/h]	Point3D Ray::position(Flt param)
Matrix
geometry.[cpp/h]	Flt& Matrix::operator( ) (int col,int row)
geometry.[cpp/h]	Flt Matrix::det(void)
geometry.[cpp/h]	void Matrix::print(void)
geometry.[cpp/h]	void Matrix::printnl(void)
geometry.[cpp/h]	Matrix Matrix::mult(Matrix m)
geometry.[cpp/h]	Matrix Matrix::operator* (Matrix m)
geometry.[cpp/h]	Matrix Matrix::transpose(void)
geometry.[cpp/h]	Matrix Matrix::invert(void)
geometry.[cpp/h]	Point3D Matrix::multPosition(Point3D position)
geometry.[cpp/h]	Point3D Matrix::multDirection(Point3D direction)
geometry.[cpp/h]	Point3D Matrix::multNormal(Point3D normal)
geometry.[cpp/h]	Ray Matrix::mult(Ray ray)
geometry.[cpp/h]	Ray Matrix::operator* (Ray ray)
BoundingBox
boundingBox.[cpp/h]	Point3D BoundingBox::p[2]
boundingBox.[cpp/h]	BoundingBox::BoundingBox(void)
boundingBox.[cpp/h]	BoundingBox::BoundingBox(Point3D p1, Point3D p2)
boundingBox.[cpp/h]	BoundingBox::BoundingBox(Point3D* pList, int listSize)
boundingBox.[cpp/h]	BoundingBox BoundingBox::operator+ (BoundingBox b)
boundingBox.[cpp/h]	BoundingBox BoundingBox::Transform(Matrix m)
boundingBox.[cpp/h]	Flt BoundingBox::intersects(Ray ray)
Pixel
bmp.[cpp/h]	unsigned char Pixel::r
bmp.[cpp/h]	unsigned char Pixel::g
bmp.[cpp/h]	unsigned char Pixel::b
Image
bmp.[cpp/h]	int Image::width
bmp.[cpp/h]	int Image::height
bmp.[cpp/h]	Pixel* Image::pixels

Return to top.

FUNCTION DESCRIPTION:

void RayView(const char* fileName, int width, int height, int cplx)

width

height

cplx

Shape

void Init(void)

RayView

void Keyboard(unsigned char c, int x, int y)

This function is responsible for handling the user keyboard input.

void SpecialKeys(int key, int x, int y)

This function is responsible for handling the special keystrokes (e.g. page-up, etc.)

void DepressedMotion(int x, int y)

This event handler is called when the mouse moves and one of the mouse buttons is down.

void Motion(int x, int y)

This event handler is called when the mouse moves and none of the mouse buttons are down.

void Mouse(int button, int state, int x, int y)

button

GLUT_LEFT_BUTTON

GLUT_MIDDLE_BUTTON

GLUT_RIGHT_BUTTON

state

GLUT_UP

GLUT_DOWN

void DrawModeMenu(int entry)

This function is called to set the draw mode. It is called by OpenGL when the appropriate menu item is selected.

void MainMenu(int entry)

This function is called to handle the functions provided in the main menu. (Including, writing out the .ray format of the current view to a file, taking a snapshot, exiting, etc.)

void TakeSnapshot(char* fileName)

This function takes a snapshot of the current view-screen and writes it out as a .bmp file.

void Draw(void)

draw

void Reshape(int width, int height)

This function handles the resizing of the screen.

int main(int argc, char** argv)

rayView

Matrix IdentityMatrix(void)

Matrix

Image* ImageNew(int width, int height)

Image

void ImageFree(Image** img)

Image

void ImageCopy(Image* src, Image* dst)

src

dst

int ImageIsValid(Image* img)

img

Image

Pixel* ImageGetPixel(Image* img, int x, int y)

Pixel

Image

void ImageSetPixel(Image* img, int x, int y, Pixel* p)

Pixel

Image

not

Return to top.

CLASS AND STRUCT MEMBERS AND METHODS DESCRIPTION:

Shape: This class is the abstract class that all objects that are ray-tracable must implement.

virtual char* Shape::name(void): This abstract method returns a descriptive name of the Shape.
virtual void Shape::write(int indent, FILE* fp=stdout): This abstract method writes the Shape out to a file (default is STDOUT) in the .ray format. The indent parameter specifies the offset in white space to be used in writing.
virtual BoundingBox Shape::getBoundingBox(void): This method returns the bounding box for the Shape
virtual void Shape::draw(int cplx): This virtual method is reponsible for invoking the appropriate OpenGL commands necessary to draw the Shape. The cplx parameter specifies the complexity (in terms of tesselation) of the shape drawn.
void Shape::free(void): This method is called to free up any resources associated with the Shape

ShapeListElement: This class allows for a linked list of Shapes

ShapeListElement* ShapeListElement::next This is a pointer to the next element in the Shape list
Shape* ShapeListElement::shape: This is a pointer to the shape associated with the list element
ShapeListElement::ShapeListElement(Shape* shape): This constructor generates a new list element given a pointer to a Shape
void ShapeListElement::addShape(Shape* shape): Given an element of the list, this method adds a new element with the specified Shape into the list. (Immediately after the specified element.)

Group: This subclass of Shape consists of a local transformation and a list of Shapes to which the transformation is applied. (It is a subclass of Shape because one can determine the point of intersection with a group by intersecting with all the Shapes in its list and returning the closest point of intersection with the appropriate intersection information.) This class can be thought of as a single node in the scene-graph.

Matrix Group::localTransform: This stores the local transformation to be applied to all the Shapes in the list.
ShapeListElement* Group::shapeList: This is the list of Shapes associated to the group.
Group::Group(FILE* fp): Invoked by the .ray parser, this method reads in the local transformation from the file and sets its Shape list to NULL.
Group::Group(Matrix localTransform): This constructor creates a new Group object with the specified local transformation. The Shape list is set to NULL.
void Group::addShape(Shape* shape): This method adds a Shape to the list of Shapes.
char* Group::name(void): This method overrides the abstract Shape::name( ) method, and returns the string "group".
void Group::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
BoundingBox Group::getBoundingBox(void): This method overrides the abstract Shape::getBoundingBox( ) method. It does this by calling the Shape::getBoundingBox( ) method of each of the Shapes in its list of shapes. It then generates a new bounding box containing the union of all of the childrens' bounding boxes, and transforms it using the Group::localTransform. Before returning the bounding box to the user, it stores it in Group::bBox for future use.
void Group::draw(int cplx): This method overrides the abstract Shape::draw(int) method. This is done by pushing the appropriate matrix onto the matrix stack, calling the draw method of each of the child Shapes and then popping the matrix off of the stack.
void Group::free(void): This method frees up all resources associated with the Group by first freeing up all the resources associted with the Shapes in the list and then freeing the list itself.

RayFileInstance: If the .ray file includes other .ray files multiple times, it is desirable to have only one instance of the scene-graph specified in the .ray file and have it be accessible from different nodes. (This reduces the size of the scene-graph.) This class is a storage conatiner for the pointer to the scene-graph.

RayFileInstance::RayFileInstance(RayFile* rayFile): This instantiator generates a new instance which points to the specified RayFile.
char* RayFileInstance::name(void): This method overrides the abstract Shape::name( ) method and returns the string "ray file instance".
void RayFileInstance::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
BoundingBox RayFileInstance::getBoundingBox(void): This method overrides the abstract Shape::getBoundingBox( ) method. It returns the bounding box obtained by calling the Shape::getBoundingBox( ) method of the Shape pointed associated to the .ray file.
void RayFileInstance::draw(int cplx): This method overrides the abstract Shape::draw(int) method. It does so by calling the intersect method of the RayFile object it points to.

Triangle: This subclass of Shape describes a triangular shape.

Vertex* Triangle::v[3]: These are the pointers to three vertices defining the Triangle.
Material* Triangle::material: This stores the material associated with the Triangle.
Triangle::Triangle(Vertex* v1, Vertex* v2, Vertex* v3, Material* material): This constructor creates a new Triangle object with specified Vertex pointers and Material.
Triangle::Triangle(FILE* fp, int* materialIndex, Vertex* vList, int vSize): This constructor creates a new Triangle object by reading the vertex indices from the file, checking that they are within bounds and not equal, and setting the vertex pointer appropriately.
char* Triangle::name(void): This method overrides the abstract Shape::name( ) method and returns the string "triangle".
void Triangle::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
BoundingBox Triangle::getBoundingBox(void): This method overrides the abstract Shape::getBoundingBox( ) method. It returns the bounding box containing the three vertices of the triangle.
void Triangle::draw(int cplx): This method overrides the abstract Shape::draw(int) method.

Sphere: This subclass of Shape describes a sphere.

Point3D Sphere::center: This is the position of the center of the sphere.
Point3D Sphere::radius: This is the radius of the sphere
Material* Sphere::material: This stores the material associated with the Sphere.
Sphere::Sphere(Point3D center, Flt radius, Material* material): This constructor creates a new Sphere object with the specified center, radius and Material.
Sphere::Sphere(FILE* fp, int* materialIndex): This constructor creates a new Sphere object by reading the center and radius from the file. Additionally it sets the material index.
char* Sphere::name(void): This method overrides the abstract Shape::name( ) method and returns the string "sphere".
void Sphere::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
BoundingBox Sphere::getBoundingBox(void): This method overrides the abstract Shape::getBoundingBox( ) method. It returns the bounding box containing the Sphere.
void Sphere::draw(int cplx): This method overrides the abstract Shape::draw(int) method.

Cone: This subclass of Shape describes a cone.

Point3D Cone::center: This is the position of the center of the cone. (Note that this is not the position of the center of the cone's base.)
Flt Cone::height: This is the height of the cone.
Flt Cone::radius: This is the radius of the base of the cone.
Material* Cone::material: This stores the material associated with the Cone.
Cone::Cone(Point3D center, Flt height, Flt radius, Material* material): This constructor creates a new Cone object with specified center, height, radius, and Material.
Cone::Cone(FILE* fp, int* materialIndex): This constructor creates a new Cone object by reading the center, height and radius from the file. Additionally it sets the material index.
char* Cone::name(void): This method overrides the abstract Shape::name( ) method and returns the string "cone".
void Cone::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
BoundingBox Cone::getBoundingBox(void): This method overrides the abstract Shape::getBoundingBox( ) method. It returns the bounding box containing the Cone.
void Cone::draw(int cplx): This method overrides the abstract Shape::draw(int) method.

Cylinder: This subclass of Shape describes a cylinder.

Point3D Cylinder::center: This is the position of the center of the cylinder.
Flt Cylinder::height: This is the height of the cylinder.
Flt Cylinder::radius: This is the radius of the cylinder.
Material* Cylinder::material: This stores the material associated with the Cylinder.
Cylinder::Cylinder(Point3D center, Flt height, Flt radius, Material* material): This constructor creates a new Cylinder object with specified center, height, radius, and Material.
Cylinder::Cylinder(FILE* fp, int* materialIndex): This constructor creates a new Cylinder object by reading the center, height and radius from the file. Additionally it sets the material index.
char* Cylinder::name(void): This method overrides the abstract Shape::name( ) method and returns the string "cylinder".
void Cylinder::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
BoundingBox Cylinder::getBoundingBox(void): This method overrides the abstract Shape::getBoundingBox( ) method. It returns the bounding box containing the Cylinder.
void Cylinder::draw(int cplx): This method overrides the abstract Shape::draw(int) method.

Box: This subclass of Shape describes a box.

Point3D Box::center: This is the position of the center of the cyube.
Point3D Box::length: This specifies the dimensions of the box. (Note that the length specifies the length of the side, not the length from the center.)
Material* Box::material: This stores the material associated with the Box.
Box::Box(Point3D center, Point3D length, Material* material): This constructor creates a new Box object with specified center, lengths and Material.
Box::Box(FILE* fp, int* materialIndex): This constructor creates a new Box object by reading the center and length from the file. Additionally it sets the material index.
char* Box::name(void): This method overrides the abstract Shape::name( ) method and returns the string "box".
void Box::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
BoundingBox Box::getBoundingBox(void): This method overrides the abstract Shape::getBoundingBox( ) method. It returns the bounding box containing the Box.
void Box::draw(int cplx): This method overrides the abstract Shape::draw(int) method.

Line: This subclass of Shape describes a line segment. While it cannot be ray-traced (it does not have a surface) it is useful for debugging purposes when using the ray-viewer.

Point3D Line::start: This is the starting point of the line segment.
Point3D Line::end: This is ending point of the line segment.
Material* Line::material: This stores the material associated with the Line.
Line::Line(Point3D start, Point3D end, Material* material): This constructor creates a new Line object with specified start point, end point, and Material.
Line::Line(FILE* fp, int* materialIndex): This constructor creates a new Line object by reading the starting and ending points from the file. Additionally it sets the material index.
Line::Line(Ray ray, Material* material): This constructor creates a new Line objects using the ray position as the start point and the ray position displaced by the ray direction as the end point. It associates the specified material with the new Line.
char* Line::name(void): This method overrides the abstract Shape::name( ) method and returns the string "line".
void Line::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
BoundingBox Line::getBoundingBox(void): This method overrides the abstract Shape::getBoundingBox( ) method. It returns the bounding box containing the Line.
void Line::draw(int cplx): This method overrides the abstract Shape::draw(int) method.

Light: This class is the abstract class that all objects calling themselves "lights" must impelment.

Point3D Light::color: This is the color of the light.
virtual int Light::read(FILE* fp): This abstract method reads the appropriate light information from a file.
virtual void Light::write(FILE* fp=stdout): This abstract method writes the Light out to a file (default is STDOUT) in the .ray format.
virtual void Light::draw(int lightNum): This method invokes the OpenGL commands that draw the light. (This encludes setting the parameters for the light and enabling the light with the specified index.)

PointLight: This Light subclass describes a light with specified position in space, and specified constant, linear and quadratic attenuation. The attenuation factor specifes the factor by which to scale the light cotribution from the light at the point of intersection. If d is the distance between the light source and the point of intersection then the scale factor is given by: 1.0/(ca+d*la+d*d*qa), where ca is the constant attenuation, la is the linear attenuation, and qa is the quadratic attenuation. (So to have a light source with no attenuation you should have (ca,la,qa)=(1.0,0.0,0.0).)

Point3D PointLight::location: This is the position of the point-light.
Flt PointLight::constAtten: This is the constant attenuation term.
Flt PointLight::linearAtten: This is the linear attenuation term.
Flt PointLight::quadAtten: This is the quadratic attenuation term.
int PointLight::read(FILE* fp): This method overrides the Light::read(FILE*) method and sets the light location and constant/linear/quadratic attenuation terms, as specified in the file.
void PointLight::write(FILE* fp=stdout): This method overrides the abstract Light::write(int,FILE*) method.
void PointLight::draw(int lightNum): This method overrides the abstract Light::draw(int) method .

DirectionalLight: This Light subclass describes a light with no position in space and only a direction. (As such it does not make sense to talk about its attenuation as a function of distance.)

Point3D DirectionalLight::direction: This is the direction of the directional-light.
int DirectionalLight::read(FILE* fp): This method overrides the Light::read(FILE*) method and sets the light direction, as specified in the file.
void DirectionalLight::write(FILE* fp=stdout): This method overrides the abstract Light::write(int,FILE*) method.
void DirectionalLight::draw(int lightNum): This method overrides the abstract Light::draw(int) method .

SpotLight: This Light subclass describes a spot light with specified position and direction, in space, specified constant, linear and quadratic attenuation terms, and with specified cut-off angle and drop-off rate. The attenuation factor specifes the factor by which to scale the light cotribution from the light at the point of intersection. If d is the distance between the light source and the point of intersection then the scale factor is given by: 1.0/(ca+d*la+d*d*qa), where ca is the constant attenuation, la is the linear attenuation, and qa is the quadratic attenuation. (So to have a light source with no attenuation you should have (ca,la,qa)=(1.0,0.0,0.0).)

Point3D SpotLight::location: This is the position of the spot-light.
Point3D SpotLight::direction: This is the direction of the spot-light.
Flt SpotLight::constAtten: This is the constant attenuation term.
Flt SpotLight::linearAtten: This is the linear attenuation term.
Flt SpotLight::quadAtten: This is the quadratic attenuation term.
Flt SpotLight::cutOffAngle: This is the cut-off angle of the spot-light. Which is to say, if the angle between the light direction and the ray from the light to the point of intersection is larger than the cutOffAngle, then this light does not contribute to the lighting equation.
Flt SpotLight::dropOffRate: This is the drop-off rate of the spot light. It takes a value between 0.0 and 1.0. (It specifies how quickly the light attenuates as a function of the angle between the line from the point of intersection to the light position, and the direction of the spot-light.) More specifically, the cosine of the angle between the light direction and the ray from the light to the point of intersection, raised to the power of 128*dropOffRate gives the appropriate scale factor of the light as a function of angle. (This scaling should be considered in addition to the computed attenuation.)
int SpotLight::read(FILE* fp): This method overrides the Light::read(FILE*) method and sets the light position, light direction, attenuation terms, cut-off angle and drop-off rate as specified in the file.
void SpotLight::write(FILE* fp=stdout): This method overrides the abstract Light::write(int,FILE*) method.
void SpotLight::draw(int lightNum): This method overrides the abstract Light::draw(int) method .

Camera: This class describes the camera casting the rays into the scene.

Flt Camera::heightAngle: This is half of the height angle of the view frustrum.
Flt Camera::aspectRatio: This is the ratio of width to height of the view plane.
Point3D Camera::position: This is the position of the camera in world coordinates.
Point3D Camera::direction: This is the direction of site of the Camera.
Point3D Camera::up: This is the up direction of the Camera.
Point3D Camera::right: This is the right direction of the Camera (This can be obtained by taking the cross product of the up direction and the line of site direction -- though not necassarily in that order. The parser automatically sets this value for you, even though it is not specified in the .ray file.)
int Camera::read(FILE* fp): This method reads out the half-height angle, the aspect ratio, position, the line of site direction and the up direction from the file and sets the Camera parameters.
void Camera::write(FILE* fp=stdout): This method writes the Camera out to a file (default is STDOUT) in the .ray format.
void Camera::draw(void): This method invokes the OpenGL code that sets the camera view.

Vertex: This class is used to store vertex information.

int Vertex::index: This specifies the index of the Vertex within the list of vertices specified in the .ray file.
Point3D Vertex::position: This specifies the location of the vertex.
Point3D Vertex::normal: This specifies the normal direction at the vertex.
Point2D Vertex::texCoordinate: This specifies the texture coordinate at the vertex.
int Vertex::read(FILE* fp): This method reads out the position, normal and texture coordinates from the file and sets the Vertex parameters.
void Vertex::write(FILE* fp=stdout): This method writes the Vertex out to a file (default is STDOUT) in the .ray format.

Material: This class is used to describe the material properties of a Shape.

int Material::index: This specifies the index of the Material within the list of Materials specified in the .ray file.
Point3D Material::ambient: This specifies the ambient color of the Shape associated with the Material.
Point3D Material::diffuse: This specifies the diffuse color of the Shape associated with the Material.
Point3D Material::specular: This specifies the specular color of the Shape associated with the Material.
Point3D Material::emmisive: This specifies the emissive color of the Shape associated with the Material.
Flt Material::kspec: This specifies the specular "shininess" of the Shape associated with the Material. This should take a value between 0.0 and 1.0. The cosine of the angle between the ray and the direction to the light, raised to the power of 128*kspec gives the appropriate scaling factor for the specular highlite. This scaling factor is the same used to scale the contribution of the recursively reflected rays.
Flt Material::ktran: This specifies the transparency of the Shape associated with the Material. This should take a value between 0.0 and 1.0.
Flt Material::refind: This specifies the refraction index of the Shape associated with the Material.
Texture* Material::tex: If there is a Texture associated with the Shape, this is a pointer to that texture. If there is no Texture then this value is NULL.
char Material::foo[ ]: This stores a string that the user can use to specify some other material properties not inherently supported by the ray-tracer.
GLuint Material::handle: This stores the OpenGL handle to the bound call-list.
int Material::read(FILE* fp): This method reads out the ambient, diffuse, specular, and emissive colors, the specular "shininess" coefficient, the transparency, the refraction index, the Texture index and the foo-string from the file. (The parser then uses the Texture index to set the Texture pointer, and also sets the index.)
void Material::write(FILE* fp=stdout): This method writes the Material out to a file (default is STDOUT) in the .ray format.
void Material::draw(void): This method invokes the OpenGL code responsible for setting the specified material properties.

Texture: This class is used to store the Image used for texture-mapping a Shape.

int Texture::index: This specifies the index of the Texture within the list of Textures specified in the .ray file
char Texture::filename[ ]: This is the name of the .bmp file from which the Image is to be read.
Image* Texture::img: This is a pointer to the Image read from the .bmp file.
GLuint Texture::handle: This stores the OpenGL handle to the bound texture.
int Texture::read(FILE* fp): This method reads out the .bmp file-name from the file. It then reads the file and generates the Image. (The parser then sets the index of the Texture.)
void Texture::write(FILE* fp=stdout): This method writes the Texture out to a file (default is STDOUT) in the .ray format.
void Texture::draw(void): This method invokes the OpenGL code responsible for setting up the texture. (If this is the first time the method is called, the texture gets bound to the handle and then gets set as the current texture. On subsequent calls, it only gets set as the current texture.)

RayFile: This class is used to store the scene-graph information of other .ray files that are included in the .ray file being parsed.

int RayFile::index: This specifies the index of RayFile within the list of RayFiles specified in the .ray file.
char RayFile::filename[ ]: This is the name of the .ray file from which the scene-graph information is to be read.
Scene* RayFile::scene: This a pointer to the scene-graph read from the .ray file.
int RayFile::read(FILE* fp): This method reads out the .ray file-name from the file. It then reads the file and generates the corresponding scene-graph. (The parser then sets the index of the RayFile.)
void RayFile::write(FILE* fp=stdout): This method writes the RayFile out to a file (default is STDOUT) in the .ray format.
void RayFile::free(void): This method frees up any resources associated with the scene-graph read from the file.

Scene: This class stores all of the information read from the .ray file including the Camera, background and ambient color, the list of Lights in the scene, and a pointer to the root node of the scene-graph.

Point3D Scene::ambient: This is the ambient color of the environment.
Point3D Scene::background: This is the background color of the environment.
Camera Scene::camera: This is the Camera that is used to ray-trace the scene.
Light** Scene::lights: This is the list of lights illuminating the scene.
int Scene::lightNum: This is the number of lights illuminating the scene.
Shape* Scene::shape: This is a pointer to the root node of the scene-graph.
Scene::Scene(void): This constructor creates a new Scene and sets all positions to (0.0,0.0,0.0) and all pointers to NULL.
void Scene::read(const char* filename): Given a name of a .ray file, this method reads out all of the Scene information. (This method assumes that there is an unspecified Group with the identity matrix as its local transform that is the root of the scene-graph.)
void Scene::write(FILE* fp=stdout): This method writes the Scene out to a file (default is STDOUT) in the .ray format. Note that since there is an assumed Group you can write more shapes to the file. In particular, for debugging purposes, you can transform your Rays into lines and add those to the file. Then, using the ray-viewer, you can check if you are sending off your rays in the right direction.
void Scene::draw(int cplx): This method draws the scene by drawing the enabling lighting, invoking the draw methods of the Lights, Shapes, Materials, and Textures.

Point2D: This class defines a 2D vector and is used primarily for storing and manipulating texture coordinates.

Point2D::Point2D(void): This contsructor creates a new Point2D with coordinates (0.0,0.0).
Point2D::Point2D(Flt x, Flt y): This constructor creates a new Point2D with coordinates (x,y).
Flt& Point2D::operator[ ] (int index): This method allows one to access the Point2D in the same way one would access an array. (If p is of type Point2D then the commandp[i] returns a reference, not a copy, of the i-th coordinate of p.
void Point2D::print(void): This method prints out the Point2D to the screen.
void Point2D::printnl(void): This method prints out the Point2D to the screen followed by a new-line character.
Flt Point2D::dot(Point2D pt): This method returns the dot product of the Point2D object with pt. (If p is a Point2D then "p.dot(pt)" is the same as "p[0]*pt[0]+p[1]*pt[1]".)
Flt Point2D::length(void): This method returns the euclidean length of the Point2D object.
Point2D Point2D::unit(void): This method returns a unit-length scaled version of the Point2D object. (Note: an assert is used to make sure that the length of the Point2D is not 0.0.)
Point2D Point2D::negate(void): This method returns a copy of the Point2D object, scaled by -1.0. (If p is a Point2D then "p.negate( )" is the same as Point2D(-p[0],-p[1])".)
Point2D Point2D::operator- (void): This method returns a copy of the Point2D object, scaled by -1.0. (If p is a Point2D then "-p" is the same as Point2D(-p[0],-p[1])".)
Point2D Point2D::scale(Flt scl): This method returns a copy of the Point2D object, scaled by scl. (If p is a Point2D then "p.scale(s)" is the same as Point2D(p[0]*s,p[1]*s)".)
Point2D Point2D::operator* (Flt scale): This method returns a copy of the Point2D object, scaled by scale. (If p is a Point2D then "p*s" is the same as Point2D(p[0]*s,p[1]*s)".)
Point2D Point2D::operator/ (Flt scale): This method returns a copy of the Point2D object, scaled by 1/scale. (If p is a Point2D then "p/s" is the same as Point2D(p[0]/s,p[1]/s)".)
Point2D Point2D::add(Point2D pt): This method returns the sum of the Point2D object with pt. (If p is a Point2D then "p.add(pt)" is the same as Point2D(p[0]+pt[0],p[1]+pt[1])".)
Point2D Point2D::operator+ (Point2D pt): This method returns the sum of the Point2D object with pt. (If p is a Point2D then "p+pt" is the same as Point2D(p[0]+pt[0],p[1]+pt[1])".)
Point2D Point2D::subtract(Point2D pt): This method returns the difference of the Point2D object with pt. (If p is a Point2D then "p.subtract(pt)" is the same as Point2D(p[0]-pt[0],p[1]-pt[1])".)
Point2D Point2D::operator- (Point2D pt): This method returns the difference of the Point2D object with pt. (If p is a Point2D then "p-pt" is the same as Point2D(p[0]-pt[0],p[1]-pt[1])".)
Point2D Point2D::mult(Point2D pt): This method returns the component wise product the Point2D object with pt. (If p is a Point2D then "p.mult(pt)" is the same as Point2D(p[0]*pt[0],p[1]*pt[1])".)

Point3D: This class defines a 3D vector and is used for describing the positions of points, colors, directions and normals.

Point3D::Point3D(void): This contsructor creates a new Point3D with coordinates (0.0,0.0,0.0).
Point3D::Point3D(Flt x, Flt y, Flt z): This constructor creates a new Point3D with coordinates (x,y,z).
Flt& Point3D::operator[ ] (int index): This method allows one to access the Point3Din the same way one would access an array. (If p is of type Point3D then the command p[i] returns a reference, not a copy, of the i-th coordinate of p.
void Point3D::print(void): This method prints out the Point3D to the screen.
void Point3D::printnl(void): This method prints out the Point3D to the screen followed by a new-line character.
Flt Point3D::dot(Point3D pt): This method returns the dot product of the Point3D object with pt. (If p is a Point3D then "p.dot(pt)" is the same as "p[0]*pt[0]+p[1]*pt[1]+p[2]*pt[2]".)
Flt Point3D::length(void): This method returns the euclidean length of the Point3D object.
Point3D Point3D::unit(void): This method returns a unit-length scaled version of the Point3D object. (Note: an assert is used to make sure that the length of the Point3D is not 0.0.)
Point3D Point3D::negate(void): This method returns a copy of the Point3D object, scaled by -1.0. (If p is a Point3D then "p.negate( )" is the same as Point2D(-p[0],-p[1],-p[2])".)
Point3D Point3D::operator- (void): This method returns a copy of the Point3D object, scaled by -1.0. (If p is a Point3D then "-p" is the same as Point2D(-p[0],-p[1],-p[2])".)
Point3D Point3D::scale(Flt scl): This method returns a copy of the Point3D object, scaled by scl. (If p is a Point3D then "p.scale(s)" is the same as Point2D(p[0]*s,p[1]*s,p[2]*s)".)
Point3D Point3D::operator* (Flt scale): This method returns a copy of the Point3D object, scaled by scale. (If p is a Point3D then "p*s" is the same as Point2D(p[0]*s,p[1]*s,p[2]*s)".)
Point3D Point3D::operator/ (Flt scale): This method returns a copy of the Point3D object, scaled by 1/scale. (If p is a Point3D then "p/s" is the same as Point2D(p[0]/s,p[1]/s,p[2]/s)".)
Point3D Point3D::add(Point3Dpt): This method returns the sum of the Point3D object with pt. (If p is a Point3D then "p.add(pt)" is the same as Point2D(p[0]+pt[0],p[1]+pt[1],p[1]+pt[2],)".)
Point3D Point3D::operator+ (Point3D pt): This method returns the sum of the Point3D object with pt. (If p is a Point3D then "p+pt" is the same as Point2D(p[0]+pt[0],p[1]+pt[1],p[1]+pt[2],)".)
Point3D Point3D::subtract(Point3D pt): This method returns the difference of the Point3D object with pt. (If p is a Point3D then "p.subtract(pt)" is the same as Point2D(p[0]-pt[0],p[1]-pt[1],p[2]-pt[2],)".)
Point3D Point3D::operator- (Point3D pt): This method returns the difference of the Point3D object with pt. (If p is a Point3D then "p-pt" is the same as Point2D(p[0]-pt[0],p[1]-pt[1],p[2]-pt[2],)".)
Point3D Point3D::crossProduct(Point3D pt): This method returns the cross-product of the Point3D object with pt.
Point3D Point3D::mult(Point3D pt): This method returns the component wise product of the Point3D object with pt. (If p is a Point3D then "p.mult(pt)" is the same as Point2D(p[0]*pt[0],p[1]*pt[1],p[2]*pt[2],)".)

Ray: This is the class describing a directed Ray. A Ray is specified by its starting position and its direction, notits endpoint.

Point3D Ray::p: This is is the starting position of the Ray.
Point3D Ray::d: This is the direction of the Ray.
Ray::Ray(void): This constructor creates a new Ray with position and direction (0.0,0.0,0.0).
Ray::Ray(Point3D p,Point3D d): This constructor creates a new Ray with position p and direction d.
void Ray::print(void): This method prints out the Ray to the screen.
void Ray::printnl(void): This method prints out the Ray to the screen followed by a new-line character.
Ray Ray::translate(Point3D pt): This method returns a copy of the Ray object translated by pt. (If r is a Ray then "r.translate(pt)" is the same thing as "Ray(r.p+pt,r.d)".)
Point3D Ray::operator( ) (Flt param): This method returns the parametrized position of the ray. (If r is a Ray then "r(s)" is the same thing as "r.p+r.d*s".)
Point3D Ray::position(Flt param): This method returns the parametrized position of the ray. (If r is a Ray then "r.position(s)" is the same thing as "r.p+r.d*s".)

Matrix: This is the class describing affine transformations. The Matrix is a 4x4 matrix and is indexed in the column-row notation (first index specifying column, second index specifying row).

Flt& Matrix::operator( ) (int col,int row): This method returns a reference to the value in column col and row row. (If m is of type Matrix then "m(i,j)=1.0" sets the value at column i and row j to 1.0.)
Flt Matrix::det(void): This method returns the determinant of the Matrix.
void Matrix::print(void): This method prints out the Matrix to the screen.
void Matrix::printnl(void): This method prints out the Matrix to the screen followed by a new-line character.
Matrix Matrix::mult(Matrix m): This method returns the matrix product of the Matrix with m. (Multiplication by m is done on the right.)
Matrix Matrix::operator* (Matrix m): This method returns the matrix product of the Matrix with m. (Multiplication by m is done on the right.)
Matrix Matrix::transpose(void): This method returns the transpose of the Matrix.
Matrix Matrix::invert(void): This method returns the inverse of the Matrix.
Point3D Matrix::multPosition(Point3D position): This method applies the Matrix transformation to position treating it as a point in space. (This means that the translation part of the transformation is also applied.)
Point3D Matrix::multDirection(Point3D direction): This method applies the Matrix transformation to direction treating as a direction in space. (This means that the translation part of the transformation is not applied.)
Point3D Matrix::multNormal(Point3D normal): This method applies the Matrix transformation to direction treating it as a normal vector. (This means that if P is the plane normal to normal then the returned Point3D is the unit-length vector normal to the image of P under the Matrix transformation.)
Ray Matrix::mult(Ray ray): This method applies that Matrix transformation to a Ray.
Ray Matrix::operator* (Ray ray): This method applies that Matrix transformation to a Ray.

BoundingBox: This is the class describing the bounding box for a Shape. The bounding box is axis aligned and is specified by two antipodal vertices.

Point3D BoundingBox::p[2]: These are the two antipodal points describing the bounding box.
BoundingBox::BoundingBox(void): This constructor generates a bounding box whose antipodal points are both (0.0,0.0,0.0).
BoundingBox::BoundingBox(Point3D p1, Point3D p2): This constructor generates a bounding box containing the two specified points. It sets p[0] to be the point with the (x,y,z) coordinates equal to the minimum of the respecive (x,y,z) values of p1 and p2 and p[1] to be the point with (x,y,z) coordinates equal to the maximum of the respective (x,y,z) values of p1 and p2.
BoundingBox::BoundingBox(Point3D* pList, int listSize): This method generates the smallest bounding box that contains all of the points in the list.
BoundingBox BoundingBox::operator+ (BoundingBox b): This method provides a way for obtaining the bounding box containing the union of two bounding boxes.
BoundingBox BoundingBox::transform(Matrix m): This method transforms the bounding box using the transform m and returns the bounding box containing the transformed bounding box. (Note: Since bounding boxes are axis aligned applying a transform will not, in general return an axis aligned bounding box. An extra step has to be taken to compute the bounding box of the transformed bounding box. Also, it is not enough to compute the bounding box for the transform of the two vertices defining the initial bounding box since the transform need not preserve angles.)
Flt BoundingBox::intersects(Ray ray): This method returns the distance from the Ray to the bounding box. If the ray starts within the box it returns 0.0. If the ray does not intersect the box it returns -1.0.

Pixel: This is a struct that holds the red, green, and blue values of a point in an Image.

unsigned char Pixel::r: This is the red component of the pixel and can take values in the range 0-255.
unsigned char Pixel::g: This is the green component of the pixel and can take values in the range 0-255.
unsigned char Pixel::b: This is the blue component of the pixel and can take values in the range 0-255.

Image: This is a struct that stores an array of Pixels and the size of the Image.

int Image::width: This is the width of the image.
int Image::height: This is the height of the image.
Pixel* Image::pixels: This is the array of Pixels that make up the Image. (If img is of type Image then the pixel at position (x,y) can be accessed by "img->pixels[y*img->width+x]"

Return to top.