Applying PV3D Shader Materials - FlatShadeMaterial / GouraudMaterial / PhongMaterial / CellMaterial

Shader materials act a lot like Colormaterials, but with shading. Oh, and they require a Point Light.

FlatShadeMaterial

example: FlatShadeMaterial.swf
source: FlatShadeMaterial.zip

This material type really isn't all that different from ColorMaterial. It applies a flat color against the entire object. Thats really about it. Nothing to crazy about this one. But, if you decide to use it here is how it is done:

//import the FlatShadeMaterial and PointLight3D PV3D Library assets
import org.papervision3d.materials.shadematerials.FlatShadeMaterial;
import org.papervision3d.lights.PointLight3D;

//data type your FlatShadeMaterial and your point light
private var flatShadeMaterial:FlatShadeMaterial;
private var pointLight:PointLight3D;

//instantiate your point light and set it back on the z
//pointLight = new PointLight3D(boolean parameter to show the light in the scene or not);
pointLight = new PointLight3D(true);
pointLight.z = -1500;

//instantiate the flatShadeMaterial
//material = new FlatShadeMaterial(point light, diffuse color, ambient color);
flatShadeMaterial = new FlatShadeMaterial(pointLight, 0xFFFFFF, 0x000000);

//apply your flatShadeMaterial to your object
//note: some objects require that you apply your material via a MaterialsList utility
//in this example I'm applying my material to a Plane
plane = new Plane(flatShadeMaterial, 100, 100, 2, 2);


GouraudMaterial

example: GouraudMaterial.swf
source: GouraudMaterial.zip

This material type bounces back light based on the light position in relation to the normals of your geometry. Polygons will then have varying light intensity based on how direct the light is pointing at the geometry normals.

//import the GouraudMaterial and PointLight3D PV3D Library assets
import org.papervision3d.materials.shadematerials.GouraudMaterial;
import org.papervision3d.lights.PointLight3D;

//data type your GouraudMaterial and your point light
private var gouraudMaterial:GouraudMaterial;
private var pointLight:PointLight3D;

//instantiate your point light and set it back on the z
//pointLight = new PointLight3D(boolean parameter to show the light in the scene or not);
pointLight = new PointLight3D(true);
pointLight.z = -1500;

//instantiate the gouraudMaterial
//material = new GouraudMaterial(point light, light color, ambient color);
gouraudMaterial= new GouraudMaterial(pointLight, 0xFFFFFF, 0x000000);

//apply your gouraudMaterial to your object
//note: some objects require that you apply your material via a MaterialsList utility
//in this example I'm applying my material to a Plane
plane = new Plane(gouraudMaterial, 100, 100, 2, 2);


PhongMaterial

example: PhongMaterial.swf
source: PhongMaterial.zip

This material type is a calculation of light being reflected at a per pixel region. The light reflections are more intense where the light source is more of a direct hit.

//import the PhongMaterial and PointLight3D PV3D Library assets
import org.papervision3d.materials.shadematerials.PhongMaterial;
import org.papervision3d.lights.PointLight3D;

//data type your PhongMaterial and your point light
private var phongMaterial:PhongMaterial;
private var pointLight:PointLight3D;

//instantiate your point light and set it back on the z
//pointLight = new PointLight3D(boolean parameter to show the light in the scene or not);
pointLight = new PointLight3D(true);
pointLight.z = -1500;

//instantiate the phongMaterial
//material = new PhongMaterial(point light, light color, ambient color, specular intensity);
phongMaterial = new PhongMaterial(pointLight, 0xFFFFFF, 0x000000, 80);

//apply your phongMaterial to your object
//note: some objects require that you apply your material via a MaterialsList utility
//in this example I'm applying my material to a Plane
plane = new Plane(phongMaterial, 100, 100, 2, 2);


CellMaterial

example: CellMaterial.swf
source: CellMaterial.zip

This material is particularly interesting. It actually has a step gradiation of colors between two color (of your choice). For the example I set the number of steps to 10 so it would be easy to see what is going on.

//import the CellMaterial and PointLight3D PV3D Library assets
import org.papervision3d.materials.shadematerials.CellMaterial;
import org.papervision3d.lights.PointLight3D;

//data type your CellMaterial and your point light
private var cellMaterial :CellMaterial ;
private var pointLight:PointLight3D;

//instantiate your point light and set it back on the z
//pointLight = new PointLight3D(boolean parameter to show the light in the scene or not);
pointLight = new PointLight3D(true);
pointLight.z = -1500;

//instantiate the cellMaterial
//material = new CellMaterial (point light, color 1, color 2, number of steps);
cellMaterial = new CellMaterial (pointLight, 0xFFFFFF, 0x000000, 10);

//apply your cellMaterial to your object
//note: some objects require that you apply your material via a MaterialsList utility
//in this example I'm applying my material to a Sphere
sphere = new Sphere(cellMaterial, 300, 12, 12);