6.837 - Project #4

• Feel free to discuss problems and approaches to your project with others
• The design and code must be your own
• Don't use code from previous semesters
• Cite any models, images, ideas, or algorithms that you do not develop yourself
• Project is due before midnight of the day indicated
• A working version of your applet and source code must be linked to your course homepage
• All source code must also be submitted via Athena's turnin procedure
• Late projects will not be accepted
• Check this page frequently for updates and clarifications

• Extend your Martix3D.class to transform normals correctly
• Implement backface culling
• Support for a directional, a point, and an ambient light source (one of each)
• Per triangle shading with support for ambient and diffuse reflection (flat shading)
• Polygon clipping in z

• Support for an arbitrary number of light sources
• Add specular highlights
• Add per vertex shading using Gouraud interpolation
• Create an interesting scene
• Create an interesting user interface

• Pipeline.java - updated parsing applet (with references to frustum, removed)
• Light.java - a class for the various types of lights
• Point3D.java - class for non-vertex 3D points
• Surface.java - a class for surface/material properties
• Vertex3D.java - a class representing a vertex with a normal
• ZRaster.java - an extension of the Raster class to include Z-buffering
• Triangle.java - a triangle rasterizer
• Matrix3D.java - a matrix object
• MatrixStack.java - a matrix Stack object
• cube.obj - A colored cube with a floor
• cow.obj - A purple cow

                // This code fragment replaces corresponding code
                // in the ReadInput method of the Pipeline applet
                if (st.sval.equals("f")) {
                    int faceTris = 0;
                    int v0 = (int) getNumber(st);
                    int v1 = (int) getNumber(st);
                    while (st.nextToken() == StreamTokenizer.TT_NUMBER) {
                        st.pushBack();
                        int v2 = (int) getNumber(st);
                        if (v2 == v0) continue;
                        if (triangles == triList.length) growList();
                        triList[triangles] = new Triangle(v0, v1, v2);
                        float nx = (vertList[v1].z - vertList[v0].z) * (vertList[v2].y - vertList[v1].y)
                                 - (vertList[v1].y - vertList[v0].y) * (vertList[v2].z - vertList[v1].z);
                        float ny = (vertList[v1].x - vertList[v0].x) * (vertList[v2].z - vertList[v1].z)
                                 - (vertList[v1].z - vertList[v0].z) * (vertList[v2].x - vertList[v1].x);
                        float nz = (vertList[v1].y - vertList[v0].y) * (vertList[v2].x - vertList[v1].x)
                                 - (vertList[v1].x - vertList[v0].x) * (vertList[v2].y - vertList[v1].y);
                        if (faceTris == 0) {
                            // the normal could be computed here instead if all
                            // facets are planar... I'll just play it safe
                            vertList[v0].addNormal(nx, ny, nz);
                            vertList[v1].addNormal(nx, ny, nz);
                        }
                        if (surfaces == 0) {
                            surfaceList[surfaces] = new Surface(0.5f, 0.5f, 0.5f, 1.0f, 1.0f, 1.0f, 5.0f);
                            surfaces += 1;
                        }
                        triList[triangles].setSurface(surfaceList[surfaces-1]);
                        vertList[v2].addNormal(nx, ny, nz);
                        v1 = v2;
                        faceTris += 1;
                        triangles += 1;
                    }
                    st.pushBack();
                } else

        // This code fragment appears in the
        // init method of the Pipeline applet
        for (int i = 0; i < vertices; i++) {
            vertList[i].averageNormals();
        }