/*
*
* This directory contains example code for using compressed geometry in Java 3D
* through the com.sun.j3d.utils.compression package.
*
* Applications:
*
* obj2cg -- takes the names of .obj files to compress followed by the name of a
* .cg compressed geometry resource file. If the .cg file doesn't exist, then an
* attempt is made to create it; otherwise, new compressed geometry objects are
* appended to the end.
*
* The .obj files are compressed and stored into the .cg file in the order in
* which they appear in the command line, and can be accessed through indices [0 ..
* fileCount-1]
*
* cgview -- takes the name of a .cg file and the index of the object to
* display, which can range from [0 .. objectCount-1]. The object may rotated,
* scaled, and translated in response to mouse drags.
*
*
* Utility classes:
*
* ObjectFileCompressor.java -- Extends ObjectFile with compression methods.
*/
/*
* @(#)cgview.java 1.15 02/10/21 13:42:58
*
* Copyright (c) 1996-2002 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met: -
* Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer. - Redistribution in binary
* form must reproduce the above copyright notice, this list of conditions and
* the following disclaimer in the documentation and/or other materials provided
* with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
* IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
* NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE
* LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
* OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS
* LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT,
* INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
* CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF
* OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY
* OF SUCH DAMAGES.
*
* You acknowledge that Software is not designed,licensed or intended for use in
* the design, construction, operation or maintenance of any nuclear facility.
*/
import java.applet.Applet;
import java.awt.BorderLayout;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.Reader;
import java.net.URL;
import java.util.Hashtable;
import javax.media.j3d.AmbientLight;
import javax.media.j3d.Appearance;
import javax.media.j3d.Background;
import javax.media.j3d.BoundingSphere;
import javax.media.j3d.BranchGroup;
import javax.media.j3d.Canvas3D;
import javax.media.j3d.CompressedGeometry;
import javax.media.j3d.CompressedGeometryHeader;
import javax.media.j3d.DirectionalLight;
import javax.media.j3d.Material;
import javax.media.j3d.Shape3D;
import javax.media.j3d.Transform3D;
import javax.media.j3d.TransformGroup;
import javax.vecmath.Color3f;
import javax.vecmath.Point3d;
import javax.vecmath.Vector3f;
import com.sun.j3d.loaders.IncorrectFormatException;
import com.sun.j3d.loaders.ParsingErrorException;
import com.sun.j3d.loaders.Scene;
import com.sun.j3d.loaders.objectfile.ObjectFile;
import com.sun.j3d.utils.applet.MainFrame;
import com.sun.j3d.utils.behaviors.vp.OrbitBehavior;
import com.sun.j3d.utils.compression.CompressedGeometryFile;
import com.sun.j3d.utils.compression.CompressionStream;
import com.sun.j3d.utils.compression.GeometryCompressor;
import com.sun.j3d.utils.universe.SimpleUniverse;
import com.sun.j3d.utils.universe.ViewingPlatform;
public class cgview extends Applet {
private SimpleUniverse u = null;
public BranchGroup createSceneGraph(CompressedGeometry cg) {
// Create the root of the branch graph
BranchGroup objRoot = new BranchGroup();
// Create a Transformgroup to scale all objects so they
// appear in the scene.
TransformGroup objScale = new TransformGroup();
Transform3D t3d = new Transform3D();
t3d.setScale(0.7);
objScale.setTransform(t3d);
objRoot.addChild(objScale);
// Create the transform group node and initialize it to the
// identity. Enable the TRANSFORM_WRITE capability so that
// our behavior code can modify it at runtime. Add it to the
// root of the subgraph.
TransformGroup objTrans = new TransformGroup();
objTrans.setCapability(TransformGroup.ALLOW_TRANSFORM_WRITE);
objTrans.setCapability(TransformGroup.ALLOW_TRANSFORM_READ);
objScale.addChild(objTrans);
// Add compressed geometry to the scene graph.
CompressedGeometryHeader hdr = new CompressedGeometryHeader();
cg.getCompressedGeometryHeader(hdr);
// There isn't really enough information in the compressed geometry
// header to unamiguously determine the proper rendering attributes.
// The bufferDataPresent field specifies whether or not normals are
// bundled with vertices, but the compressed buffer can still contain
// normals that should be lit. Assume that any surface geometry
// should be lit and that lines and points should not unless the
// header contains the NORMAL_IN_BUFFER bit.
Material m = new Material();
if ((hdr.bufferType == hdr.TRIANGLE_BUFFER)
|| ((hdr.bufferDataPresent & hdr.NORMAL_IN_BUFFER) == 1))
m.setLightingEnable(true);
else
m.setLightingEnable(false);
Appearance a = new Appearance();
a.setMaterial(m);
objTrans.addChild(new Shape3D(cg, a));
// Create mouse behavior scheduling bounds.
BoundingSphere bounds = new BoundingSphere(new Point3d(0.0, 0.0, 0.0),
100.0);
// Set up the background
Color3f bgColor = new Color3f(0.05f, 0.05f, 0.5f);
Background bgNode = new Background(bgColor);
bgNode.setApplicationBounds(bounds);
objRoot.addChild(bgNode);
// Set up the ambient light
Color3f ambientColor = new Color3f(0.1f, 0.1f, 0.1f);
AmbientLight ambientLightNode = new AmbientLight(ambientColor);
ambientLightNode.setInfluencingBounds(bounds);
objRoot.addChild(ambientLightNode);
// Set up the directional lights
Color3f light1Color = new Color3f(1.0f, 1.0f, 0.9f);
Vector3f light1Direction = new Vector3f(1.0f, 1.0f, 1.0f);
Color3f light2Color = new Color3f(1.0f, 1.0f, 0.9f);
Vector3f light2Direction = new Vector3f(-1.0f, -1.0f, -0.9f);
DirectionalLight light1 = new DirectionalLight(light1Color,
light1Direction);
light1.setInfluencingBounds(bounds);
objRoot.addChild(light1);
DirectionalLight light2 = new DirectionalLight(light2Color,
light2Direction);
light2.setInfluencingBounds(bounds);
objRoot.addChild(light2);
return objRoot;
}
private void usage() {
System.out.println("Usage: cgview <.cg file> ");
System.exit(0);
}
public cgview(String args[]) {
if (args.length < 1)
usage();
int index;
if (args.length < 2)
index = 0;
else
index = Integer.parseInt(args[1]);
String filename = args[0];
if (filename == null)
usage();
// Read the compressed geometry.
CompressedGeometry cg = null;
try {
CompressedGeometryFile cgf;
cgf = new CompressedGeometryFile(filename, false);
if (cgf.getObjectCount() == 0) {
System.out.println("no objects were found in " + filename);
System.exit(0);
}
cg = cgf.read(index);
cgf.close();
} catch (IOException e) {
System.out.println(e);
System.exit(0);
}
setLayout(new BorderLayout());
Canvas3D c = new Canvas3D(SimpleUniverse.getPreferredConfiguration());
add("Center", c);
// Create a simple scene and attach it to the virtual universe
BranchGroup scene = createSceneGraph(cg);
u = new SimpleUniverse(c);
// add mouse behaviors to the ViewingPlatform
ViewingPlatform viewingPlatform = u.getViewingPlatform();
// This will move the ViewPlatform back a bit so the
// objects in the scene can be viewed.
viewingPlatform.setNominalViewingTransform();
OrbitBehavior orbit = new OrbitBehavior(c, OrbitBehavior.REVERSE_ALL);
BoundingSphere bounds = new BoundingSphere(new Point3d(0.0, 0.0, 0.0),
100.0);
orbit.setSchedulingBounds(bounds);
viewingPlatform.setViewPlatformBehavior(orbit);
u.addBranchGraph(scene);
}
public void destroy() {
u.cleanup();
}
//
// The following allows cgview to be run as an application
// as well as an applet.
//
public static void main(String[] args) {
new MainFrame(new cgview(args), 700, 700);
}
}
class obj2cg {
public static void main(String args[]) throws IOException {
if (args.length < 2) {
System.out
.println("obj2cg wants the names of .obj files to compress,\n"
+ "followed by the name of a .cg file to create or to\n"
+ "which to append.");
System.exit(0);
}
CompressedGeometryFile file;
file = new CompressedGeometryFile(args[args.length - 1], true);
ObjectFileCompressor compressor;
compressor = new ObjectFileCompressor();
for (int i = 0; i < args.length - 1; i++)
compressor.compress(args[i], file);
file.close();
}
}
/**
* This extension of ObjectFile provides the methods setQuantization() and
* compress() to compress Wavefront .obj files into the format described by
* appendix B of the Java 3D specification.
*/
class ObjectFileCompressor extends ObjectFile {
private GeometryCompressor compressor = null;
public ObjectFileCompressor() {
super(STRIPIFY | TRIANGULATE);
compressor = new GeometryCompressor();
}
public ObjectFileCompressor(int flags) {
super(flags | STRIPIFY | TRIANGULATE);
compressor = new GeometryCompressor();
}
public ObjectFileCompressor(int flags, float radians) {
super(flags | STRIPIFY | TRIANGULATE, radians);
compressor = new GeometryCompressor();
}
public void setFlags(int flags) {
super.setFlags(flags | STRIPIFY | TRIANGULATE);
}
private int positionQuant = 10;
private int colorQuant = 8;
private int normalQuant = 3;
/**
* Set the position, normal, and color quantization values for compression.
*
* @param positionQuant
* number of bits to quantize each position's X, Y, and Z
* components, ranging from 1 to 16 with a default of 10
* @param colorQuant
* number of bits to quantize each color's R, G, B, and alpha
* components, ranging from 2 to 16 with a default of 8
* @param normalQuant
* number of bits for quantizing each normal's U and V
* components, ranging from 0 to 6 with a default of 3
*/
public void setQuantization(int positionQuant, int colorQuant,
int normalQuant) {
this.positionQuant = positionQuant;
this.colorQuant = colorQuant;
this.normalQuant = normalQuant;
}
/**
* Compress the specified .obj file into a CompressedGeometry node
* component.
*
* @param objFileName
* String object representing the path to a .obj file
* @return a CompressedGeometry node component
*/
public CompressedGeometry compress(String objFileName) {
return compressScene(getScene(objFileName));
}
/**
* Compress the specified .obj file and add it to the end of an open
* compressed geometry file.
*
* @param objFileName
* String object representing the path to a .obj file
* @param file
* a currently open CompressedGeometryFile object
* @exception IOException -
* if write fails
*/
public void compress(String objFileName, CompressedGeometryFile file)
throws IOException {
compressScene(getScene(objFileName), file);
}
/**
* Compress the specified .obj file into a CompressedGeometry node
* component.
*
* @param reader
* an open .obj file
* @return a CompressedGeometry node component
*/
public CompressedGeometry compress(Reader reader) {
return compressScene(getScene(reader));
}
/**
* Compress the specified .obj file and add it to the end of an open
* compressed geometry file.
*
* @param reader
* an open .obj file
* @param file
* an open CompressedGeometryFile object
* @exception IOException -
* if write fails
*/
public void compress(Reader reader, CompressedGeometryFile file)
throws IOException {
compressScene(getScene(reader), file);
}
/**
* Compress the specified .obj file into a CompressedGeometry node
* component.
*
* @param url
* Uniform Resource Locator for the .obj file
* @return a CompressedGeometry node component
*/
public CompressedGeometry compress(URL url) {
return compressScene(getScene(url));
}
/**
* Compress the specified .obj file and add it to the end of an open
* compressed geometry file.
*
* @param url
* Uniform Resource Locator for the .obj file
* @param file
* a currently open CompressedGeometryFile object
* @exception IOException -
* if write fails
*/
public void compress(URL url, CompressedGeometryFile file)
throws IOException {
compressScene(getScene(url), file);
}
private CompressedGeometry compressScene(Scene scene) {
return compressor.compress(getStream(scene));
}
private void compressScene(Scene scene, CompressedGeometryFile file)
throws IOException {
compressor.compress(getStream(scene), file);
}
private CompressionStream getStream(Scene scene) {
Hashtable objs = scene.getNamedObjects();
Shape3D shapes[] = new Shape3D[objs.size()];
objs.values().toArray(shapes);
return new CompressionStream(positionQuant, colorQuant, normalQuant,
shapes);
}
private Scene getScene(String objFileName) {
Scene scene = null;
try {
scene = load(objFileName);
} catch (FileNotFoundException e) {
System.err.println(e);
System.exit(1);
} catch (ParsingErrorException e) {
System.err.println(e);
System.exit(1);
} catch (IncorrectFormatException e) {
System.err.println(e);
System.exit(1);
}
return scene;
}
private Scene getScene(Reader reader) {
Scene scene = null;
try {
scene = load(reader);
} catch (FileNotFoundException e) {
System.err.println(e);
System.exit(1);
} catch (ParsingErrorException e) {
System.err.println(e);
System.exit(1);
} catch (IncorrectFormatException e) {
System.err.println(e);
System.exit(1);
}
return scene;
}
private Scene getScene(URL url) {
Scene scene = null;
try {
scene = load(url);
} catch (FileNotFoundException e) {
System.err.println(e);
System.exit(1);
} catch (ParsingErrorException e) {
System.err.println(e);
System.exit(1);
} catch (IncorrectFormatException e) {
System.err.println(e);
System.exit(1);
}
return scene;
}
}