org.jdesktop.j3d.examples.geometry_compression

Class ObjectFileCompressor

java.lang.Object

org.jogamp.java3d.loaders.objectfile.ObjectFile

org.jdesktop.j3d.examples.geometry_compression.ObjectFileCompressor

All Implemented Interfaces:

Loader

public class ObjectFileCompressor
extends ObjectFile

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.

Field Summary

Fields inherited from class org.jogamp.java3d.loaders.objectfile.ObjectFile

RESIZE, REVERSE, STRIPIFY, TRIANGULATE

Fields inherited from interface org.jogamp.java3d.loaders.Loader

LOAD_ALL, LOAD_BACKGROUND_NODES, LOAD_BEHAVIOR_NODES, LOAD_FOG_NODES, LOAD_LIGHT_NODES, LOAD_SOUND_NODES, LOAD_VIEW_GROUPS

Constructor Summary

Constructors

Constructor and Description
ObjectFileCompressor()
ObjectFileCompressor(int flags)
ObjectFileCompressor(int flags, float radians)

Method Summary

Modifier and Type	Method and Description
CompressedGeometryData	compress(java.io.Reader reader) Compress the specified .obj file into a CompressedGeometryData node component.
void	compress(java.io.Reader reader, CompressedGeometryFile file) Compress the specified .obj file and add it to the end of an open compressed geometry file.
CompressedGeometryData	compress(java.lang.String objFileName) Compress the specified .obj file into a CompressedGeometryData node component.
void	compress(java.lang.String objFileName, CompressedGeometryFile file) Compress the specified .obj file and add it to the end of an open compressed geometry file.
CompressedGeometryData	compress(java.net.URL url) Compress the specified .obj file into a CompressedGeometryData node component.
void	compress(java.net.URL url, CompressedGeometryFile file) Compress the specified .obj file and add it to the end of an open compressed geometry file.
void	setFlags(int flags) Set parameters for loading the model.
void	setQuantization(int positionQuant, int colorQuant, int normalQuant) Set the position, normal, and color quantization values for compression.

Methods inherited from class org.jogamp.java3d.loaders.objectfile.ObjectFile

createAppearance, getBasePath, getBaseUrl, getFlags, load, load, load, setBasePath, setBaseUrl

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ObjectFileCompressor

public ObjectFileCompressor()

ObjectFileCompressor

public ObjectFileCompressor(int flags)

ObjectFileCompressor

public ObjectFileCompressor(int flags,
                            float radians)

Method Detail

setFlags

public void setFlags(int flags)

Description copied from class: ObjectFile

Set parameters for loading the model. Flags defined in Loader.java are ignored by the ObjectFile Loader because the .obj file format doesn't include lights, fog, background, behaviors, views, or sounds. However, several flags are defined specifically for use with the ObjectFile Loader (see above).

Specified by:

setFlags in interface Loader

Overrides:

setFlags in class ObjectFile

setQuantization

public void setQuantization(int positionQuant,
                            int colorQuant,
                            int normalQuant)

Set the position, normal, and color quantization values for compression.

Parameters:

positionQuant - number of bits to quantize each position's X, Y, and Z components, ranging from 1 to 16 with a default of 10

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

normalQuant - number of bits for quantizing each normal's U and V components, ranging from 0 to 6 with a default of 3

compress

public CompressedGeometryData compress(java.lang.String objFileName)

Compress the specified .obj file into a CompressedGeometryData node component.

Parameters:

objFileName - String object representing the path to a .obj file

Returns:

a CompressedGeometryData node component

compress

public void compress(java.lang.String objFileName,
                     CompressedGeometryFile file)
              throws java.io.IOException

Compress the specified .obj file and add it to the end of an open compressed geometry file.

Parameters:

objFileName - String object representing the path to a .obj file

file - a currently open CompressedGeometryFile object

Throws:

java.io.IOException - - if write fails

compress

public CompressedGeometryData compress(java.io.Reader reader)

Compress the specified .obj file into a CompressedGeometryData node component.

Parameters:

reader - an open .obj file

Returns:

a CompressedGeometryData node component

compress

public void compress(java.io.Reader reader,
                     CompressedGeometryFile file)
              throws java.io.IOException

Compress the specified .obj file and add it to the end of an open compressed geometry file.

Parameters:

reader - an open .obj file

file - an open CompressedGeometryFile object

Throws:

java.io.IOException - - if write fails

compress

public CompressedGeometryData compress(java.net.URL url)

Compress the specified .obj file into a CompressedGeometryData node component.

Parameters:

url - Uniform Resource Locator for the .obj file

Returns:

a CompressedGeometryData node component

compress

public void compress(java.net.URL url,
                     CompressedGeometryFile file)
              throws java.io.IOException

Compress the specified .obj file and add it to the end of an open compressed geometry file.

Parameters:

url - Uniform Resource Locator for the .obj file

file - a currently open CompressedGeometryFile object

Throws:

java.io.IOException - - if write fails