Package org.web3d.vrml.renderer.common.nodes

Class GeometryUtils

java.lang.Object

org.web3d.vrml.renderer.common.nodes.GeometryUtils

public class GeometryUtils
extends Object

Utilities for handling generic geometry actions.

Make sure all pointer vars that are added get cleared in the reset method. Proposed Optimization: Compact the tesselation arrays when inside a StaticGroup Compact them when max_polygon size > 5 as our estimate might be really off NOTE: It seems even with tris the array sizes are off.

Version:

$Revision: 1.21 $

Author:

Alan Hudson

Constructor Summary

Constructors

Constructor	Description
GeometryUtils()

Method Summary

Modifier and Type	Method	Description
void	copyData(GeometryHolder gh, org.j3d.geom.GeometryData gd)	Performs a shallow copy of data from a GeometryHolder to a GeometryData structure.
boolean	generateTriangleArrays(float[] coord, float[] color, float[] normal, float[] texture, int changeFlags, boolean genTexCoords, boolean genNormals, int[] vfCoordIndex, int numCoordIndex, int[] vfColorIndex, int[] vfNormalIndex, int[] vfTexCoordIndex, boolean ccw, boolean convex, boolean colorPerVertex, boolean normalPerVertex, int numColorComponents, float creaseAngle, boolean initialBuild, GeometryHolder geomData)	Take an indexed geometry and flatten to a triangle array.
boolean	generateTriangleArrays(int changeFlags, boolean genTexCoords, boolean genNormals, VRMLCoordinateNodeType vfCoord, VRMLColorNodeType vfColor, VRMLNormalNodeType vfNormal, VRMLTextureCoordinateNodeType vfTexCoord, int[] vfCoordIndex, int numCoordIndex, int[] vfColorIndex, int[] vfNormalIndex, int[] vfTexCoordIndex, boolean ccw, boolean convex, boolean colorPerVertex, boolean normalPerVertex, float creaseAngle, boolean initialBuild, GeometryHolder geomData)	Take an indexed geometry and flatten to a triangle array.
void	getCounts(int[] counts)	Get the counts of triangle, quad, ngons and maxIndexCount.
void	reset()	Reset all local variables to decrease memory usage.

Methods inherited from class java.lang.Object

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

Constructor Details

GeometryUtils

public GeometryUtils()

Method Details

reset

public void reset()

Reset all local variables to decrease memory usage.

copyData

public void copyData(GeometryHolder gh,
 org.j3d.geom.GeometryData gd)

Performs a shallow copy of data from a GeometryHolder to a GeometryData structure. Any multitexture data will be clipped to the first set.

Parameters:

gh - The GeometryHolder

gd - The GeometryData

generateTriangleArrays

public boolean generateTriangleArrays(float[] coord,
 float[] color,
 float[] normal,
 float[] texture,
 int changeFlags,
 boolean genTexCoords,
 boolean genNormals,
 int[] vfCoordIndex,
 int numCoordIndex,
 int[] vfColorIndex,
 int[] vfNormalIndex,
 int[] vfTexCoordIndex,
 boolean ccw,
 boolean convex,
 boolean colorPerVertex,
 boolean normalPerVertex,
 int numColorComponents,
 float creaseAngle,
 boolean initialBuild,
 GeometryHolder geomData)

Take an indexed geometry and flatten to a triangle array.

Parameters:

coord - replaces vfCoord.getPointRef();

color - replaces vfColor.getColor(color);

normal - replaces vfNormal.getVector(normal);

texture - in theory, a replacement for a vfTexCoord call - I recommend leaving it as null.

changeFlags - What arrays changed, defined in BaseComponentGeometry

genTexCoords - Should texture coordinates be generated if none are provided

genNormals - Should normals be generated if none are provided

vfCoordIndex - The coordinate indices seperated by -1

numCoordIndex - The number of valid coordinate indices

vfColorIndex - The color indices. NULL means use the coord indices

vfNormalIndex - The normal indices. NULL means use the coord indices

vfTexCoordIndex - The texture indices. NULL means use the coord indices

ccw - CounterClockWise, true if we are using the right-hand-rule

convex - true if the data has a convex hull for all faces

colorPerVertex - true if the data has colors per vertex, false for face

normalPerVertex - true if the data has normals per vertex, false for face

numColorComponents -

creaseAngle - Angle to smooth normals if generating normals

initialBuild - Force regeneration regardless of change flags

geomData - Returns the generated geometry here

Returns:

Did the number of triangles increase. Always true on an initial build

generateTriangleArrays

public boolean generateTriangleArrays(int changeFlags,
 boolean genTexCoords,
 boolean genNormals,
 VRMLCoordinateNodeType vfCoord,
 VRMLColorNodeType vfColor,
 VRMLNormalNodeType vfNormal,
 VRMLTextureCoordinateNodeType vfTexCoord,
 int[] vfCoordIndex,
 int numCoordIndex,
 int[] vfColorIndex,
 int[] vfNormalIndex,
 int[] vfTexCoordIndex,
 boolean ccw,
 boolean convex,
 boolean colorPerVertex,
 boolean normalPerVertex,
 float creaseAngle,
 boolean initialBuild,
 GeometryHolder geomData)

Take an indexed geometry and flatten to a triangle array.

Parameters:

changeFlags - What arrays changed, defined in BaseComponentGeometry

genTexCoords - Should texture coordinates be generated if none are provided

genNormals - Should normals be generated if none are provided

vfCoord - The coordinate data

vfColor - The color data, if provided, NULL otherwise

vfNormal - The normal data, if provided, NULL otherwise

vfTexCoord - The texture data, if provided, NULL otherwise

vfCoordIndex - The coordinate indices seperated by -1

numCoordIndex - The number of valid coordinate indices

vfColorIndex - The color indices. NULL means use the coord indices

vfNormalIndex - The normal indices. NULL means use the coord indices

vfTexCoordIndex - The texture indices. NULL means use the coord indices

ccw - CounterClockWise, true if the data is ccw wound

convex - true if the data has a convex hull

colorPerVertex - true if the data has colors per vertex, false for face

normalPerVertex - true if the data has normals per vertex, false for face

creaseAngle - Angle to smooth normals if generating normals

initialBuild - Force regeneration regardless of change flags

geomData - Returns the generated geometry here

Returns:

Did the number of triangles increase. Always true on an initial build

getCounts

public void getCounts(int[] counts)

Get the counts of triangle, quad, ngons and maxIndexCount.

Parameters:

counts - An to fill in the counts