J3DUtils

java.lang.Object
- vona.j3d.J3DUtils

```
public class J3DUtils
extends java.lang.Object
```
Java3D Utilities.

Copyright (C) 2007 Marsette A. Vona, III

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Author:

Marsette (Marty) A. Vona, III

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`J3DUtils.ApplyingShapeHandler` Generic `J3DUtils.ShapeHandler` impl that delegates to an object implementing an `apply(Object[])` method.
`static interface`	`J3DUtils.ShapeHandler` callback interface for `traverseShapes(Node, ShapeHandler)`

Field Summary

Fields
Modifier and Type	Field and Description
`static javax.vecmath.Color3f`	`BLACK_3F` basic colors
`static javax.vecmath.Color3f`	`BLUE_3F` basic colors
`static javax.media.j3d.BoundingSphere`	`BOUNDS_ALL` a bounds that is never disabled
`private static java.lang.String`	`cvsid`
`static int`	`DEF_ANTI_ALIASING` default for `DEF_TRY_GCT` and `FALLBACK_GCT`
`static int`	`DEF_DOUBLE_BUFFER` default for `DEF_TRY_GCT` and `FALLBACK_GCT`
`static int`	`DEF_STENCIL` default for `DEF_TRY_GCT`
`static int`	`DEF_STEREO` default for `DEF_TRY_GCT` and `FALLBACK_GCT`
`static int[]`	`DEF_TRY_DEPTH` default for `makeGCTs(int[][], int[], int, int, int, int, boolean, javax.media.j3d.GraphicsConfigTemplate3D[])`
`static int[][]`	`DEF_TRY_FORMAT` default for `makeGCTs(int[][], int[], int, int, int, int, boolean, javax.media.j3d.GraphicsConfigTemplate3D[])`
`static javax.media.j3d.GraphicsConfigTemplate3D[]`	`DEF_TRY_GCT` default for `getBestGC()` APIs
`static javax.media.j3d.GraphicsConfigTemplate3D`	`FALLBACK_GCT` fallback for `makeGCTs(int[][], int[], int, int, int, int, boolean, javax.media.j3d.GraphicsConfigTemplate3D[])`
`static javax.vecmath.Color3f`	`GRAY_3F` basic colors
`static javax.vecmath.Color3f`	`GREEN_3F` basic colors
`static java.lang.String`	`J3D_3DS_LOADER_CLASS` external loader class names
`static java.lang.String`	`J3D_VRML97_LOADER_CLASS` external loader class names
`static javax.vecmath.Point3d`	`ORIGIN_3D` (0, 0, 0)
`static javax.vecmath.Point3f`	`ORIGIN_3F` (0, 0, 0)
`static javax.vecmath.Color3f`	`RED_3F` basic colors
`static javax.vecmath.Color3f`	`WHITE_3F` basic colors

Constructor Summary

Constructors
Constructor and Description

J3DUtils()

Constructors
Constructor and Description
`J3DUtils()`

Method Summary

Methods
Modifier and Type	Method and Description
`static void`	`addMaterialColor(javax.media.j3d.Appearance appearance, int from, int to)` covers `addMaterialColor(Material, int, int)`
`static void`	`addMaterialColor(javax.media.j3d.Material material, int from, int to)` Add one of the four colors of a material to another color in that material.
`static void`	`addMaterialColor(javax.media.j3d.Shape3D shape, int from, int to)` covers `addMaterialColor(Material, int, int)`
`static void`	`addMaterialColorRecursively(javax.media.j3d.Node root, int from, int to)` `addMaterialColor(Shape3D, int, int)` via a `traverseShapes(Node, ShapeHandler)`.
`static void`	`copyMaterialColor(javax.media.j3d.Appearance appearance, int from, int to)` covers `copyMaterialColor(Material, int, int)`
`static void`	`copyMaterialColor(javax.media.j3d.Material material, int from, int to)` Copy one of the four colors of a material to another color in that material.
`static void`	`copyMaterialColor(javax.media.j3d.Shape3D shape, int from, int to)` covers `copyMaterialColor(Material, int, int)`
`static void`	`copyMaterialColorRecursively(javax.media.j3d.Node root, int from, int to)` `copyMaterialColor(Shape3D, int, int)` via a `traverseShapes(Node, ShapeHandler)`.
`static void`	`dump(javax.media.j3d.Transform3D t3d)` `dump(Transform3D, PrintStream)` to System.out
`static void`	`dump(javax.media.j3d.Transform3D t3d, java.io.PrintStream s)` `dumpBestType(javax.media.j3d.Transform3D, java.io.PrintStream)` and contents of t3d
`static void`	`dumpBestType(javax.media.j3d.Transform3D t3d)` `dumpBestType(Transform3D, PrintStream)` to System.out
`static void`	`dumpBestType(javax.media.j3d.Transform3D t3d, java.io.PrintStream s)` `dumpTransformType(int, java.io.PrintStream)` best type of t3d
`static void`	`dumpGraph(javax.media.j3d.Appearance a)` `dumpGraph(Appearance, PrintStream)` to System.out
`static void`	`dumpGraph(javax.media.j3d.Appearance a, java.io.PrintStream s)` Specialized dump of an appearance.
`protected static void`	`dumpGraph(javax.media.j3d.Appearance a, java.lang.String prefix, java.lang.String qualifiers, java.io.PrintStream s)` impl of `dumpGraph(Appearance, PrintStream)`
`static void`	`dumpGraph(javax.media.j3d.Geometry g)` `dumpGraph(Geometry, PrintStream)` to System.out
`static void`	`dumpGraph(javax.media.j3d.Geometry g, java.io.PrintStream s)` Specialized dump of a geometry.
`protected static void`	`dumpGraph(javax.media.j3d.Geometry g, java.lang.String prefix, java.lang.String qualifiers, java.io.PrintStream s)` impl of `dumpGraph(Geometry, PrintStream)`
`static void`	`dumpGraph(javax.media.j3d.Group g)` `dumpGraph(Group, PrintStream)` to System.out
`static void`	`dumpGraph(javax.media.j3d.Group g, java.io.PrintStream s)` Recursively dump `Group` g and all its children.
`protected static void`	`dumpGraph(javax.media.j3d.Group g, java.lang.String prefix, java.lang.String qualifiers, java.util.Map<javax.media.j3d.SharedGroup,java.lang.Integer> sharedGroups, java.io.PrintStream s)` Impl of `dumpGraph(Group, PrintStream)`.
`static void`	`dumpGraph(javax.media.j3d.Link l)` `dumpGraph(Link, PrintStream)` to System.out
`static void`	`dumpGraph(javax.media.j3d.Link l, java.io.PrintStream s)` Specialized dump of a `Link` leaf.
`protected static void`	`dumpGraph(javax.media.j3d.Link l, java.lang.String prefix, java.lang.String qualifiers, java.util.Map<javax.media.j3d.SharedGroup,java.lang.Integer> sharedGroups, java.io.PrintStream s)` Impl of `dumpGraph(Link, PrintStream)`, manages collection of sharedGroups.
`static void`	`dumpGraph(com.sun.j3d.loaders.Scene scene)` `dumpGraph(Scene, PrintStream)` to System.out
`static void`	`dumpGraph(javax.media.j3d.SceneGraphObject sgo)` `dumpGraph(SceneGraphObject, PrintStream)` to System.out
`static void`	`dumpGraph(javax.media.j3d.SceneGraphObject sgo, java.io.PrintStream s)` One-line dump of the type and name (if any) of a `SceneGraphObject`.
`protected static void`	`dumpGraph(javax.media.j3d.SceneGraphObject sgo, java.lang.String prefix, java.lang.String qualifiers, java.io.PrintStream s, boolean withNewline)` Impl of `dumpGraph(SceneGraphObject, PrintStream)`.
`static void`	`dumpGraph(com.sun.j3d.loaders.Scene scene, java.io.PrintStream s)` calls `dumpGraph(Group, PrintStream)` on the scene group
`static void`	`dumpGraph(javax.media.j3d.Shape3D s3d)` `dumpGraph(Shape3D, PrintStream)` to System.out
`static void`	`dumpGraph(javax.media.j3d.Shape3D s3d, java.io.PrintStream s)` Specialized dump of a `Shape3D` leaf.
`protected static void`	`dumpGraph(javax.media.j3d.Shape3D s3d, java.lang.String prefix, java.lang.String qualifiers, java.io.PrintStream s)` impl of `dumpGraph(Shape3D, PrintStream)`
`static void`	`dumpJ3DProperties()` `dumpJ3DProperties(PrintStream)` to System.out
`static void`	`dumpJ3DProperties(javax.media.j3d.Canvas3D canvas)` `dumpJ3DProperties(Canvas3D, PrintStream)`, to System.out
`static void`	`dumpJ3DProperties(javax.media.j3d.Canvas3D canvas3D, java.io.PrintStream s)` dump Java3D system, and optionally a Canvas3D's, properties
`static void`	`dumpJ3DProperties(java.io.PrintStream s)` covers `dumpJ3DProperties(Canvas3D, PrintStream)`, no canvas
`static void`	`dumpTransformType(int type)` `dumpTransformType(int, PrintStream)` to System.out
`static void`	`dumpTransformType(int type, java.io.PrintStream s)` dump a `Transform3D` transform type mask
`static void`	`dumpVertexFormat(int vertexFormat)` `dumpVertexFormat(int, PrintStream)` to System.out
`static void`	`dumpVertexFormat(int vertexFormat, java.io.PrintStream s)` dump a string describing a vertexFormat bitmap
`static java.awt.GraphicsDevice[]`	`getAllGDs()` get all available GraphicsDevices
`static java.awt.GraphicsConfiguration`	`getBestGC()` Covers `getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...)` with `getDefaultGD()` and `DEF_TRY_GCT`.
`static java.awt.GraphicsConfiguration`	`getBestGC(java.awt.Container c)` Covers `getBestGC(Container, GraphicsConfigTemplate3D...)` with `DEF_TRY_GCT`.
`static java.awt.GraphicsConfiguration`	`getBestGC(java.awt.Container c, javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)` Covers `getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...)` with graphics device of container c.
`static java.awt.GraphicsConfiguration`	`getBestGC(javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)` Covers `getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...)` with `getDefaultGD()`.
`static java.awt.GraphicsConfiguration`	`getBestGC(java.awt.GraphicsDevice gd)` Covers `getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...)` with `DEF_TRY_GCT`.
`static java.awt.GraphicsConfiguration`	`getBestGC(java.awt.GraphicsDevice gd, javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)` For each template in tryGCT, in order, attempt to get the best compatible graphics configuration for graphics device gd, and return the first hit, if any, else null.
`static javax.media.j3d.GraphicsConfigTemplate3D`	`getBestGCT()` Covers `getBestGC(GraphicsConfigTemplate3D...)` with `DEF_TRY_GCT`.
`static javax.media.j3d.GraphicsConfigTemplate3D`	`getBestGCT(java.awt.Container c)` Covers `getBestGC(Container, GraphicsConfigTemplate3D...)` with `DEF_TRY_GCT`.
`static javax.media.j3d.GraphicsConfigTemplate3D`	`getBestGCT(java.awt.Container c, javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)` Covers `getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...)` with graphics device of container c.
`static javax.media.j3d.GraphicsConfigTemplate3D`	`getBestGCT(javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)` Covers `getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...)` with `getDefaultGD()`.
`static javax.media.j3d.GraphicsConfigTemplate3D`	`getBestGCT(java.awt.GraphicsDevice gd)` Covers `getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...)` with `DEF_TRY_GCT`.
`static javax.media.j3d.GraphicsConfigTemplate3D`	`getBestGCT(java.awt.GraphicsDevice gd, javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)` For each template in tryGCT, in order, attempt to get the best compatible graphics configuration for graphics device gd, and return the template corresponding to the first hit, if any, else null.
`static int[]`	`getComponentOffsets(int vertexFormat)` `getComponentOffsets(int, int[])`, always cons
`static int[]`	`getComponentOffsets(int vertexFormat, int[] offset)` get the start indices for each component of an interleaved vertex
`static java.awt.GraphicsDevice`	`getDefaultGD()` get default GraphicsDevice
`static java.nio.FloatBuffer`	`getFloatBuffer(javax.media.j3d.J3DBuffer j3dBuf)` Dereference the contained NIO buffer in j3dBuf as a `FloatBuffer`.
`static java.awt.GraphicsDevice`	`getGD(java.awt.Container c)` get GraphicsDevice of a Container, or null if c not realized
`static java.lang.String`	`getInfo(javax.media.j3d.Geometry geometry)` Covers `dumpGraph(Geometry, String, String, PrintStream)`, writes to String.
`static java.lang.String`	`getJ3DVersionMessage()` defers to eponymous method in `J3DVersion`
`static javax.vecmath.Color3f`	`getMaterialColor(javax.media.j3d.Appearance appearance, int which)` covers `getMaterialColor(Material, int)`
`static javax.vecmath.Color3f`	`getMaterialColor(javax.media.j3d.Appearance appearance, int which, javax.vecmath.Color3f color)` covers `getMaterialColor(Material, int, Color3f)`
`static javax.vecmath.Color3f`	`getMaterialColor(javax.media.j3d.Material material, int which)` covers `getMaterialColor(Material, int)`, always conses
`static javax.vecmath.Color3f`	`getMaterialColor(javax.media.j3d.Material material, int which, javax.vecmath.Color3f color)` Get one of the four colors of a material.
`static javax.vecmath.Color3f`	`getMaterialColor(javax.media.j3d.Shape3D shape, int which)` covers `getMaterialColor(Material, int)`
`static javax.vecmath.Color3f`	`getMaterialColor(javax.media.j3d.Shape3D shape, int which, javax.vecmath.Color3f color)` covers `getMaterialColor(Material, int, Color3f)`
`static java.lang.String`	`getName(javax.media.j3d.SceneGraphObject sgo)` Get the name of sgo as it may have been set by `load(URL, URL, String, int)`.
`static boolean`	`hasJ3D()` defers to eponymous method in `J3DVersion`
`static boolean`	`hasJ3D14()` defers to eponymous method in `J3DVersion`
`static boolean`	`hasJ3D15()` defers to eponymous method in `J3DVersion`
`static com.sun.j3d.loaders.Scene`	`load(java.io.File sceneFile)` covers `load(File, File, String, int)`, uses defaults
`static com.sun.j3d.loaders.Scene`	`load(java.io.File sceneFile, java.io.File baseFile, java.lang.String format, int flags)` covers `load(URL, URL, String, int)`, loads from file
`static com.sun.j3d.loaders.Scene`	`load(java.lang.String sceneFile)` covers `load(String, String, String, int)`, uses defaults
`static com.sun.j3d.loaders.Scene`	`load(java.lang.String sceneFile, java.lang.String baseFile, java.lang.String format, int flags)` covers `load(File, File, String, int)`
`static com.sun.j3d.loaders.Scene`	`load(java.net.URL sceneURL)` covers `load(URL, URL, String, int)`, uses defaults
`static com.sun.j3d.loaders.Scene`	`load(java.net.URL sceneURL, java.net.URL baseURL, java.lang.String format, int flags)` Load a Java3D `Scene` from a URL.
`static void`	`main(java.lang.String[] arg)` `dumpJ3DProperties(javax.media.j3d.Canvas3D, java.io.PrintStream)` iff `hasJ3D()`
`static java.nio.FloatBuffer`	`makeFloatBuffer(int numFloats)` make a new direct native byte order float buffer
`static javax.media.j3d.GraphicsConfigTemplate3D[]`	`makeGCTs(int[][] tryFormat, int[] tryDepth, int stencil, int doubleBuffer, int stereo, int antialiasing, boolean withFallback, javax.media.j3d.GraphicsConfigTemplate3D[] gct)` Make a priority list of graphics config templates given ordered set of desired pixel formats and depth buffer widths.
`static javax.media.j3d.Raster`	`makeImageRaster(javax.media.j3d.ImageComponent2D imageComponent)` make a color image raster around an imageComponent
`static javax.media.j3d.Raster`	`makeImageRaster(int width, int height)` Calls `makeImageRaster(ImageComponent2D)` with an image component from `makeRGBImageComponent2D(int, int)`.
`static java.nio.IntBuffer`	`makeIntBuffer(int numInts)` make a new direct native byte order int buffer
`static com.sun.j3d.loaders.Loader`	`makeLoaderForFormat(java.lang.String format)` Dispatch factory for `load(URL, URL, String, int)` mapping a loader format string to an instance of a Java3D scene `Loader`.
`static javax.media.j3d.ImageComponent2D`	`makeRGBImageComponent2D(int width, int height)` make RGB image component with a byRef yUp `BufferedImage`
`static int`	`numColorComponents(int vertexFormat)` get the number of color components per vertex, no multitexturing
`static int`	`numPrims(javax.media.j3d.GeometryArray ga)` return the prim count of ga
`static int`	`numTexCoords(int vertexFormat)` get the number of texture coords per vertex, no multitexturing
`static java.nio.FloatBuffer`	`resizeBuffer(java.nio.FloatBuffer buffer, int newSize)` Returns a buffer of newSize floats initialized to the contents of buffer.
`static java.nio.IntBuffer`	`resizeBuffer(java.nio.IntBuffer buffer, int newSize)` similar to `resizeBuffer(FloatBuffer, int)`
`static boolean`	`restoreJOGLSingleThreading()` See `setPreferredPipeline(java.lang.String)`.
`static void`	`saveRGBImage(javax.media.j3d.ImageComponent2D imageComponent, java.io.File file, java.lang.String format)` Save the `BufferedImage` from imageComponent to file in the given format.
`static void`	`saveRGBImage(javax.media.j3d.Raster raster, java.io.File file, java.lang.String format)` covers `saveRGBImage(ImageComponent2D, File, String)`
`static void`	`setAlpha(javax.media.j3d.Appearance appearance, float alpha, boolean iffPresent)` set TransparencyAttributes alpha (1.0f-transparency)
`static void`	`setAlpha(javax.media.j3d.Shape3D shape, float alpha, boolean iffPresent)` covers `setAlpha(Appearance, float, boolean)`
`static void`	`setAlphaRecursively(javax.media.j3d.Node root, float alpha)` Covers `setAlphaRecursively(Node, float, boolean)`, conses if not present.
`static void`	`setAlphaRecursively(javax.media.j3d.Node root, float alpha, boolean iffPresent)` `setAlpha(Shape3D, float, boolean)` via a `traverseShapes(Node, ShapeHandler)` from root.
`static void`	`setBlendedRecursively(javax.media.j3d.Node root)` covers `setBlendedRecursively(Node, boolean)`, always conses
`static void`	`setBlendedRecursively(javax.media.j3d.Node root, boolean iffPresent)` covers `setTransparencyModeRecursively(Node, int, boolean)`
`static void`	`setColorTarget(javax.media.j3d.Appearance appearance, int target, boolean iffPresent)` covers `setColorTarget(Material, int)`
`static void`	`setColorTarget(javax.media.j3d.Material material, int target)` Set the color target of a material.
`static void`	`setColorTarget(javax.media.j3d.Shape3D shape, int target, boolean iffPresent)` covers `setColorTarget(Material, int)`
`static void`	`setFlatShadeModelRecursively(javax.media.j3d.Node root)` covers `setShadeModelRecursively(Node, int)`
`static void`	`setGouraudShadeModelRecursively(javax.media.j3d.Node root)` covers `setShadeModelRecursively(Node, int)`
`static void`	`setIgnoreVertexColors(javax.media.j3d.Appearance appearance, boolean ignore, boolean iffPresent)` set whether to ignore per-vertex colors
`static void`	`setIgnoreVertexColors(javax.media.j3d.Shape3D shape, boolean ignore, boolean iffPresent)` covers `setIgnoreVertexColors(Appearance, boolean, boolean)`
`static void`	`setIgnoreVertexColorsRecursively(javax.media.j3d.Node root, boolean ignore)` Covers `setIgnoreVertexColorsRecursively(Node, boolean, boolean)`, conses if not present.
`static void`	`setIgnoreVertexColorsRecursively(javax.media.j3d.Node root, boolean ignore, boolean iffPresent)` `setIgnoreVertexColors(Shape3D, boolean, boolean)` via a `traverseShapes(Node, ShapeHandler)` from root.
`static void`	`setLightWeightPopupEnabled(boolean enable)` enable/disable Swing lightweight menu and tooltip popups
`static void`	`setLineWidth(javax.media.j3d.Appearance appearance, float width, boolean iffPresent)` set LineAttributes lineWidth
`static void`	`setLineWidth(javax.media.j3d.Shape3D shape, float width, boolean iffPresent)` covers `setLineWidth(Appearance, float, boolean)`
`static void`	`setMaterialColor(javax.media.j3d.Appearance appearance, int which, javax.vecmath.Color3f color, boolean iffPresent)` covers `setMaterialColor(Material, int, Color3f)`
`static void`	`setMaterialColor(javax.media.j3d.Material material, int which, javax.vecmath.Color3f color)` Set one of the four colors of a material.
`static void`	`setMaterialColor(javax.media.j3d.Shape3D shape, int which, javax.vecmath.Color3f color, boolean iffPresent)` covers `setMaterialColor(Appearance, int, Color3f, boolean)`
`static void`	`setMaterialColorRecursively(javax.media.j3d.Node root, int which, javax.vecmath.Color3f color)` Covers `setMaterialColorRecursively(Node, int, Color3f, boolean)`, never conses if not present.
`static void`	`setMaterialColorRecursively(javax.media.j3d.Node root, int which, javax.vecmath.Color3f color, boolean iffPresent)` `setMaterialColor(javax.media.j3d.Material, int, javax.vecmath.Color3f)` via a `traverseShapes(Node, ShapeHandler)`.
`static void`	`setMaterialColorRecursively(javax.media.j3d.Node root, int which, float r, float g, float b)` covers `setMaterialColorRecursively(Node, int, Color3f)`
`static boolean`	`setPreferredPipeline(java.lang.String preferredPipeline)` Set the system property Java3D considers when choosing a pipeline.
`static void`	`setScreenDoorRecursively(javax.media.j3d.Node root)` Covers `setScreenDoorRecursively(Node, boolean)`, always conses.
`static void`	`setScreenDoorRecursively(javax.media.j3d.Node root, boolean iffPresent)` covers `setTransparencyModeRecursively(Node, int, boolean)`
`static void`	`setShadeModel(javax.media.j3d.Appearance appearance, int shadeModel, boolean iffPresent)` set ColoringAttributes shade model
`static void`	`setShadeModel(javax.media.j3d.Shape3D shape, int shadeModel, boolean iffPresent)` covers `setShadeModel(Appearance, int, boolean)`
`static void`	`setShadeModelRecursively(javax.media.j3d.Node root, int shadeModel)` Covers `setShadeModelRecursively(Node, int, boolean)`, conses if not present.
`static void`	`setShadeModelRecursively(javax.media.j3d.Node root, int shadeModel, boolean iffPresent)` `setShadeModel(Shape3D, int, boolean)` via a `traverseShapes(Node, ShapeHandler)` from root.
`static void`	`setTransparencyMode(javax.media.j3d.Appearance appearance, int transparencyMode, boolean iffPresent)` set TransparencyAttributes transparency mode
`static void`	`setTransparencyMode(javax.media.j3d.Shape3D shape, int transparencyMode, boolean iffPresent)` covers `setTransparencyMode(Appearance, int, boolean)`
`static void`	`setTransparencyModeRecursively(javax.media.j3d.Node root, int transparencyMode)` Covers `setTransparencyModeRecursively(Node, int, boolean)`, conses if not present.
`static void`	`setTransparencyModeRecursively(javax.media.j3d.Node root, int transparencyMode, boolean iffPresent)` `setTransparencyMode(Shape3D, int, boolean)` via a `traverseShapes(Node, ShapeHandler)` from root.
`static void`	`setTwoSided(javax.media.j3d.Appearance appearance, boolean twoSided, boolean iffPresent)` set PolygonAttributes back face normal flip and cull face
`static void`	`setTwoSided(javax.media.j3d.Shape3D shape, boolean twoSided, boolean iffPresent)` covers `setTwoSided(Appearance, boolean, boolean)`
`static void`	`setTwoSidedRecursively(javax.media.j3d.Node root, boolean twoSided)` Covers `setTwoSidedRecursively(Node, boolean, boolean)`, conses if not present.
`static void`	`setTwoSidedRecursively(javax.media.j3d.Node root, boolean twoSided, boolean iffPresent)` `setTwoSided(Shape3D, boolean, boolean)` via a `traverseShapes(Node, ShapeHandler)` from root.
`static void`	`setUnlitColor(javax.media.j3d.Appearance appearance, javax.vecmath.Color3f color, boolean iffPresent)` set ColoringAttributes color
`static void`	`setUnlitColor(javax.media.j3d.Shape3D shape, javax.vecmath.Color3f color, boolean iffPresent)` covers `setUnlitColor(Appearance, Color3f, boolean)`
`static void`	`setUnlitColorRecursively(javax.media.j3d.Node root, javax.vecmath.Color3f color)` Covers `setUnlitColorRecursively(Node, Color3f, boolean)`, conses if not present.
`static void`	`setUnlitColorRecursively(javax.media.j3d.Node root, javax.vecmath.Color3f color, boolean iffPresent)` `setUnlitColor(Shape3D, Color3f, boolean)` via a `traverseShapes(Node, ShapeHandler)` from root.
`static void`	`setUnlitColorRecursively(javax.media.j3d.Node root, float r, float g, float b)` covers `setUnlitColorRecursively(Node, Color3f)`
`static java.lang.String`	`textBestType(javax.media.j3d.Transform3D t3d)` covers `dumpBestType(javax.media.j3d.Transform3D, java.io.PrintStream)`, writes to String
`static java.lang.String`	`textTransformType(int type)` covers `dumpTransformType(int, java.io.PrintStream)`, writes to String
`static java.lang.String`	`textVertexFormat(int vertexFormat)` covers `dumpVertexFormat(int, java.io.PrintStream)`, writes to String
`static void`	`traverseShapes(javax.media.j3d.Node root, J3DUtils.ShapeHandler shapeHandler)` DFS the scene graph starting at root passing each encountered Shape3D to shapeHandler.
`protected static boolean`	`traverseShapes(javax.media.j3d.Node root, J3DUtils.ShapeHandler shapeHandler, java.util.Set<javax.media.j3d.SharedGroup> visitedSharedGroups)` impl of `traverseShapes(Node, ShapeHandler)`
`static void`	`traverseShapes(com.sun.j3d.loaders.Scene scene, J3DUtils.ShapeHandler shapeHandler)` covers `traverseShapes(Node, ShapeHandler)`
`static int`	`vertsPerPrim(javax.media.j3d.GeometryArray ga)` get number of vertices per primitive based on the type of ga
`static int`	`wordsPerVertex(int vertexFormat)` get the number of 32-bit words per vertex, no multitexturing
`static int`	`wordsPerVertex(int vertexFormat, int texCoordSetCount)` get the number of 32-bit words per vertex

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - cvsid
```
private static final java.lang.String cvsid
```
    See Also:
    Constant Field Values
  - J3D_VRML97_LOADER_CLASS
```
public static final java.lang.String J3D_VRML97_LOADER_CLASS
```
    external loader class names
    
    See Also:
    Constant Field Values
  - J3D_3DS_LOADER_CLASS
```
public static final java.lang.String J3D_3DS_LOADER_CLASS
```
    external loader class names
    
    See Also:
    Constant Field Values
  - BLACK_3F
```
public static final javax.vecmath.Color3f BLACK_3F
```
    basic colors
  - WHITE_3F
```
public static final javax.vecmath.Color3f WHITE_3F
```
    basic colors
  - GRAY_3F
```
public static final javax.vecmath.Color3f GRAY_3F
```
    basic colors
  - RED_3F
```
public static final javax.vecmath.Color3f RED_3F
```
    basic colors
  - GREEN_3F
```
public static final javax.vecmath.Color3f GREEN_3F
```
    basic colors
  - BLUE_3F
```
public static final javax.vecmath.Color3f BLUE_3F
```
    basic colors
  - ORIGIN_3F
```
public static final javax.vecmath.Point3f ORIGIN_3F
```
    (0, 0, 0)
  - ORIGIN_3D
```
public static final javax.vecmath.Point3d ORIGIN_3D
```
    (0, 0, 0)
  - BOUNDS_ALL
```
public static final javax.media.j3d.BoundingSphere BOUNDS_ALL
```
    a bounds that is never disabled
  - DEF_TRY_FORMAT
```
public static final int[][] DEF_TRY_FORMAT
```
    default for makeGCTs(int[][], int[], int, int, int, int, boolean, javax.media.j3d.GraphicsConfigTemplate3D[])
  - DEF_TRY_DEPTH
```
public static final int[] DEF_TRY_DEPTH
```
    default for makeGCTs(int[][], int[], int, int, int, int, boolean, javax.media.j3d.GraphicsConfigTemplate3D[])
  - DEF_STENCIL
```
public static final int DEF_STENCIL
```
    default for DEF_TRY_GCT
    
    See Also:
    Constant Field Values
  - DEF_DOUBLE_BUFFER
```
public static final int DEF_DOUBLE_BUFFER
```
    default for DEF_TRY_GCT and FALLBACK_GCT
    
    See Also:
    Constant Field Values
  - DEF_STEREO
```
public static final int DEF_STEREO
```
    default for DEF_TRY_GCT and FALLBACK_GCT
    
    See Also:
    Constant Field Values
  - DEF_ANTI_ALIASING
```
public static final int DEF_ANTI_ALIASING
```
    default for DEF_TRY_GCT and FALLBACK_GCT
    
    See Also:
    Constant Field Values
  - FALLBACK_GCT
```
public static final javax.media.j3d.GraphicsConfigTemplate3D FALLBACK_GCT
```
    fallback for makeGCTs(int[][], int[], int, int, int, int, boolean, javax.media.j3d.GraphicsConfigTemplate3D[])
  - DEF_TRY_GCT
```
public static final javax.media.j3d.GraphicsConfigTemplate3D[] DEF_TRY_GCT
```
    default for getBestGC() APIs
- Constructor Detail
  - J3DUtils
```
public J3DUtils()
```
- Method Detail
  - load
```
public static com.sun.j3d.loaders.Scene load(java.net.URL sceneURL,
                             java.net.URL baseURL,
                             java.lang.String format,
                             int flags)
                                      throws java.io.IOException,
                                             com.sun.j3d.loaders.IncorrectFormatException,
                                             com.sun.j3d.loaders.ParsingErrorException
```
    Load a Java3D Scene from a URL.
    
    See makeLoaderForFormat(java.lang.String) for currently supported formats.
    
    The loader is executed with the specified flags to load a Java3D Scene. If the Scene defines any named SceneGraphObjects then the names are set on those objects (or the user data is set to the name in early versions of Java3D which do not support SceneGraphObject.setName()).
    
    Parameters:
    sceneURL - the url of the scene, this is just passed to the loader implementation selected for the format
    baseURL - if not null then the base URL of the loader is set to this. If null then the base URL is implied from the sceneURL and set on the loader (some versions of some loaders have been known not to work correctly in some contexts if the base URL is not explicitly set).
    format - if not null then this is a lower case string identifying the file format, see above. If null this is implied as the filename extension of sceneURL.
    flags - bitmask of Java3D Loader.LOAD_* flags to set on the loader. Zero means load geometry only.
    
    Throws:
    
    java.lang.IllegalArgumentException - if baseURL is null and there was an error extracting the base of sceneURL, or if no Loader is registered for format
    
    java.io.IOException
    
    com.sun.j3d.loaders.IncorrectFormatException
    
    com.sun.j3d.loaders.ParsingErrorException
  - load
```
public static com.sun.j3d.loaders.Scene load(java.net.URL sceneURL)
                                      throws java.io.IOException,
                                             com.sun.j3d.loaders.IncorrectFormatException,
                                             com.sun.j3d.loaders.ParsingErrorException
```
    covers load(URL, URL, String, int), uses defaults
    
    Throws:
    
    java.io.IOException
    
    com.sun.j3d.loaders.IncorrectFormatException
    
    com.sun.j3d.loaders.ParsingErrorException
  - load
```
public static com.sun.j3d.loaders.Scene load(java.io.File sceneFile,
                             java.io.File baseFile,
                             java.lang.String format,
                             int flags)
                                      throws java.io.IOException,
                                             com.sun.j3d.loaders.IncorrectFormatException,
                                             com.sun.j3d.loaders.ParsingErrorException
```
    covers load(URL, URL, String, int), loads from file
    
    Throws:
    
    java.io.IOException
    
    com.sun.j3d.loaders.IncorrectFormatException
    
    com.sun.j3d.loaders.ParsingErrorException
  - load
```
public static com.sun.j3d.loaders.Scene load(java.io.File sceneFile)
                                      throws java.io.IOException,
                                             com.sun.j3d.loaders.IncorrectFormatException,
                                             com.sun.j3d.loaders.ParsingErrorException
```
    covers load(File, File, String, int), uses defaults
    
    Throws:
    
    java.io.IOException
    
    com.sun.j3d.loaders.IncorrectFormatException
    
    com.sun.j3d.loaders.ParsingErrorException
  - load
```
public static com.sun.j3d.loaders.Scene load(java.lang.String sceneFile,
                             java.lang.String baseFile,
                             java.lang.String format,
                             int flags)
                                      throws java.io.IOException,
                                             com.sun.j3d.loaders.IncorrectFormatException,
                                             com.sun.j3d.loaders.ParsingErrorException
```
    covers load(File, File, String, int)
    
    Throws:
    
    java.io.IOException
    
    com.sun.j3d.loaders.IncorrectFormatException
    
    com.sun.j3d.loaders.ParsingErrorException
  - load
```
public static com.sun.j3d.loaders.Scene load(java.lang.String sceneFile)
                                      throws java.io.IOException,
                                             com.sun.j3d.loaders.IncorrectFormatException,
                                             com.sun.j3d.loaders.ParsingErrorException
```
    covers load(String, String, String, int), uses defaults
    
    Throws:
    
    java.io.IOException
    
    com.sun.j3d.loaders.IncorrectFormatException
    
    com.sun.j3d.loaders.ParsingErrorException
  - makeLoaderForFormat
```
public static com.sun.j3d.loaders.Loader makeLoaderForFormat(java.lang.String format)
```
    Dispatch factory for load(URL, URL, String, int) mapping a loader format string to an instance of a Java3D scene Loader.
    
    Currently supported formats:
  - lws - official Java3D Lighwave scene loader
  - obj - official Java3D Lightwave object loader
  - vrml - jdesktop VRML97 (aka VRML2.0) loader
  - 3ds - microcrowd 3D studio max loader

Parameters:: format - a string identifying the file type, will be converted to lower case
Throws:: java.lang.IllegalArgumentException - if no Loader is registered for format

getName
```
public static java.lang.String getName(javax.media.j3d.SceneGraphObject sgo)
```
Get the name of sgo as it may have been set by load(URL, URL, String, int).

setTwoSided

public static void setTwoSided(javax.media.j3d.Appearance appearance,
               boolean twoSided,
               boolean iffPresent)

set PolygonAttributes back face normal flip and cull face

setTwoSided

public static void setTwoSided(javax.media.j3d.Shape3D shape,
               boolean twoSided,
               boolean iffPresent)

covers setTwoSided(Appearance, boolean, boolean)

setUnlitColor

public static void setUnlitColor(javax.media.j3d.Appearance appearance,
                 javax.vecmath.Color3f color,
                 boolean iffPresent)

set ColoringAttributes color

setUnlitColor

public static void setUnlitColor(javax.media.j3d.Shape3D shape,
                 javax.vecmath.Color3f color,
                 boolean iffPresent)

covers setUnlitColor(Appearance, Color3f, boolean)

setShadeModel

public static void setShadeModel(javax.media.j3d.Appearance appearance,
                 int shadeModel,
                 boolean iffPresent)

set ColoringAttributes shade model

setShadeModel

public static void setShadeModel(javax.media.j3d.Shape3D shape,
                 int shadeModel,
                 boolean iffPresent)

covers setShadeModel(Appearance, int, boolean)

setTransparencyMode

public static void setTransparencyMode(javax.media.j3d.Appearance appearance,
                       int transparencyMode,
                       boolean iffPresent)

set TransparencyAttributes transparency mode

setTransparencyMode

public static void setTransparencyMode(javax.media.j3d.Shape3D shape,
                       int transparencyMode,
                       boolean iffPresent)

covers setTransparencyMode(Appearance, int, boolean)

setAlpha

public static void setAlpha(javax.media.j3d.Appearance appearance,
            float alpha,
            boolean iffPresent)

set TransparencyAttributes alpha (1.0f-transparency)

setAlpha

public static void setAlpha(javax.media.j3d.Shape3D shape,
            float alpha,
            boolean iffPresent)

covers setAlpha(Appearance, float, boolean)

setLineWidth

public static void setLineWidth(javax.media.j3d.Appearance appearance,
                float width,
                boolean iffPresent)

set LineAttributes lineWidth

setLineWidth

public static void setLineWidth(javax.media.j3d.Shape3D shape,
                float width,
                boolean iffPresent)

covers setLineWidth(Appearance, float, boolean)

setIgnoreVertexColors

public static void setIgnoreVertexColors(javax.media.j3d.Appearance appearance,
                         boolean ignore,
                         boolean iffPresent)

set whether to ignore per-vertex colors

setIgnoreVertexColors

public static void setIgnoreVertexColors(javax.media.j3d.Shape3D shape,
                         boolean ignore,
                         boolean iffPresent)

covers setIgnoreVertexColors(Appearance, boolean, boolean)

setColorTarget
```
public static void setColorTarget(javax.media.j3d.Material material,
                  int target)
```
Set the color target of a material.

Parameters:
target - Material.AMBIENT_AND_DIFFUSE or one of the Material color index constants, e.g. AMBIENT, DIFFUSE, EMISSIVE, SPECULAR

setColorTarget

public static void setColorTarget(javax.media.j3d.Appearance appearance,
                  int target,
                  boolean iffPresent)

covers setColorTarget(Material, int)

setColorTarget

public static void setColorTarget(javax.media.j3d.Shape3D shape,
                  int target,
                  boolean iffPresent)

covers setColorTarget(Material, int)

getMaterialColor
```
public static javax.vecmath.Color3f getMaterialColor(javax.media.j3d.Material material,
                                     int which,
                                     javax.vecmath.Color3f color)
```
Get one of the four colors of a material.

Parameters:
color - the color is written here on return, or if null a new Color3f is consed
which - one of the Material color index constants, e.g. AMBIENT, DIFFUSE, EMISSIVE, SPECULAR

getMaterialColor

public static javax.vecmath.Color3f getMaterialColor(javax.media.j3d.Appearance appearance,
                                     int which,
                                     javax.vecmath.Color3f color)

covers getMaterialColor(Material, int, Color3f)

getMaterialColor

public static javax.vecmath.Color3f getMaterialColor(javax.media.j3d.Shape3D shape,
                                     int which,
                                     javax.vecmath.Color3f color)

covers getMaterialColor(Material, int, Color3f)

getMaterialColor

public static javax.vecmath.Color3f getMaterialColor(javax.media.j3d.Material material,
                                     int which)

covers getMaterialColor(Material, int), always conses

getMaterialColor

public static javax.vecmath.Color3f getMaterialColor(javax.media.j3d.Appearance appearance,
                                     int which)

covers getMaterialColor(Material, int)

getMaterialColor

public static javax.vecmath.Color3f getMaterialColor(javax.media.j3d.Shape3D shape,
                                     int which)

covers getMaterialColor(Material, int)

setMaterialColor
```
public static void setMaterialColor(javax.media.j3d.Material material,
                    int which,
                    javax.vecmath.Color3f color)
```
Set one of the four colors of a material.

Parameters:
which - one of the Material color index constants, e.g. AMBIENT, DIFFUSE, EMISSIVE, SPECULAR

setMaterialColor

public static void setMaterialColor(javax.media.j3d.Appearance appearance,
                    int which,
                    javax.vecmath.Color3f color,
                    boolean iffPresent)

covers setMaterialColor(Material, int, Color3f)

setMaterialColor

public static void setMaterialColor(javax.media.j3d.Shape3D shape,
                    int which,
                    javax.vecmath.Color3f color,
                    boolean iffPresent)

covers setMaterialColor(Appearance, int, Color3f, boolean)

copyMaterialColor
```
public static void copyMaterialColor(javax.media.j3d.Material material,
                     int from,
                     int to)
```
Copy one of the four colors of a material to another color in that material.

Parameters:
from - one of the Material color index constants, e.g. AMBIENT, DIFFUSE, EMISSIVE, SPECULAR
to - another color index constant

copyMaterialColor

public static void copyMaterialColor(javax.media.j3d.Appearance appearance,
                     int from,
                     int to)

covers copyMaterialColor(Material, int, int)

copyMaterialColor

public static void copyMaterialColor(javax.media.j3d.Shape3D shape,
                     int from,
                     int to)

covers copyMaterialColor(Material, int, int)

addMaterialColor
```
public static void addMaterialColor(javax.media.j3d.Material material,
                    int from,
                    int to)
```
Add one of the four colors of a material to another color in that material.

Parameters:
from - one of the Material color index constants, e.g. AMBIENT, DIFFUSE, EMISSIVE, SPECULAR
to - another color index constant

addMaterialColor

public static void addMaterialColor(javax.media.j3d.Appearance appearance,
                    int from,
                    int to)

covers addMaterialColor(Material, int, int)

addMaterialColor

public static void addMaterialColor(javax.media.j3d.Shape3D shape,
                    int from,
                    int to)

covers addMaterialColor(Material, int, int)

traverseShapes
```
public static void traverseShapes(javax.media.j3d.Node root,
                  J3DUtils.ShapeHandler shapeHandler)
```
DFS the scene graph starting at root passing each encountered Shape3D to shapeHandler.

Each encountered SharedGroup, if any, will be traversed exactly once.

traverseShapes

public static void traverseShapes(com.sun.j3d.loaders.Scene scene,
                  J3DUtils.ShapeHandler shapeHandler)

covers traverseShapes(Node, ShapeHandler)

traverseShapes

protected static boolean traverseShapes(javax.media.j3d.Node root,
                     J3DUtils.ShapeHandler shapeHandler,
                     java.util.Set<javax.media.j3d.SharedGroup> visitedSharedGroups)

impl of traverseShapes(Node, ShapeHandler)

setTwoSidedRecursively

public static void setTwoSidedRecursively(javax.media.j3d.Node root,
                          boolean twoSided,
                          boolean iffPresent)

setTwoSided(Shape3D, boolean, boolean) via a traverseShapes(Node, ShapeHandler) from root.

setTwoSidedRecursively

public static void setTwoSidedRecursively(javax.media.j3d.Node root,
                          boolean twoSided)

Covers setTwoSidedRecursively(Node, boolean, boolean), conses if not present.

setUnlitColorRecursively

public static void setUnlitColorRecursively(javax.media.j3d.Node root,
                            javax.vecmath.Color3f color,
                            boolean iffPresent)

setUnlitColor(Shape3D, Color3f, boolean) via a traverseShapes(Node, ShapeHandler) from root.

setUnlitColorRecursively

public static void setUnlitColorRecursively(javax.media.j3d.Node root,
                            javax.vecmath.Color3f color)

Covers setUnlitColorRecursively(Node, Color3f, boolean), conses if not present.

setUnlitColorRecursively

public static void setUnlitColorRecursively(javax.media.j3d.Node root,
                            float r,
                            float g,
                            float b)

covers setUnlitColorRecursively(Node, Color3f)

setShadeModelRecursively

public static void setShadeModelRecursively(javax.media.j3d.Node root,
                            int shadeModel,
                            boolean iffPresent)

setShadeModel(Shape3D, int, boolean) via a traverseShapes(Node, ShapeHandler) from root.

setShadeModelRecursively

public static void setShadeModelRecursively(javax.media.j3d.Node root,
                            int shadeModel)

Covers setShadeModelRecursively(Node, int, boolean), conses if not present.

setFlatShadeModelRecursively

public static void setFlatShadeModelRecursively(javax.media.j3d.Node root)

covers setShadeModelRecursively(Node, int)

setGouraudShadeModelRecursively

public static void setGouraudShadeModelRecursively(javax.media.j3d.Node root)

covers setShadeModelRecursively(Node, int)

setTransparencyModeRecursively

public static void setTransparencyModeRecursively(javax.media.j3d.Node root,
                                  int transparencyMode,
                                  boolean iffPresent)

setTransparencyMode(Shape3D, int, boolean) via a traverseShapes(Node, ShapeHandler) from root.

setTransparencyModeRecursively

public static void setTransparencyModeRecursively(javax.media.j3d.Node root,
                                  int transparencyMode)

Covers setTransparencyModeRecursively(Node, int, boolean), conses if not present.

setScreenDoorRecursively

public static void setScreenDoorRecursively(javax.media.j3d.Node root,
                            boolean iffPresent)

covers setTransparencyModeRecursively(Node, int, boolean)

setScreenDoorRecursively
```
public static void setScreenDoorRecursively(javax.media.j3d.Node root)
```
Covers setScreenDoorRecursively(Node, boolean), always conses.

setBlendedRecursively

public static void setBlendedRecursively(javax.media.j3d.Node root,
                         boolean iffPresent)

covers setTransparencyModeRecursively(Node, int, boolean)

setBlendedRecursively
```
public static void setBlendedRecursively(javax.media.j3d.Node root)
```
covers setBlendedRecursively(Node, boolean), always conses

setAlphaRecursively

public static void setAlphaRecursively(javax.media.j3d.Node root,
                       float alpha,
                       boolean iffPresent)

setAlpha(Shape3D, float, boolean) via a traverseShapes(Node, ShapeHandler) from root.

setAlphaRecursively

public static void setAlphaRecursively(javax.media.j3d.Node root,
                       float alpha)

Covers setAlphaRecursively(Node, float, boolean), conses if not present.

setIgnoreVertexColorsRecursively

public static void setIgnoreVertexColorsRecursively(javax.media.j3d.Node root,
                                    boolean ignore,
                                    boolean iffPresent)

setIgnoreVertexColors(Shape3D, boolean, boolean) via a traverseShapes(Node, ShapeHandler) from root.

setIgnoreVertexColorsRecursively

public static void setIgnoreVertexColorsRecursively(javax.media.j3d.Node root,
                                    boolean ignore)

Covers setIgnoreVertexColorsRecursively(Node, boolean, boolean), conses if not present.

setMaterialColorRecursively

public static void setMaterialColorRecursively(javax.media.j3d.Node root,
                               int which,
                               javax.vecmath.Color3f color,
                               boolean iffPresent)

setMaterialColor(javax.media.j3d.Material, int, javax.vecmath.Color3f) via a traverseShapes(Node, ShapeHandler).

setMaterialColorRecursively

public static void setMaterialColorRecursively(javax.media.j3d.Node root,
                               int which,
                               javax.vecmath.Color3f color)

Covers setMaterialColorRecursively(Node, int, Color3f, boolean), never conses if not present.

setMaterialColorRecursively

public static void setMaterialColorRecursively(javax.media.j3d.Node root,
                               int which,
                               float r,
                               float g,
                               float b)

covers setMaterialColorRecursively(Node, int, Color3f)

copyMaterialColorRecursively

public static void copyMaterialColorRecursively(javax.media.j3d.Node root,
                                int from,
                                int to)

copyMaterialColor(Shape3D, int, int) via a traverseShapes(Node, ShapeHandler).

addMaterialColorRecursively

public static void addMaterialColorRecursively(javax.media.j3d.Node root,
                               int from,
                               int to)

addMaterialColor(Shape3D, int, int) via a traverseShapes(Node, ShapeHandler).

dumpGraph

public static void dumpGraph(com.sun.j3d.loaders.Scene scene,
             java.io.PrintStream s)

calls dumpGraph(Group, PrintStream) on the scene group

dumpGraph

public static void dumpGraph(com.sun.j3d.loaders.Scene scene)

dumpGraph(Scene, PrintStream) to System.out

dumpGraph
```
public static void dumpGraph(javax.media.j3d.SceneGraphObject sgo,
             java.io.PrintStream s)
```
One-line dump of the type and name (if any) of a SceneGraphObject.

This serves as a baseline dump; more detailed dumps for particular subclasses are also provided.

Throws:

javax.media.j3d.CapabilityNotSetException - if the appropriate capabilities are not set and sgo is part of live or compiled scene graph

dumpGraph

public static void dumpGraph(javax.media.j3d.SceneGraphObject sgo)

dumpGraph(SceneGraphObject, PrintStream) to System.out

dumpGraph

protected static void dumpGraph(javax.media.j3d.SceneGraphObject sgo,
             java.lang.String prefix,
             java.lang.String qualifiers,
             java.io.PrintStream s,
             boolean withNewline)

Impl of dumpGraph(SceneGraphObject, PrintStream).

Parameters:: prefix - this is printed first; qualifiers - if non-null this is printed next, and then the class and toString(), if any, of sgo

dumpGraph
```
public static void dumpGraph(javax.media.j3d.Group g,
             java.io.PrintStream s)
```
Recursively dump Group g and all its children.

Throws:

javax.media.j3d.CapabilityNotSetException - if the appropriate capabilities are not set and g or any of its descendants is part of live or compiled scene graph

dumpGraph

public static void dumpGraph(javax.media.j3d.Group g)

dumpGraph(Group, PrintStream) to System.out

dumpGraph
```
protected static void dumpGraph(javax.media.j3d.Group g,
             java.lang.String prefix,
             java.lang.String qualifiers,
             java.util.Map<javax.media.j3d.SharedGroup,java.lang.Integer> sharedGroups,
             java.io.PrintStream s)
```
Impl of dumpGraph(Group, PrintStream).

Parameters:
sharedGroups - A map from encountered SharedGroups to unique integers identifying them. If null then this is considered a top-level call: the graph will be recursively dumped while collecting referenced shared groups in a newly consed map, and at the end the contents of this map will be dumped. If non-null then this is a recursive call: newly encountered shared groups are added to this map.

dumpGraph
```
public static void dumpGraph(javax.media.j3d.Link l,
             java.io.PrintStream s)
```
Specialized dump of a Link leaf.

Dumps the leaf and recursively dups its referenced SharedGroup if any.

Throws:

javax.media.j3d.CapabilityNotSetException - if the appropriate capabilities are not set and l or its ref are part of live or compiled scene graph

dumpGraph

public static void dumpGraph(javax.media.j3d.Link l)

dumpGraph(Link, PrintStream) to System.out

dumpGraph

protected static void dumpGraph(javax.media.j3d.Link l,
             java.lang.String prefix,
             java.lang.String qualifiers,
             java.util.Map<javax.media.j3d.SharedGroup,java.lang.Integer> sharedGroups,
             java.io.PrintStream s)

Impl of dumpGraph(Link, PrintStream), manages collection of sharedGroups.

Parameters:: sharedGroups - if non-null then the ref of this Link is resolved, or added if not found, here, and the ref is not recursively dumped. If null then the ref is recursively dumped.

dumpGraph
```
public static void dumpGraph(javax.media.j3d.Shape3D s3d,
             java.io.PrintStream s)
```
Specialized dump of a Shape3D leaf.

All geometries of the shape are dumped.

Throws:

javax.media.j3d.CapabilityNotSetException - if the appropriate capabilities are not set and s3d or any of its geometries are part of live or compiled scene graph

dumpGraph

public static void dumpGraph(javax.media.j3d.Shape3D s3d)

dumpGraph(Shape3D, PrintStream) to System.out

dumpGraph

protected static void dumpGraph(javax.media.j3d.Shape3D s3d,
             java.lang.String prefix,
             java.lang.String qualifiers,
             java.io.PrintStream s)

impl of dumpGraph(Shape3D, PrintStream)

dumpGraph
```
public static void dumpGraph(javax.media.j3d.Appearance a,
             java.io.PrintStream s)
```
Specialized dump of an appearance.

Throws:

javax.media.j3d.CapabilityNotSetException - if the appropriate capabilities are not set and g or is part of live or compiled scene graph

dumpGraph

public static void dumpGraph(javax.media.j3d.Appearance a)

dumpGraph(Appearance, PrintStream) to System.out

dumpGraph

protected static void dumpGraph(javax.media.j3d.Appearance a,
             java.lang.String prefix,
             java.lang.String qualifiers,
             java.io.PrintStream s)

impl of dumpGraph(Appearance, PrintStream)

dumpGraph
```
public static void dumpGraph(javax.media.j3d.Geometry g,
             java.io.PrintStream s)
```
Specialized dump of a geometry.

Also dumps vertex count and format, strip count, and total primitive count.

Throws:

javax.media.j3d.CapabilityNotSetException - if the appropriate capabilities are not set and g or is part of live or compiled scene graph

dumpGraph

public static void dumpGraph(javax.media.j3d.Geometry g)

dumpGraph(Geometry, PrintStream) to System.out

dumpGraph

protected static void dumpGraph(javax.media.j3d.Geometry g,
             java.lang.String prefix,
             java.lang.String qualifiers,
             java.io.PrintStream s)

impl of dumpGraph(Geometry, PrintStream)

getInfo
```
public static java.lang.String getInfo(javax.media.j3d.Geometry geometry)
```
Covers dumpGraph(Geometry, String, String, PrintStream), writes to String.

numPrims

public static int numPrims(javax.media.j3d.GeometryArray ga)

return the prim count of ga

dumpVertexFormat

public static void dumpVertexFormat(int vertexFormat,
                    java.io.PrintStream s)

dump a string describing a vertexFormat bitmap

dumpVertexFormat
```
public static void dumpVertexFormat(int vertexFormat)
```
dumpVertexFormat(int, PrintStream) to System.out

textVertexFormat
```
public static java.lang.String textVertexFormat(int vertexFormat)
```
covers dumpVertexFormat(int, java.io.PrintStream), writes to String

wordsPerVertex

public static int wordsPerVertex(int vertexFormat,
                 int texCoordSetCount)

get the number of 32-bit words per vertex

wordsPerVertex
```
public static int wordsPerVertex(int vertexFormat)
```
get the number of 32-bit words per vertex, no multitexturing

numTexCoords
```
public static int numTexCoords(int vertexFormat)
```
get the number of texture coords per vertex, no multitexturing

numColorComponents
```
public static int numColorComponents(int vertexFormat)
```
get the number of color components per vertex, no multitexturing

getComponentOffsets

public static int[] getComponentOffsets(int vertexFormat,
                        int[] offset)

get the start indices for each component of an interleaved vertex

getComponentOffsets
```
public static int[] getComponentOffsets(int vertexFormat)
```
getComponentOffsets(int, int[]), always cons

vertsPerPrim
```
public static int vertsPerPrim(javax.media.j3d.GeometryArray ga)
```
get number of vertices per primitive based on the type of ga

dumpBestType

public static void dumpBestType(javax.media.j3d.Transform3D t3d,
                java.io.PrintStream s)

dumpTransformType(int, java.io.PrintStream) best type of t3d

dumpBestType

public static void dumpBestType(javax.media.j3d.Transform3D t3d)

dumpBestType(Transform3D, PrintStream) to System.out

textBestType
```
public static java.lang.String textBestType(javax.media.j3d.Transform3D t3d)
```
covers dumpBestType(javax.media.j3d.Transform3D, java.io.PrintStream), writes to String

dumpTransformType

public static void dumpTransformType(int type,
                     java.io.PrintStream s)

dump a Transform3D transform type mask

dumpTransformType
```
public static void dumpTransformType(int type)
```
dumpTransformType(int, PrintStream) to System.out

textTransformType
```
public static java.lang.String textTransformType(int type)
```
covers dumpTransformType(int, java.io.PrintStream), writes to String

dump

public static void dump(javax.media.j3d.Transform3D t3d,
        java.io.PrintStream s)

dumpBestType(javax.media.j3d.Transform3D, java.io.PrintStream) and contents of t3d

dump

public static void dump(javax.media.j3d.Transform3D t3d)

dump(Transform3D, PrintStream) to System.out

hasJ3D
```
public static boolean hasJ3D()
```
defers to eponymous method in J3DVersion

hasJ3D14
```
public static boolean hasJ3D14()
```
defers to eponymous method in J3DVersion

hasJ3D15
```
public static boolean hasJ3D15()
```
defers to eponymous method in J3DVersion

getJ3DVersionMessage
```
public static java.lang.String getJ3DVersionMessage()
```
defers to eponymous method in J3DVersion

dumpJ3DProperties

public static void dumpJ3DProperties(javax.media.j3d.Canvas3D canvas3D,
                     java.io.PrintStream s)

dump Java3D system, and optionally a Canvas3D's, properties

dumpJ3DProperties
```
public static void dumpJ3DProperties(java.io.PrintStream s)
```
covers dumpJ3DProperties(Canvas3D, PrintStream), no canvas

dumpJ3DProperties

public static void dumpJ3DProperties(javax.media.j3d.Canvas3D canvas)

dumpJ3DProperties(Canvas3D, PrintStream), to System.out

dumpJ3DProperties
```
public static void dumpJ3DProperties()
```
dumpJ3DProperties(PrintStream) to System.out

getAllGDs

public static java.awt.GraphicsDevice[] getAllGDs()

get all available GraphicsDevices

getDefaultGD

public static java.awt.GraphicsDevice getDefaultGD()

get default GraphicsDevice

getGD

public static java.awt.GraphicsDevice getGD(java.awt.Container c)

get GraphicsDevice of a Container, or null if c not realized

makeGCTs
```
public static javax.media.j3d.GraphicsConfigTemplate3D[] makeGCTs(int[][] tryFormat,
                                                  int[] tryDepth,
                                                  int stencil,
                                                  int doubleBuffer,
                                                  int stereo,
                                                  int antialiasing,
                                                  boolean withFallback,
                                                  javax.media.j3d.GraphicsConfigTemplate3D[] gct)
```
Make a priority list of graphics config templates given ordered set of desired pixel formats and depth buffer widths.

The list is prioritized first by format and second by depth, with a total of nf*nd templates generated, plus one additional one if withFallback, where nf is the number of passed formats and nd is the number of passed depths.

Parameters:
tryFormat - an ordered list of pixel formats, each a triple of ints giving the desired minimum R, G, and B bitplane widths in that order, if null then use DEF_TRY_FORMAT
tryDepth - an ordered list of desired depth buffer widths, if null then use DEF_TRY_DEPTH
stencil - the desired stencil plane width
doubleBuffer - template status for double buffer
stereo - template status for stereo
antialiasing - template status for antialiasing
withFallback - whether to also append FALLBACK_GCT
gct - the generated templates are written here, if non-null and of sufficient length, else a new array is consed

Returns:
the array of generated templates

getBestGCT
```
public static javax.media.j3d.GraphicsConfigTemplate3D getBestGCT(java.awt.GraphicsDevice gd,
                                                  javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)
```
For each template in tryGCT, in order, attempt to get the best compatible graphics configuration for graphics device gd, and return the template corresponding to the first hit, if any, else null.

Parameters:
gd - the graphics device to use, or null to getDefaultGD()

getBestGCT

public static javax.media.j3d.GraphicsConfigTemplate3D getBestGCT(java.awt.GraphicsDevice gd)

Covers getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...) with DEF_TRY_GCT.

getBestGCT

public static javax.media.j3d.GraphicsConfigTemplate3D getBestGCT(java.awt.Container c,
                                                  javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)

Covers getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...) with graphics device of container c.

getBestGCT

public static javax.media.j3d.GraphicsConfigTemplate3D getBestGCT(java.awt.Container c)

Covers getBestGC(Container, GraphicsConfigTemplate3D...) with DEF_TRY_GCT.

getBestGCT

public static javax.media.j3d.GraphicsConfigTemplate3D getBestGCT(javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)

Covers getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...) with getDefaultGD().

getBestGCT
```
public static javax.media.j3d.GraphicsConfigTemplate3D getBestGCT()
```
Covers getBestGC(GraphicsConfigTemplate3D...) with DEF_TRY_GCT.

getBestGC
```
public static java.awt.GraphicsConfiguration getBestGC(java.awt.GraphicsDevice gd,
                                       javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)
```
For each template in tryGCT, in order, attempt to get the best compatible graphics configuration for graphics device gd, and return the first hit, if any, else null.

Parameters:
gd - the graphics device to use, or null to getDefaultGD()

getBestGC

public static java.awt.GraphicsConfiguration getBestGC(java.awt.GraphicsDevice gd)

Covers getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...) with DEF_TRY_GCT.

getBestGC

public static java.awt.GraphicsConfiguration getBestGC(java.awt.Container c,
                                       javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)

Covers getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...) with graphics device of container c.

getBestGC
```
public static java.awt.GraphicsConfiguration getBestGC(java.awt.Container c)
```
Covers getBestGC(Container, GraphicsConfigTemplate3D...) with DEF_TRY_GCT.

getBestGC

public static java.awt.GraphicsConfiguration getBestGC(javax.media.j3d.GraphicsConfigTemplate3D... tryGCT)

Covers getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...) with getDefaultGD().

getBestGC
```
public static java.awt.GraphicsConfiguration getBestGC()
```
Covers getBestGC(GraphicsDevice, GraphicsConfigTemplate3D...) with getDefaultGD() and DEF_TRY_GCT.

makeRGBImageComponent2D

public static javax.media.j3d.ImageComponent2D makeRGBImageComponent2D(int width,
                                                       int height)

make RGB image component with a byRef yUp BufferedImage

makeImageRaster

public static javax.media.j3d.Raster makeImageRaster(javax.media.j3d.ImageComponent2D imageComponent)

make a color image raster around an imageComponent

makeImageRaster

public static javax.media.j3d.Raster makeImageRaster(int width,
                                     int height)

Calls makeImageRaster(ImageComponent2D) with an image component from makeRGBImageComponent2D(int, int).

saveRGBImage
```
public static void saveRGBImage(javax.media.j3d.ImageComponent2D imageComponent,
                java.io.File file,
                java.lang.String format)
                         throws java.io.IOException
```
Save the BufferedImage from imageComponent to file in the given format.

Parameters:
imageComponent - the image to save
file - the destination file
format - string identifying the image format to write, as per ImageIO.getImageWritersBySuffix(), or null to use the filename extension of file

Throws:

java.io.IOException - if file exists, if format is null and file has no filename extension, or if there was an error writing file

saveRGBImage

public static void saveRGBImage(javax.media.j3d.Raster raster,
                java.io.File file,
                java.lang.String format)
                         throws java.io.IOException

covers saveRGBImage(ImageComponent2D, File, String)

Throws:: java.io.IOException

getFloatBuffer

public static java.nio.FloatBuffer getFloatBuffer(javax.media.j3d.J3DBuffer j3dBuf)

Dereference the contained NIO buffer in j3dBuf as a FloatBuffer.

makeFloatBuffer

public static java.nio.FloatBuffer makeFloatBuffer(int numFloats)

make a new direct native byte order float buffer

makeIntBuffer

public static java.nio.IntBuffer makeIntBuffer(int numInts)

make a new direct native byte order int buffer

resizeBuffer
```
public static java.nio.FloatBuffer resizeBuffer(java.nio.FloatBuffer buffer,
                                int newSize)
```
Returns a buffer of newSize floats initialized to the contents of buffer.

If newSize is less than the limit of buffer then only the first newSize floats are copied; if newSize is greater than the limit of buffer then only that many floats are copied.

In the case that newSize equals the capacity of buffer then the return value may be buffer itself.

resizeBuffer

public static java.nio.IntBuffer resizeBuffer(java.nio.IntBuffer buffer,
                              int newSize)

similar to resizeBuffer(FloatBuffer, int)

setLightWeightPopupEnabled
```
public static void setLightWeightPopupEnabled(boolean enable)
```
enable/disable Swing lightweight menu and tooltip popups

setPreferredPipeline
```
public static boolean setPreferredPipeline(java.lang.String preferredPipeline)
```
Set the system property Java3D considers when choosing a pipeline.

This is probably only useful if you call it before calling other Java3D APIs. For example, just consing a VirtualUniverse or adding a Geometry to a non-live Shape3D can cause Java3D to try to init its pipeline.

Note that if the JOGL pipeline is selected and loaded then the current implementation of Java3D will disable JOGL single threading. If that is not desired, see restoreJOGLSingleThreading().

Parameters:
preferredPipeline - the preferred pipeline, one of "jogl", "d3d", "ogl", or "noop"

Throws:

AccessControlException - if there is a security manager that won't let us set a system property

restoreJOGLSingleThreading
```
public static boolean restoreJOGLSingleThreading()
```
See setPreferredPipeline(java.lang.String).

Throws:

AccessControlException - if there is a security manager that won't let us do what we need

main
```
public static void main(java.lang.String[] arg)
```
dumpJ3DProperties(javax.media.j3d.Canvas3D, java.io.PrintStream) iff hasJ3D()

Class J3DUtils

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

cvsid

J3D_VRML97_LOADER_CLASS

J3D_3DS_LOADER_CLASS

BLACK_3F

WHITE_3F

GRAY_3F

RED_3F

GREEN_3F

BLUE_3F

ORIGIN_3F

ORIGIN_3D

BOUNDS_ALL

DEF_TRY_FORMAT

DEF_TRY_DEPTH

DEF_STENCIL

DEF_DOUBLE_BUFFER

DEF_STEREO

DEF_ANTI_ALIASING

FALLBACK_GCT

DEF_TRY_GCT

Constructor Detail

J3DUtils

Method Detail

load

load

load

load

load

load

makeLoaderForFormat

getName

setTwoSided

setTwoSided

setUnlitColor

setUnlitColor

setShadeModel

setShadeModel

setTransparencyMode

setTransparencyMode

setAlpha

setAlpha

setLineWidth

setLineWidth

setIgnoreVertexColors

setIgnoreVertexColors

setColorTarget

setColorTarget

setColorTarget

getMaterialColor

getMaterialColor

getMaterialColor

getMaterialColor

getMaterialColor

getMaterialColor

setMaterialColor

setMaterialColor

setMaterialColor

copyMaterialColor

copyMaterialColor

copyMaterialColor

addMaterialColor

addMaterialColor

addMaterialColor

traverseShapes

traverseShapes

traverseShapes

setTwoSidedRecursively

setTwoSidedRecursively

setUnlitColorRecursively

setUnlitColorRecursively

setUnlitColorRecursively

setShadeModelRecursively

setShadeModelRecursively