CMPS 160 -- Fall 2009

CMPS 160 -- Programming Assignment 4

Due date:
9:00am FRI, 11/13/09

Objectives:

Differentiate model vs camera transformations. Learn about hidden surface elimination, lighting and shading.

To Do:

This assignment covers pretty much all the basic requirements for CMPS 160 -- basic polygonal models, GUI, model and camera manipulations, hidden surface elimination, lighting and shading. The assignment is divided into stages again.
Stage 1: (Basic Setup : 10%)
- Create the XYZ axes of the world coordinate frame. Color the axes red, green, and blue respectively. Each axis should go from 0 to 50 units. In addition, add 3 light colored planes (not gray) aligned with the 3 principal planes (xy, yz, and xz planes). These objects cannot be moved, rotated or scaled and are static frame of reference in the scene. Initially, the world origin should be at the center of your viewport. Your window must be at least 200x200.
- Read the enterprise model and display as a 3D wireframe. The enterprise data can be found in our repository of 3D models.
- As you read in the enterprise (or other 3D models), make sure that it is centered at the origin. The longest extent of the object should fit within a 100x100x100 box -- scale the object such that its longest dimension does not exceed 100.
- Provide a reset button r to reset the world back to this initial state.
Stage 2: (Perspective Projection : 10%) Allow the user to switch between perspective and parallel projection by pressing the p key. Here, it is important to keep the parameters for the perspective projection such that as the user toggles back and forth, the last perspective projection is maintained. Note, that there may be drastic change in appearance between parallel and perspective projections.
Stage 3: (Model Manipulation : 20%)
- Allow the user to scale the model up or down relative to the object coordinate system. Use s key in conjunction with the middle mouse. If using rollers, rolling up and away from you should shrink the enterprise, and rolling down towards you should enlarge the enterprise. If dragging the mouse, drag up should shrink the enterprise, and drag down should enlarge the enterprise.
- Allow the user to rotate the model in the object coordinate system. Use a, b, or c together with the left mouse button to rotate around the x, y, or z axis respectively. The model may disappear from the viewport.
- Allow the user to translate the model in the world coordinate system. Use x, y, or z together with the right mouse button to translate on the x, y, or z direction respectively. The model may disappear from the viewport.
Stage 4: (Camera Manipulation : 20%)
- Allow the user to move in and out of the scene. Use M key in conjunction with the middle mouse. If using rollers, rolling up and away from you will move the camera away, and rolling down towards you will move the camera closer to the scene. Note that this has no effect in parallel orthographic projection.
- Allow the user to move the camera. Use H or V together with the right mouse button to move the camera horizontally or vertically.
- Allow the user to rotate the camera. Use R, P, or Y together with the left mouse button to specify a roll, pitch (up-down) or yaw (left-right).
Stage 5: (Render Modes : 20%) Allow the user to select different rendering styles: W for the default wireframe, C for constant shading, and G for gouraud shading. For simplicity, assume your 3D model has a very light gray color (0.9, 0.9, 0.9).
Stage 6: (Lighting : 20%) Add a single directional light source to the scene. This light source is suppose to simulate the sun at noon (directly from above), with yellowish color (0.5, 0.5, 0).
Allow the user to toggle drop shadows on the floor with the d key.

Grading:

This program nominally accounts for 6% of your final grade. We must be able to compile/test your code. Make sure that the code and accompanying make/project files, etc. are tested for successful compilation at least on the PCs in the lab. Also be sure to include the executable and a README file in your submission as to which platform to use. Programs turned in at least a full day early will earn 1% bonus credit. Late programs will be charged 1% late points. In addition, late programs will not be accepted 24 hours past due date. Late programs and reports will not be accepted for the final project. The bonus credits may be accumulated up to a total of 50% toward program and final project credits. Programs are graded 80% for functionality and correctness and 20% for style, readability, documentation/writeup, and efficiency. Additional points may also be earned for extra features.

Submission:

Submission must be done using the "submit" command from CATS.

submit cmps160-ap.f09 prog4 prog4.tar, or
submit cmps160-ap.f09 prog4 prog4.zip

This command should work from unix.ic.ucsc.edu. Create and submit a subdirectory called prog4. It should contain the executable and all the files you have to make your program compile/run. Tar or zip up prog4 before submitting.