Code Overview

Code Overview for Assignment 4 (Animation)

This web page describes the code that is used for assignment 4. 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 File Viewer:

rayView.[cpp/h] The code responsible for displaying the .ray file contents.

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 node
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

Light Classes:

light.h The abstract base class that all l ights 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 animator
key.[cpp/h] Code for the key frame sample Classes, and the .key file parser.
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.)
pMatrix.[cpp/h] Code for the classes representing a number of parametrizable matrices.
image.[cpp/h] Code for the Image class.
bmp.[cpp/h] Code responsible for reading and writing BMP files

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
group.[cpp/h]	class	StaticGroup	Group
group.[cpp/h]	class	ParametrizedGroup	Group
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
light.h	class	Light
pointLight.[cpp/h]	class	PointLight	Light
directionalLight.[cpp/h]	class	DirectionalLight	Light
spotLight.[cpp/h]	class	SpotLight	Light
key.[cpp/h]	class	Key
key.[cpp/h]	class	KeyFile
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
pMatrix.[cpp/h]	class	Parameter
pMatrix.[cpp/h]	class	ParametrizedMatrix
image.[cpp/h]	struct	Pixel
image.[cpp/h]	class	Image

Return to top.

FUNCTION LIST:

File Name	Function Name
rayView.[cpp/h]	void RayView(const char* fileName, int width, int height, int complexity)
main.cpp	int main(int argc, char** argv)
geometry.[cpp/h]	Matrix IdentityMatrix(void)
bmp.[cpp/h]	Image* BMPReadImage(FILE* fp)
bmp.[cpp/h]	void BMPWriteImage(Image* img, FILE* fp)

Return to top.

CLASS AND STRUCT DESCRIPTION:

Shape: This abstract class is used to describe all shapes that are ray-tracable.
ShapeListElement: This class is used to store a linked list of shapes
Group: This abstract subclass of Shape represents a single node of the scene-graph with a specified transformation
StaticGroup: This subclass of Group represents a single node of the scene-graph with a static 4x4 transformation.
ParametrizedGroup: This subclass of Group represents a single node of the scene-graph with a parametrized 4x4 transformation.
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
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
Key: This class serves as a container for the sample values of one degree of freedom
KeyFile: This class stores the keyframe information read out from the specified .key file
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
Parameter: This class represents a variable.
ParametrizedMatrix: This class represents a matrix value is a function of a single input variable.
Pixel: This stores the red, green, and blue components of a pixel
Image: This class represents the two dimensional array of pixels making up 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	void Shape::draw(int complexity)
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::~ShapeListElement(void)
group.[cpp/h]	void ShapeListElement::addShape(Shape* shape)
Group
group.[cpp/h]	ShapeListElement* Group::shapeList
group.[cpp/h]	Group::Group(void)
group.[cpp/h]	Group::~Group(void)
group.[cpp/h]	void Group::addShape(Shape* shape)
group.[cpp/h]	int Group::shapeNum(void)
group.[cpp/h]	void Group::draw(int complexity)
group.[cpp/h]	void Group::write(int indent, FILE* fp=stdout)
group.[cpp/h]	virtual void Group::writeBegin(int indent, FILE* fp=stdout)
group.[cpp/h]	virtual void Group::writeEnd(int indent, FILE* fp=stdout)
group.[cpp/h]	virtual Matrix Group::getMatrix(void)
StaticGroup
group.[cpp/h]	Matrix StaticGroup::localTransform
group.[cpp/h]	StaticGroup::StaticGroup(FILE* fp)
group.[cpp/h]	StaticGroup::StaticGroup(Matrix localTransform)
group.[cpp/h]	char* StaticGroup::name(void)
group.[cpp/h]	Matrix StaticGroup::getMatrix(void)
group.[cpp/h]	void StaticGroup::writeBegin(int indent, FILE* fp=stdout)
group.[cpp/h]	void StaticGroup::writeEnd(int indent, FILE* fp=stdout)
ParametrizedGroup
group.[cpp/h]	Parameter* ParametrizedGroup::parameter
group.[cpp/h]	ParametrizedMatrix ParametrizedGroup::localTransform
group.[cpp/h]	ParametrizedGroup::ParametrizedGroup(FILE* fp)
group.[cpp/h]	char* ParametrizedGroup::name(void)
group.[cpp/h]	Matrix ParametrizedGroup::getMatrix(void)
group.[cpp/h]	void ParametrizedGroup::writeBegin(int indent, FILE* fp=stdout)
group.[cpp/h]	void ParametrizedGroup::writeEnd(int indent, FILE* fp=stdout)
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]	void RayFileInstance::draw(int complexity)
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]	void Triangle::draw(int complexity)
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]	void Sphere::draw(int complexity)
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]	void Cone::draw(int complexity)
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]	void Cylinder::draw(int complexity)
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]	void Box::draw(int complexity)
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)
Key
key.[cpp/h]	Parameter* Key::parameter
key.[cpp/h]	Key::Key(void)
key.[cpp/h]	Key::~Key(void)
key.[cpp/h]	void Key::setParameterName(char* name)
key.[cpp/h]	void Key::setSize(int size)
key.[cpp/h]	int Key::samples(void)
key.[cpp/h]	char* Key::name(void)
key.[cpp/h]	float& Key::operator[ ] (int index)
key.[cpp/h]	float& Key::index(int index)
KeyFile
key.[cpp/h]	Key* KeyFile::keyList
key.[cpp/h]	char KeyFile::fileName[ ]
key.[cpp/h]	KeyFile::KeyFile(char* fileName)
key.[cpp/h]	KeyFile::~KeyFile(void)
key.[cpp/h]	void KeyFile::write(char* fileName)
key.[cpp/h]	void KeyFile::write(FILE* fp=stdout)
key.[cpp/h]	void KeyFile::read(char* fileName)
key.[cpp/h]	void KeyFile::read(FILE* fp)
key.[cpp/h]	int KeyFile::keyNum(void)
key.[cpp/h]	int KeyFile::frameNum(void)
key.[cpp/h]	float KeyFile::duration(void)
key.[cpp/h]	int KeyFile::indexOf(char* name)
key.[cpp/h]	void KeyFile::setParameterValues(float time)
key.[cpp/h]	void KeyFile::linkParameters(Parameter** parameterList, int pCount)
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)
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]	Material::Material(void)
scene.[cpp/h]	Material::Material(int index, Point3D ambient, Point3D color, Flt kspec)
scene.[cpp/h]	void Material::setHandle(void)
scene.[cpp/h]	int Material::read(FILE* fp)
scene.[cpp/h]	void Material::write(FILE* fp=stdout)
Texture
scene.[cpp/h]	int Texture::index
scene.[cpp/h]	char Texture::filename[ ]
scene.[cpp/h]	GLuint Texture::handle
scene.[cpp/h]	Image* Texture::img
scene.[cpp/h]	Texture::Texture(void)
scene.[cpp/h]	Texture::~Texture(void)
scene.[cpp/h]	void Texture::setHandle(void)
scene.[cpp/h]	int Texture::read(FILE* fp)
scene.[cpp/h]	void Texture::write(FILE* fp=stdout)
RayFile
scene.[cpp/h]	int RayFile::index
scene.[cpp/h]	char RayFile::filename[ ]
scene.[cpp/h]	Scene* RayFile::scene
scene.[cpp/h]	RayFile::~RayFile(void)
scene.[cpp/h]	int RayFile::read(FILE* fp)
scene.[cpp/h]	void RayFile::write(FILE* fp=stdout)
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]	StaticGroup* Scene::group
scene.[cpp/h]	KeyFile* Scene::keyFiles
scene.[cpp/h]	int Scene::keyFileNum
scene.[cpp/h]	Scene::Scene(void)
scene.[cpp/h]	Scene::~Scene(void)
scene.[cpp/h]	Material* Scene::getMaterial(int index)
scene.[cpp/h]	void Scene::setHandles(void)
scene.[cpp/h]	void Scene::setParameters(float time)
scene.[cpp/h]	void Scene::read(const char* filename)
scene.[cpp/h]	void Scene::write(FILE* fp=stdout)
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)
Parameter
pMatrix.[cpp/h]	float Parameter::value
pMatrix.[cpp/h]	char Parameter::name[ ]
pMatrix.[cpp/h]	Parameter::Parameter(void)
ParametrizedMatrix
pMatrix.[cpp/h]	void ParametrizedMatrix::setType(int type)
pMatrix.[cpp/h]	int ParametrizedMatrix::getType(void)
pMatrix.[cpp/h]	Matrix ParametrizedMatrix::getMatrix(float t)
Pixel
image.[cpp/h]	unsigned char Pixel::r
image.[cpp/h]	unsigned char Pixel::g
image.[cpp/h]	unsigned char Pixel::b
image.[cpp/h]	unsigned char Pixel::a
Image
image.[cpp/h]	Pixel* Image::pixelList
image.[cpp/h]	Image::Image(void)
image.[cpp/h]	Image::~Image(void)
image.[cpp/h]	int Image::width(void)
image.[cpp/h]	int Image::height(void)
image.[cpp/h]	Pixel& Image::operator( ) (int x, int y)
image.[cpp/h]	Pixel& Image::pixel(int x, int y)

Return to top.

FUNCTION DESCRIPTION:

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

width

height

complexity

int main(int argc, char** argv)

rayView

Matrix IdentityMatrix(void)

Matrix

Image* BMPReadImage(FILE* fp)

This function reads in a .bmp image from the specified file.

void BMPWriteImage(Image* img, FILE* fp)

This function writes a .bmp image out to the specified file.

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 Flt Shape::draw(int complexity): This virtual method is reponsible for invoking the appropriate OpenGL commands to draw 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
ShapeListElement::~ShapeListElement(void): This destructor destroys the associated shape and then deletes the next ShapeListElement
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 virtual subclass of Shape consists of a local transformation and a list of Shapes to which the transformation is applied. This class can be thought of as a single node in the scene-graph.

ShapeListElement* Group::shapeList: This is the list of Shapes associated to the group.
Group::Group(void): This constructor sets shapeList to NULL and initializes the count of child Shapes to 0.
Group::~Group(void): This destructor deletes shapList.
void Group::addShape(Shape* shape): This method adds a Shape to the list of Shapes.
int Group::shapeNum(void): This method returns the number of child shapes.
void Group::draw(int complexity): This method overrides the abstract Shape::draw(int) method
void Group::write(int indent, FILE* fp=stdout): This method overrides the abstract Shape::write(int,FILE*) method.
virtual void Group::writeBegin(int indent, FILE* fp=stdout): This abstract method must be implemented by all Group subclasses. It specifies how to write out the beginning of a group.
virtual void Group::writeEnd(int indent, FILE* fp=stdout): This abstract method must be implemented by all Group subclasses. It specifies how to write out the end of a group.
virtual Matrix Group::getMatrix(void): This abstract method must be implemented by all Group subclasses. It returns the transformation matrix associated with the Group.

StaticGroup: This subclass of Group represents scene graph nodes whose associated transformations are constant.

Matrix StaticGroup::localTransform: This is the static matrix associated with the scene graph node
StaticGroup::StaticGroup(FILE* fp): This constructor generates a new StaticGroup object by reading the matrix from the file.
StaticGroup::StaticGroup(Matrix localTransform): This constructor generates a new StaticGroup object using the specified matrix.
char* StaticGroup::name(void): This method overrides the abstract Shape::name( ) method and returns the string "static group".
Matrix StaticGroup::getMatrix(void): This method overrides the abstract Group::getMatrix( ) method by returning the matrix associated with the node.
void StaticGroup::writeBegin(int indent, FILE* fp=stdout): This method overrides the abstract Group::writeBegin(int,FILE*) method by writing "group_begin" and the matrix to the file (at the specified offset);
void StaticGroup::writeEnd(int indent, FILE* fp=stdout): This method overrides the abstract Group::writeBegin(int,FILE*) method by writing "group_end" to the file (at the specified offset);

ParametrizedGroup: This subclass of Group represents scene graph nodes whose associated transformations are parametrized by some variable.

Parameter* ParametrizedGroup::parameter: This is a pointer to the variable that parametrizes the transformation.
ParametrizedMatrix ParametrizedGroup::localTransform: This is the parametrized matrix associated with the scene graph node
ParametrizedGroup::ParametrizedGroup(FILE* fp): This constructor generates a new ParametrizedGroup object by reading the matrix type and the variable name from the file.
char* ParametrizedGroup::name(void): This method overrides the abstract Shape::name( ) method and returns the string "parametrized group".
Matrix ParametrizedGroup::getMatrix(void): This method overrides the abstract Group::getMatrix( ) method by returning the matrix parametrized by the current value of parameter.
void ParametrizedGroup::writeBegin(int indent, FILE* fp=stdout): This method overrides the abstract Group::writeBegin(int,FILE*) method by writing "joint_begin", the matrix type, and the parameter name to the file (at the specified offset);
void ParametrizedGroup::writeEnd(int indent, FILE* fp=stdout): This method overrides the abstract Group::writeBegin(int,FILE*) method by writing "joint_end" to the file (at the specified offset);

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.
void RayFileInstance::draw(int complexity): This method overrides the abstract Shape::draw(int) method. It does so by calling the draw 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 is a pointer to the Material associated with the Triangle object.
Triangle::Triangle(Vertex* v1, Vertex* v2, Vertex* v3, Material*

Triangle

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.
void Triangle::draw(int complexity): 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 is a pointer to the Material associated with the Sphere object.
Sphere::Sphere(Point3D center, Flt radius, Material* material): This constructor creates a new Sphere object with the specified center, height 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.
void Sphere::draw(int complexity): 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 is a pointer to the Material associated with the Cone object.
Cone::Cone(Point3D center, Flt height, Flt radius, Material*

Cone

Cone::Cone(FILE* fp, int* materialIndex): This constructor creates a new Coneobject 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.
void Cone::draw(int complexity): 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 is a pointer to the Material associated with the Cylinder object.
Cylinder::Cylinder(Point3D center, Flt height, Flt radius, Material*

Cylinder

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.
void Cylinder::draw(int complexity): 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 is a pointer to the Material associated with the Box object.
Box::Box(Point3D center, Point3D length, Material* material): This constructor creates a new Box object with the 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.
void Box::draw(int complexity): 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 abstract method is responsible for invoking the OpenGL commands that draw the light. The lightNum parameter specifies which number light is being drawn.

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 .

Key: This class is used to store the sample points that are associated with the values of a specific Parameter.

Parameter* Key::parameter: This is a pointer to the parameter to which the values are associated.
Key::Key(void): This constructor sets parameter to NULL.
Key::~Key(void): This destructor frees up the memory that was previously allocated to store the sample values.
void Key::setParameterName(char* name): This method provides a way to associate the parameter name to the key values.
void Key::setSize(int size): This method provides a way to the set the number of samples
int Key::samples(void): This method returns the number of samples.
char* Key::name(void): This method returns the name of the parameter associated with the key values.
float& Key::operator[ ] (int index): This method provides a way to access the sample values "array-style", by returning a reference to the sample value indexed.
float& Key::index(int index): This method returns a reference to the sample value indexed.

KeyFile: This class stores the information read out from a .key file.

Key* KeyFile::keyList: This is a list of Key objects, each of which corresponds to the samples for a single parameter name.
char KeyFile::fileName[ ]: This is the name of the .key file from which the information was read.
KeyFile::KeyFile(char* fileName): This constructor generates a new KeyFile object by parsing the reading the specified .key file.
KeyFile::~KeyFile(void): This destructor deletes the memory allocated to store the list of Keys.
void KeyFile::write(char* fileName): This method writes out the Key information to the specified file.
void KeyFile::write(FILE* fp=stdout): This method writes out the Key information to the specified file.
void KeyFile::read(char* fileName): This method reads out the Key information from the specified file.
void KeyFile::read(FILE* fp): This method reads out the Key information from the specified file.
int KeyFile::keyNum(void): This method returns the number of Keys read associated with the KeyFile object.
int KeyFile::frameNum(void): This method returns the number of frames over which the Keys are sampled (i.e. the number of points sampled per variable).
float KeyFile::duration(void): This method returns the time over which the values were sampled.
int KeyFile::indexOf(char* name): This method returns the index of the Key with the specified parameter name, within the list of Keys.
void KeyFile::setParameterValues(float time): This method updates each parameter associated to a Key in the Key list, based on the input time.
void KeyFile::linkParameters(Parameter** parameterList, int

parameter

Key

parameter

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.

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 is a handle to the OpenGL call-list associated with the material.
Material::Material(void): This constructor creates a default black material.
Material::Material(int index, Point3D ambient, Point3D color, i

Material

void Material::setHandle(void): This method generates the OpenGL handle for the call-list associated with this material.
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.

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.
GLuint Texture::handle: This is the OpenGL texture handle associated with the Texture object.
Image* Texture::img: This is a pointer to the Image read from the .bmp file.
Texture::Texture(void): This constructor creates a new Texture object with img pointing to NULL and handle equal to 0.
Texture::~Texture(void): This destructor frees up the memory allocated to store the .bmp image.
void Texture::setHandle(void): This method creates the OpenGL texture handle for the image associated with this object.
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.

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.
RayFile::~RayFile(void): This destructor deletes the memory allocated for the associated Scene.
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.

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.
StaticGroup* Scene::group: This is a pointer to the root node of the scene-graph.
KeyFile* Scene::keyFiles: This is a pointer to the associated KeyFile object.
int Scene::keyFileNum: This is the number of KeyFiles included in the Scene.
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.
Scene::~Scene(void): This destructor frees up all the memory allocated to store the Scene information.
Material* Scene::getMaterial(int index): Since the Materials are private, this method provides a way of getting a pointer to a Material given its index. (This is particularly useful if you want to write out Line objects corresponding to cast rays out to a file since the do not have any Material associated with them.)
void Scene::setHandles(void): This method invokes the Texture::setHandle( ) method and the Material::setHandle( ) method, and then the invokes the setHandles( ) method of all Scenes pointed to by all the RayFiles stored in the current Scene object.
void Scene::setParameters(float time): This method is responsible for modifying the parameters linked with the Scene based on the input time.
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.

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 Point3D in 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.

Parameter: This is the class describing a variable value.

float Parameter::value: This is the current value associated with the variable.
char Parameter::name[ ]: This is the name of the variable.
Parameter::Parameter(void): This constructor sets the intial value to 0.

ParametrizedMatrix: This class is used to represent nine basic parametrized matrices, these include: rotation about the three axes, translation along any of the three axes, and scaling along any of the three axes.

void ParametrizedMatrix::setType(int type): This method sets the type of parametrized matrix. The possible values are: XTRANSLATE, YTRANSLATE, ZTRANSLATE, XROTATE, YROTATE, ZROTATE, XSCALE, YSCALE, and ZSCALE.
int ParametrizedMatrix::getType(void): This method returns the type of parametrized matrix that this object is.
Matrix ParametrizedMatrix::getMatrix(float t): Given a parameter value, this method returns the matrix parametrized by the value.

Pixel: This is a struct that holds the red, green, blue and alpha 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.
unsigned char Pixel::a: This is the alpha component of the pixel and can take values in the range 0-255.

Image: This class stores the Pixel values of an image.

Pixel* Image::pixelList: This is the array of pixel values.
Image::Image(void): This constructor initializes a new Image object.
Image::~Image(void): This destructor frees up the memory used to store the pixel information.
int Image::width(void): This method returns the width of the image.
int Image::height(void): This method returns the height of the image.
Pixel& Image::operator( ) (int x, int y): This method returns a reference to the pixel specified.

Pixel&

Image

pixel

int

top