Revision as of 15:31, 7 October 2014

Project 1: Moving a Cube

Your project should build on the provided starter code. Before you start with this project, you will need to look through the starter code and get familiar with it.

This project has three parts, but only the first two are mandatory to get full credit (100 points). The number of points you can get for each part is indicated below. In the first part you will need to create C++ classes for vectors and matrices. You will use these classes in the remaining projects throughout the quarter. In the second part of this project you will enable the user to interactively manipulate the cube from the starter code with keyboard keys.

The third part is optional: you are going to have to make the cube bounce.

This project is due on Friday, October 17th. You will need to present your project in the CSE basement labs starting at 12:30pm that day, or during one of the TA/tutors' office hours before the due date. For this project you are allowed to work in teams of two.

TA Dylan is going to introduce this homework assignment in Peterson Hall 103 on Monday, October 6th at 2pm.

1. Vector and Matrix Classes (50 points)

Start with the spinning cube from the starter code. Part of the project is a class named Matrix4. Use it as a model and implement matrix and vector classes with frequently used functionality. Create separate classes for a Vector3 and a Vector4, vectors with three or four components, respectively. The Vector4 type includes the homogeneous coordinate (w component), which helps distinguish points from vectors. There only needs to be a matrix class for 4x4 matrices.

1a. Vector3 Class (20 Points)

Your Vector3 class must support at least the following functions. You will get 2 points for each function.

• Vector3::Vector3(double x, double y, double z): constructor with three parameters for the vector coordinates
• Vector3 operator+(const Vector3&): overload operator '+' for addition
• Vector3 operator-(const Vector3&): overload operator '-' for subtraction
• void negate(): negation
• void scale(double s): scale (multiplication with scalar value)
• double dot(const Vector3&, const Vector3&): dot product, returns result
• Vector3 cross(const Vector3&, const Vector3&): cross product, returns result and puts it in calling vector
• double length(): length of the vector
• void normalize(): normalize the vector (make it so that its length is equal to one)
• void print(string comment): print x,y and z components of the vector after a comment string

1b. Vector4 Class (10 Points)

Your Vector4 class must support at least the following functions. You will get 2 points for each function.

• Vector4::Vector4(double x, double y, double z, double w): constructor with four parameters for the vector coordinates
• Vector4 operator+(const Vector4&): overload operator '+' for addition
• Vector4 operator-(const Vector4&): overload operator '-' for subtraction
• void dehomogenize(): dehomogenize the vector (scale it so that its fourth component is equal to one)
• void print(string comment): print x,y, z and w components of the vector after a comment string

1c. Matrix4 Class (24 Points)

Your Matrix4 class must support at least the following functions. You will get 2 points for each function.

• Matrix4::Matrix4(): constructor, initializing each matrix element with zero
• Matrix4 Matrix4::operator*(const Matrix4& m2): multiply matrix with matrix
• Vector4 Matrix4::operator*(const Vector4& v): multiply matrix with vector
• void Matrix4::identity(): make identity matrix
• void Matrix4::transpose(): transpose the matrix
• void Matrix4::makeRotateX(double angle): make rotation matrix about X axis with angle in degrees (note that the sin/cos functions in C++ expect radians so you need to convert to radians within the function)
• void Matrix4::makeRotateY(double angle): make rotation matrix about Y axis with angle in degrees
• void Matrix4::makeRotateZ(double angle): make rotation matrix about Z axis with angle in degrees
• void Matrix4::makeRotate(double angle, const Vector3& axis): Make a rotation matrix about an arbitrary axis
• void Matrix4::makeScale(double sx, double sy, double sz): make a non-uniform scaling matrix
• void Matrix4::makeTranslate(double tx, double ty, double tz): make a translation matrix
• void Matrix4::print(string comment): print the matrix (display all 16 matrix components numerically on the screen in a 4x4 array)

2. Controlling the Cube (46 points)

Using your vector math classes from part 1, control the cube in various ways with keyboard commands. During this entire time, the cube should keep spinning. The commands should be cumulative, meaning that they build on one another. Never reset the position of the cube or its size, except with the reset command.

Add support for the following keyboard commands to control the cube. You can parse key presses with the glutKeyboardFunc command, for which you can find a tutorial here.

Note that some of the below keyboard commands distinguish between upper and lower case.

• 't: toggle the direction of the spin between clockwise and counterclockwise. (5 points)
• 'x'/'X': move cube left/right by a small amount. (5 points)
• 'y'/'Y': move cube down/up by a small amount. (5 points)
• 'z'/'Z': move cube into/out of the screen by a small amount. (5 points)
• 'r': reset cube position, orientation, size and color. (5 points)
• With every key press, display the new cube position with your Vector3 print method in the text window. (5 points)
• 'o'/'O': orbit cube about the OpenGL window's z axis by a small number of degrees (e.g., 10) per key press, counterclockwise ('o') or clockwise ('O'). The z axis crosses the screen in the center of the OpenGL window. This rotation should not affect the spin other than that it will rotate the spin axis with the cube. (10 points)
• 's'/'S': scale cube down/up (about its center, not the center of the screen). To scale up means to make it bigger (6 points)

3. TBD