Project1S16
Homework Assignment 1: Rendering Point Clouds
In this project the goal is to read a number of 3D point positions from a file and render them onto the screen.
Besides becoming familiar with the math involved in rendering 3D scenes, this project will get you familiar with the tools and libraries that will be your friends throughout the quarter. These will include GLFW and GLew. You are free to use any other graphics or window management library, however you must contact us first for approval, as we want to make sure that you are not using a library that does too much of the homework for you.
We recommend that you start by getting your development software ready. More information on this is here.
Reading 3D Points from Files
A point cloud is a 3D collection of points, representing a 3D object. These point clouds are often acquired by laser scanning, but can also be acquired with the Microsoft Kinect and special software, or by processing a large number of photographs of an object and using Structure from Motion techniques (see Microsoft Photosynth or Autodesk 123D Catc).
In this project we're going to render the points defined in OBJ files. Note that OBJ files are normally used to define polygonal models, but for now we're ignoring that and use the vertex definitions to render points, ignoring all connectivity data. OBJ files are 3D model files which store the shape of an object with a number of vertices, associated vertex normals, and connectivity information to form triangles. Wikipedia has excellent information on the OBJ file format. The file format is an ASCII text format, which means that the files can be viewed and edited with a any text editor, such as Notepad.
Write a parser for the vertices and normals defined in OBJ files. It should be a simple 'for' loop in which you read each line from the file, for instance with the fscanf command. Your parser does not need to do any error handling - you can assume that the files do not contain errors. Add the parser to the starter code.
Use your parser to load the vertices from the following OBJ files and treat them as point clouds:
The files provided in this project only use the following three data types (other OBJ files may support more): v for vertex, vn for vertex normal, f for face.
- v: 'vertex': followed by six floating point numbers. The first three are for the vertex position (x,y,z coordinate), the next three are for the vertex color (red, green, blue) ranging from 0 to 1. Example:
v 0.145852 0.104651 0.517576 0.2 0.8 0.4
- vn: 'vertex normal': three floating point numbers, separated by white space. The numbers are for a vector which is used as the normal for a triangle. Example:
vn -0.380694 3.839313 4.956321
Lines starting with a '#' sign are comments and can safely be ignored.
In this homework assignment, you only need to parse for vertices and vertex normals, which are those lines of the file starting with a 'v' and 'vn'.
Write your parser so that it goes through the OBJ file, line by line. It should read in the first character of each line and based on it decide how to proceed, i.e., ignore all lines which do not start with a 'v' or 'vn'. The vertex definitions can be read with the fscanf command. Here is an example:
FILE* fp; // file pointer
float x,y,z; // vertex coordinates
float r,g,b; // vertex color
int c1,c2; // characters read from file
fp = fopen("bunny.obj","rb"); // make the file name configurable so you can load other files
if (fp==NULL) { cerr << "error loading file" << endl; exit(-1); } // just in case the file can't be found or is corrupt
c1 = fgetc(fp);
c2 = fgetc(fp);
if (c1=='v') && (c2==' ')
{
fscanf(fp, "%f %f %f %f %f %f", &x, &y, &z, &r, &g, &b);
}
// read normal data accordingly
fclose(fp); // make sure you don't forget to close the file when done
Use function keys F1, F2 and F3 to load the three models, respectively. Only one 3D model should be displayed at a time.
Manipulating the Model
Once a model has been loaded, support the following keyboard commands to manipulate it:
- 'x'/'X': move left/right by a small amount
- 'y'/'Y': move down/up by a small amount
- 'z'/'Z': move into/out of the screen by a small amount
- 's'/'S': scale down/up (about the model's center, not the center of the screen)
- 'o'/'O': orbit the model about the window's z axis by a small number of degrees per key press, counterclockwise ('o') or clockwise ('O'). The z axis crosses the screen in the center of the window.
- 'r': reset position, orientation and size
