Display3D

java.lang.Object
- vona.ui.Display3D

Direct Known Subclasses:

J3DDisplay, JOGLDisplay
```
@ThreadSafe
public abstract class Display3D
extends java.lang.Object
```
Base class for a 3D display.

Current implementation provides:
- one canvas
- orthogonal projection
- monoscopic rendering
- monochrome background
- one ambient and one directional light
- right-handed view frame with X right and Y up, origin aligned to the center of the canvas
An implementation may optionally choose to use some or all of the included generic render()er. Minimally, the implementation would override renderScene() to do the desired drawing, and then call render() in a loop, possibly with some throttling. Actual drawing code is left abstract; J3DDisplay and JOGLDisplay implement back-ends via the respective libraries.

The generic renderer provides the following features:
- A local-to-world rigid transform, for defining model coordinate frames. See setLocalToWorld(vona.math.RX, boolean) and related APIs.
- A world-to-view rigid transform and scale, for implementing viewpoint navigation. See updateWorldToView(boolean) and related APIs. This transform is used to implement spin/pan/zoom "object manipulation"-style viewpoint navigation via rxsInteractor when navigationEnabled.
- Frustum cull, iff frustumCullEnabled, for geometries with specified bounding spheres.
- Depth sort transparent geometry, iff depthSortTransparentEnabled, for geometries with specified bounding spheres.
- Emissive highlighting on a per-geometry basis, iff highlightingEnabled
- Alpha masking on a per-geometry basis, iff maskingEnabled
- Scene metrics collection, including sceneAABBInView, numVisibleGeometries, numTransparentGeometries, numHighlightedGeometries, numMaskedGeometries, numSceneGeometries, numPickableGeometries, numSceneWidgets, and numDisabledWidgetGeometries. The first three are computed only for geometries for which bounding spheres are specified. Set dbgSceneExtentsEnabled to visualize the corresponding view frame XY scene bounds rect.
- Render metrics collection, including numFrames, frameTime, recentFrameTime and recentCycleTime.
Picking

The pickSphereInView(float[], float[], float[], float, boolean) and pickGeometry(...) APIs provide low-level picking functionality that can be used independent of the renderer. Pick hits are reported to the picked(javax.media.j3d.Geometry, javax.media.j3d.Appearance, int, float) callback. If pickingEnabled is set then the generic renderer also automatically performs picking (using those APIs) whenever isPickSegmentSet(), further modified by pickBoundsOnly and pickVisibleBoundsOnly.

Synchronization Policies

This class is designed to be thread-safe:
- drawingEnabled and other state flags affecting render() are volatile and expected to be independent
- localToWorldRX, transparentQueue, and related are expected to be thread confined, i.e., if they are used then it is expected they will be accessed from only one thread, which effectively also means that the generic render() will be called only from that thread
- subclass implmentations must implement guards for their implementations of the background color and light parameter mutators
- canvasSize and related projection state are guarded by projectionLock
- worldToViewRX and related navigation state are guarded by rxsInteractor
- sceneAABBInView and related scene metrics are guareded by sceneMetricsLock
- numFrames and related render metrics are guarded by renderMetricsLock
The lock acquisition order for deadlock avoidance is
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
`protected class`	`Display3D.Driver` an interactive test driver
`protected class`	`Display3D.QueuedGeometry` Collects info to render a geometry.

Field Summary

Fields
Modifier and Type	Field and Description
`protected TimeMetrics`	`accumPass1Metrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`accumPass2Metrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected static boolean[]`	`ALL_COMPONENTS` component enables for vertex accessors and primitive iterators
`protected java.util.List<TimeMetrics>`	`allExtendedRenderMetrics` all extended render metrics
`protected float`	`ambientAlpha` Ambient alpha.
`protected boolean`	`applyProjectionPending` whether a `applyProjection()` is pending
`protected TimeMetrics`	`applyWidgetRX` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected int`	`blueBits` number of bits in the specified canvas component
`protected java.awt.Canvas`	`canvas` the canvas
`protected java.lang.Object`	`canvasMouseLock` synchronization object for canvas mouse location
`protected int`	`canvasMouseX` Most recent mouse location on canvas in canvas coords or negative if mouse not on canvas.
`protected int`	`canvasMouseY` Most recent mouse location on canvas in canvas coords or negative if mouse not on canvas.
`protected float[]`	`canvasSize` current cached size of `canvas` in pixels
`protected TimeMetrics`	`clearMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected RX`	`cmtRX` current rigid part of the local-to-view composite model transform.
`protected float`	`cmtScale` Current scale part of the local-to-view composite model transform.
`protected static boolean[]`	`COORD_ONLY` component enables for vertex accessors and primitive iterators
`private static java.lang.String`	`cvsid`
`protected javax.media.j3d.Appearance`	`dbgAppearance` Appearance for dbg objects.
`protected boolean`	`dbgSceneExtentsEnabled` whether to enable dbg scene extents
`protected RectangleWidget`	`dbgSceneExtentsRect` widget for displaying dbg scene extents
`static float`	`DEF_AMBIENT_LIGHT_INTENSITY` default ambient light intensity
`static float[]`	`DEF_DIRECTIONAL_LIGHT_DIRECTION` default directional light direction
`static float`	`DEF_DIRECTIONAL_LIGHT_INTENSITY` default directional light intensity
`static float[]`	`DEF_HIGHLIGHT_COLOR` default `highlightColor`
`static float`	`DEF_HIGHLIGHT_FACTOR` default `highlightFactor`
`static float`	`DEF_MASK_ALPHA` default `maskAlpha`
`static float`	`DEF_PICK_THRESHOLD_PIXELS` default `pickThresholdPixels`
`static double`	`DEF_VIEW_SCALE` default `defaultViewScale`
`static float`	`DEF_Z_CLIP` default symmetric z clip, see `setSymmetricZClip(float)`
`protected javax.media.j3d.Appearance`	`defaultHighlightedAppearance` used by `renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)`
`protected javax.media.j3d.Material`	`defaultHighlightedMaterial` used by `renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)`
`protected double[]`	`defaultRotationCenter` Current default rotation center, used by `getDefaultRotationCenter()`.
`protected javax.media.j3d.Appearance`	`defaultTransparentAppearance` Default transparent appearance.
`protected double`	`defaultViewScale` Current default world-to-view scale, used by `getDefaultViewScale()`.
`protected double[]`	`defaultViewTXEM` Current default world-to-view TXEM, used by `getDefaultViewTXEM()`.
`protected int`	`depthBits` number of bits in the specified canvas component
`protected javax.media.j3d.Appearance`	`depthOnlyAppearance` Depth-only appearance.
`protected boolean`	`depthRenderMaskedQueueEnabled` enable for indicated feature in generic `render()` code
`protected boolean`	`depthSortTransparentEnabled` enable for indicated feature in generic `render()` code
`protected boolean`	`drawingEnabled` enable for indicated feature in generic `render()` code
`protected java.io.PrintStream`	`dumpRenderMetricsPending` see `dumpRenderMetrics(PrintStream)`
`protected java.io.PrintStream`	`dumpSceneMetricsPending` see `dumpSceneMetrics(PrintStream)`
`protected javax.vecmath.Color3f`	`emissiveColorWas` used by `renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)`
`protected boolean`	`ENABLE_EXTENDED_RENDER_METRICS` whether to enable extended render metrics (compile time constant)
`protected boolean`	`ensureWidgetBoundingSpheresInViewEnabled` Whether `render(Widget, RX)` calls `Widget.ensureBoundingSpheresInView()`.
`protected java.lang.Object`	`environmentLock` lock for bg, light, and highlight params
`protected boolean`	`fitPending` whether a `doFit()` is pending
`protected int`	`frameSaveCount` total count of frames saved in current sequence, including errors
`protected java.io.File`	`frameSaveDirectory` frame save destination directory or null for current dir
`protected double`	`frameSaveFPS` maximum rate for regular frame save.
`protected double`	`frameSaveLastTime` last frame save wall-clock time in seconds, if any, else NaN
`protected java.lang.Object`	`frameSaveLock` lock object for frame save state
`protected TimeMetrics`	`frameSaveMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected int`	`frameSaveNextIndex` next index for regular-rate frame save
`protected double`	`frameSaveNextTime` next frame save wall-clock time in seconds, if any, else NaN
`protected java.lang.String`	`frameSavePrefix` frame save filename prefix or null for none
`protected double`	`frameSaveStartTime` Regular-rate frame save sequence start time in wall-clock time in seconds, if any, else NaN.
`boolean`	`frameSaveWithCursor` Whether to include the cursor in frame saves.
`protected double[]`	`frameTime` Min and max generic `render()` time [s] since last `resetRenderMetrics()`.
`protected boolean`	`freezeSceneMetrics` Whether to short circuit in `addToSceneMetrics(float[], float, boolean, boolean, boolean, boolean, boolean)`.
`protected boolean`	`freezeTransparentQueue` Whether to short circuit in `enqueueTransparentGeometry(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance, float, float)`.
`protected boolean`	`freezeWidgetBounds` Whether to skip updating `Widget` bounds in view `render(Widget, RX)`.
`protected boolean`	`frustumCullEnabled` enable for indicated feature in generic `render()` code
`protected int`	`greenBits` number of bits in the specified canvas component
`protected float[]`	`highlightColor` highlight modulation color, see `highlightFactor`
`protected float`	`highlightFactor` This is the multiplicative factor by which `renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)` increases the emissive color of highlighted geometry, modulated by `highlightColor`.
`protected boolean`	`highlightingEnabled` enable for indicated feature in generic `render()` code
`protected J3DIndexAccessor[]`	`indexAccessors` Set of available index accessors, consed lazily.
`protected double`	`lastFrameEndTime` end time [s] of previous generic `render()`, NaN if none
`static int`	`LOCAL_TO_WORLD_STACK_INITIAL_CAPACITY` defailt initial capacity of `localToWorldStack`
`protected RX`	`localToWorldRX` Local-to-world `RX`.
`protected RX[]`	`localToWorldStack` Stack for saving `localToWorldRX`.
`protected int`	`localToWorldStackSize` Current number of transforms saved in `localToWorldStack`.
`protected float`	`longFrameWarningThreshold` Iif non-NaN this is the threshold in ms above which a warning will be issued for long frame render times.
`protected float`	`maskAlpha` alpha factor for masked geometry
`protected Display3D.QueuedGeometry[]`	`maskedQueue` Queue for masked geometry.
`protected int`	`maskedQueueSize` Current number of objects in `maskedQueue`
`protected boolean`	`maskingEnabled` enable for indicated feature in generic `render()` code
`static int`	`MAX` index of component in a two-element extents vector
`static int`	`MIN` index of component in a two-element extents vector
`protected boolean`	`navigationEnabled` enable for indicated feature in generic `render()` code
`protected javax.vecmath.Color3f`	`newEmissiveColor` used by `renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)`
`static int`	`NUM_RECENT_METRICS` length of `recentFrameTime` and `recentCycleTime`
`protected int`	`numDisabledWidgetGeometries` Total number of disabled `Widget` geometries seen by generic `render(Widget, RX)` since last `resetSceneMetrics(boolean)`.
`protected int`	`numFrames` Total num generic `render()` calls since last `resetRenderMetrics()`.
`protected int`	`numHighlightedGeometries` Total number of visible (not frustum cull) geometries rendered as highlighted by generic `render(Geometry, Appearance, float[], float)` since last `resetSceneMetrics(boolean)`.
`protected int`	`numMaskedGeometries` Total number of visible (not frustum cull) geometries rendered as masked by generic `render(Geometry, Appearance, float[], float)` since last `resetSceneMetrics(boolean)`.
`protected int`	`numPickableGeometries` Total number of visible pickable geometries iff `pickingEnabled` since last `resetSceneMetrics(boolean)`.
`protected int`	`numPickBoundsHits` Total number of geometries picked by bounds in generic render since last `resetSceneMetrics(boolean)` on a frame with picking (or if `resetPickMetricsEveryRender`).
`protected int`	`numPickedGeometries` Total number of geometries picked either by bounds only or by geometry since last `resetSceneMetrics(boolean)` on a frame with picking (or if `resetPickMetricsEveryRender`).
`protected int`	`numPickGeometryHits` Total number of geometries with at least one pick hit in `pickGeometry(Geometry, Appearance, J3DPrimitiveIterator, float[], float[], float, int)` since last `resetSceneMetrics(boolean)` on a frame with picking (or if `resetPickMetricsEveryRender`).
`protected int`	`numSamples` number antialiasing samples
`protected int`	`numSceneGeometries` Total number of geometries (including those that would be frustum culled) seen by generic `render(Geometry, Appearance, float[], float)` since last `resetSceneMetrics(boolean)`.
`protected int`	`numSceneWidgets` Total number of `Widget`s (including those with zero enabled geometries, and those that would be frustum culled) seen by generic `render(Widget, RX)` since last `resetSceneMetrics(boolean)`.
`protected int`	`numTransparentGeometries` Total number of visible (not frustum cull) geometries rendered as transparent by generic `render(Geometry, Appearance, float[], float)` since last `resetSceneMetrics(boolean)`.
`protected int`	`numVisibleGeometries` Total number of visible (not frustum cull) geometries seen by generic `render(Geometry, Appearance, float[], float)` since last `resetSceneMetrics(boolean)`.
`protected float`	`passAlpha` Alpha factor for current rendering pass.
`protected boolean`	`pickBoundsOnly` whether picking should be done only on bounding spheres
`protected float[]`	`pickExtentInLocal` Extent of the pick segment in local frame, or NaN if un-set.
`protected float[]`	`pickExtentInView` Extent of the pick segment in view frame, or NaN if un-set.
`protected TimeMetrics`	`pickGeometryMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected boolean`	`pickingEnabled` enable for indicated feature in generic `render()` code
`protected boolean`	`pickSegmentInLocalDirty` Dirty flag for `pickStartInLocal` and `pickExtentInLocal`.
`protected boolean`	`pickSegmentIntersectionsOnly` Whether picks should only be reported for pick intersections that actually lie on the pick segment defined by `pickStartInView`, `pickExtentInView`.
`protected boolean`	`pickSegmentInViewPerpCanvas` whether the pick segment in view frame is perpendicular to the canvas
`protected java.lang.Object`	`pickSegmentLock` lock object for pick segment state
`protected float[]`	`pickStartInLocal` Start point of the pick segment in local frame, or NaN if un-set.
`protected float[]`	`pickStartInView` Start point of the pick segment in view frame, or NaN if un-set.
`protected float`	`pickThresholdPixels` Pick threshold in canvas pixels.
`protected boolean`	`pickVisibleBoundsOnly` whether picking should be done only on non-culled geometry
`protected TimeMetrics`	`postRenderMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected javax.vecmath.Color3f`	`premultipliedHighlightColor` used by `renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)`
`protected boolean`	`premultiplyPassAlpha` Whether the default renderer will use the extraAlpha `draw(...)` parameter to implement `passAlpha`.
`protected TimeMetrics`	`preRenderMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected J3DPrimitiveIterator[]`	`primitiveIterators` Set of available primitive iterators, consed lazily.
`protected java.lang.Object`	`projectionLock` synchronization lock for projection state
`static int`	`QUEUE_INITIAL_CAPACITY` defailt initial capacity of the queues
`protected double[]`	`recentCycleTime` Cycle time [s] for up to `NUM_RECENT_METRICS` most recent generic `render()` frames.
`protected int`	`recentCycleTimeWriteIndex` next write index in `recentCycleTime`
`protected double[]`	`recentFrameTime` Rendering time [s] for up to `NUM_RECENT_METRICS` most recent generic `render()` frames.
`protected int`	`recentFrameTimeWriteIndex` next write index in `recentFrameTime`
`protected int`	`redBits` number of bits in the specified canvas component
`protected TimeMetrics`	`renderDepthOnlyMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderDepthOnlyQueueMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderGeometryMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderHighlightedMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderImplPostSceneMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderImplPreSceneMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderInViewMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected boolean`	`renderMaskedGeometry` Whether to render masked geometry in the current pass.
`protected java.lang.Object`	`renderMetricsLock` synchronization lock for render metrics
`protected TimeMetrics`	`renderSceneMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderTransparentMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderTransparentQueue1Metrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderTransparentQueue2Metrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderWidgetGeometryMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`renderWidgetMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected boolean`	`resetPickMetricsEveryRender` Whether to reset pick metrics at the beginning of every frame or just at the beginning of frames for pick will be performed.
`protected boolean`	`resetRenderMetricsPending` see `resetRenderMetrics()`
`RXSInteractor`	`rxsInteractor` The interactor.
`RXSInterpolator`	`rxsInterpolator` the `RXSInterpolator` in `rxsInteractor`
`protected float[][]`	`sceneAABBInView` AABB of enclosing union of bounding spheres (including those that would be frustum culled) seen by generic `render(Geometry, Appearance, float[], float)` since last `resetSceneMetrics(boolean)`.
`protected java.lang.Object`	`sceneMetricsLock` synchronization lock for scene metrics
`static float`	`SCREEN_METERS_PER_PIXEL` physical screen resolution
`static float`	`SQRT3F` square root of 3.0f
`protected int`	`stencilBits` number of bits in the specified canvas component
`protected TimeMetrics`	`swapMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`static int`	`TRACE_GENERIC_EN` trace flags
`static int`	`TRACE_PICKING_EN` trace flags
`protected int`	`traceFlags` trace flags for generic `render()`
`protected java.io.PrintStream`	`traceStream` trace stream for generic `render()`
`protected TimeMetrics`	`transformWidgetBounds` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected Display3D.QueuedGeometry[]`	`transparentQueue` Queue for depth sort transparency.
`protected int`	`transparentQueueSize` Current number of objects in `transparentQueue`
`protected boolean`	`unsetPickSegmentAfterRender` Whether to automatically un-set the pick segment on the given event.
`protected boolean`	`unsetPickSegmentOnProjectionChange` Whether to automatically un-set the pick segment on the given event.
`protected boolean`	`unsetPickSegmentOnWorldToViewChange` Whether to automatically un-set the pick segment on the given event.
`protected TimeMetrics`	`updateNavMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected TimeMetrics`	`updateProjectionMetrics` Extended render metrics, iff compiled with `ENABLE_EXTENDED_RENDER_METRICS`.
`protected J3DVertexAccessor[]`	`vertexAccessors` Set of available vertex accessors, consed lazily.
`protected float[][]`	`viewAABB` view volume AABB in view frame
`protected float`	`viewToCanvasScale` current view-to-canvas scale
`protected RX`	`worldToViewRX` world-to-view `RX`
`protected RX`	`worldToViewRXTemp` temporary world-to-view `RX`
`protected float`	`worldToViewScale` world-to-view scale, updated by `updateWorldToView(boolean)`

Constructor Summary

Constructors
Constructor and Description

Display3D()
make a new Display3D

Constructors
Constructor and Description
`Display3D()` make a new Display3D

Method Summary

Methods
Modifier and Type	Method and Description
`protected void`	`accumPass()` Hook called from generic `render()` to accumulate a rendering pass.
`protected void`	`addCanvasListeners()` Adds all necessary event listeners to `canvas`.
`protected void`	`addToSceneMetrics(float[] boundingSphereCenterInView, float boundingSphereRadiusInView, boolean culled, boolean transparent, boolean highlighted, boolean masked, boolean pickable)` Add the information for a geometry to the scene metrics.
`protected abstract void`	`applyCMT()` Subclasses must implement this to engage `cmtRX` and `cmtScale` so that they are applied to subsequent drawing.
`protected abstract void`	`applyProjection()` Subclasses must implement this to engage `viewAABB` so that it is applied to subsequent drawing.
`protected boolean`	`autoAddListenersToRXSInteractor()` Whether to call `RXSInteractor.addListeners(java.awt.Component)` on `rxsInteractor` in `addCanvasListeners()`.
`protected float[]`	`canvasToLocal(float... point)` Applies projection^{-1} and cmt^{-1} transforms.
`protected float`	`canvasToLocal(float length)` Applies projection^{-1} and cmt^{-1} transforms.
`float[]`	`canvasToView(float... point)` Transform a point in canvas frame to view frame by applying the projection transform.
`float`	`canvasToView(float length)` applies the projection transform
`protected void`	`clearCMT()` Set `cmtRX` and `cmtScale` to identity, then `applyCMT()`.
`protected abstract void`	`clearDrawingBuffer()` subclasses must implement this to clear the render buffer
`protected boolean`	`clearLocalToWorld()` `clearLocalToWorld(boolean)` not alwaysUpdate
`protected boolean`	`clearLocalToWorld(boolean alwaysUpdate)` Set identity `localToWorldRX`, then `updateCMT()` iff changed or alwaysUpdate.
`protected void`	`clearQueue(Display3D.QueuedGeometry[] queue, int queueSize)` clears the geometry and appearance refs in a queue
`protected int`	`compareQueued(Display3D.QueuedGeometry a, Display3D.QueuedGeometry b)` Implementation of `Display3D.QueuedGeometry.compareTo(vona.ui.Display3D.QueuedGeometry)`.
`void`	`disableLongFrameWarningThreshold()` Disable the long-frame warning threshold, see `setLongFrameWarningThreshold(float)`.
`protected void`	`doFit()` Calls `RXSInteractor.fit(double, double, double, double)` on the curent `sceneAABBInView`.
`protected void`	`draw(javax.media.j3d.Geometry geometry)` Covers `draw(RX, float, Geometry, Appearance, float)`.
`protected void`	`draw(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Covers `draw(RX, float, Geometry, Appearance, float)`.
`protected void`	`draw(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float extraAlpha)` covers `draw(RX, float, Geometry, Appearance, float)`
`protected void`	`draw(javax.media.j3d.Geometry geometry, float extraAlpha)` covers `draw(RX, float, Geometry, Appearance, float)`
`protected void`	`draw(RX cmtRX, float cmtScale, javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Covers `draw(RX, float, Geometry, Appearance, float)`.
`protected abstract void`	`draw(RX cmtRX, float cmtScale, javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float extraAlpha)` Concrete subclasses must implement this to draw geometry.
`void`	`dump()` `dump(PrintStream)` to System.out
`void`	`dump(java.io.PrintStream s)` dump everything
`protected void`	`dumpAABB(float[][] aabb, java.lang.String msg, java.io.PrintStream s)` dump the coords of an axis aligned bounding box
`void`	`dumpCanvasProperties()` `dumpCanvasProperties(PrintStream)` to System.out
`void`	`dumpCanvasProperties(java.io.PrintStream s)` dumps properties of `canvas`
`void`	`dumpCMT()` `dumpCMT(PrintStream)` to System.out
`void`	`dumpCMT(java.io.PrintStream s)` Dumps the current composite model transform taking local coordinates to view coordinates.
`void`	`dumpHelp()` `dumpHelp(PrintStream, String)` to System.out using "meters"
`void`	`dumpHelp(java.io.PrintStream s)` `dumpHelp(PrintStream, String)` using "meters"
`void`	`dumpHelp(java.io.PrintStream s, java.lang.String meters)` `RXSInteractor.dumpHelp(PrintStream, String, String, String, String, String, String)`.
`void`	`dumpHelp(java.lang.String meters)` `dumpHelp(PrintStream, String)` to System.out
`void`	`dumpInteractor()` `dumpInteractor(PrintStream)` to System.out
`void`	`dumpInteractor(java.io.PrintStream s)` dumps `rxsInteractor` and its `RXSInterpolator`
`protected void`	`dumpLocalToWorld()` `dumpLocalToWorld(PrintStream)` to System.out
`protected void`	`dumpLocalToWorld(java.io.PrintStream s)` Dump the current local-to-world transform.
`protected boolean`	`dumpPendingMetrics()` Dump any metrics that need it.
`void`	`dumpPickSegment()` `dumpPickSegment(PrintStream)` to System.out
`void`	`dumpPickSegment(java.io.PrintStream s)` dump pick segment in view
`void`	`dumpProjection()` `dumpProjection(PrintStream)` to System.out
`void`	`dumpProjection(java.io.PrintStream s)` dump the current projection parameters
`void`	`dumpRenderMetrics()` `dumpRenderMetrics(PrintStream)` to System.out
`void`	`dumpRenderMetrics(java.io.PrintStream s)` Dumps the `FrameTime` fields and related.
`protected void`	`dumpRenderMetricsImpl(java.io.PrintStream s)` Impl of `dumpRenderMetrics(java.io.PrintStream)`, run at end of generic render when `dumpRenderMetricsPending` is set.
`void`	`dumpSceneMetrics()` `dumpSceneMetrics(PrintStream)` to System.out
`void`	`dumpSceneMetrics(java.io.PrintStream s)` Dumps scene metrics.
`protected void`	`dumpSceneMetricsImpl(java.io.PrintStream s)` Impl of `dumpSceneMetrics(java.io.PrintStream)`, run at end of generic render when `dumpSceneMetricsPending` is set.
`void`	`dumpStats()` `dumpStats(PrintStream)` to System.out
`void`	`dumpStats(java.io.PrintStream s)` `dumpSceneMetrics(java.io.PrintStream)`, `dumpRenderMetrics(java.io.PrintStream)`
`void`	`dumpWorldToView()` `dumpWorldToView(PrintStream)` to System.out
`void`	`dumpWorldToView(java.io.PrintStream s)` dumps the current world-to-view transform
`void`	`enableDBGSceneExtents(boolean enable)` set `dbgSceneExtentsEnabled`
`void`	`enableDepthSortTransparent(boolean enable)` set `enableDepthSortTransparent(boolean)`
`void`	`enableDrawing(boolean enable)` set `enableDrawing(boolean)`
`void`	`enableEnsureWidgetBoundingSpheresInView(boolean enable)` set `ensureWidgetBoundingSpheresInViewEnabled`
`void`	`enableFrustumCull(boolean enable)` set `enableFrustumCull(boolean)`
`void`	`enableHighlighting(boolean enable)` set `enableHighlighting(boolean)`
`void`	`enableMasking(boolean enable)` set `enableMasking(boolean)`
`void`	`enableNavigation(boolean enable)` set `navigationEnabled`
`void`	`enablePicking(boolean enable)` set `enablePicking(boolean)`
`protected Display3D.QueuedGeometry[]`	`enqueue(RX cmtRX, float cmtScale, javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float maxViewZ, float ambientAlpha, Display3D.QueuedGeometry[] queue, int queueSize)` Implmentation of `enqueueTransparentGeometry(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance, float, float)` and `enqueueMaskedGeometry(javax.media.j3d.Geometry, javax.media.j3d.Appearance, float)`.
`protected void`	`enqueueMaskedGeometry(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float maxViewZ)` Add an item to the `maskedQueue`.
`protected void`	`enqueueTransparentGeometry(RX cmtRX, float cmtScale, javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float maxViewZ, float ambientAlpha)` Add an item to the `transparentQueue`, unless `freezeTransparentQueue` is set.
`protected void`	`ensureDBGAppearance()` makes sure that `dbgAppearance` has been consed
`void`	`fitView()` Request a `doFit()`.
`protected int`	`getAllRenderTraceFlags()` Hook to get combination of all trace flags that apply to the render algorithm.
`float`	`getAmbientAlpha()` get `ambientAlpha`
`double`	`getAvgRecentFPS()` Get the avg recent FPS according to the `recentCycleTime` metrics, which are maintained by the generic `render()`er.
`int`	`getBlueBits()` get the bit width of the blue buffer
`java.awt.Canvas`	`getCanvas()` get `canvas`, thread safe
`java.awt.Point`	`getCanvasMouseLocation()` `getCanvasMouseLocation(Point)`, conses
`java.awt.Point`	`getCanvasMouseLocation(java.awt.Point point)` Get the most recent mouse location on canvas in canvas coords.
`double[]`	`getDefaultRotationCenter()` Get the default rotation center in world frame, defaul impl returns `defaultRotationCenter`.
`double`	`getDefaultViewScale()` Get default world-to-view scale, used by `navigateToDefaultView(boolean, boolean)`, default impl returns `defaultViewScale` if not NaN, else `DEF_VIEW_SCALE`.
`double[]`	`getDefaultViewTXEM()` Get the default world-to-view TXEM vector.
`int`	`getDepthBits()` get the bit width of the depth buffer
`int`	`getGreenBits()` get the bit width of the green buffer
`float[]`	`getHighlightColor()` covers `getHighlightColor(float[])`, always conses
`float[]`	`getHighlightColor(float[] color)` get `highlightColor`
`float`	`getHighlightFactor()` get `highlightFactor`
`protected J3DIndexAccessor`	`getIndexAccessorFor(javax.media.j3d.Geometry g)` Get an index accessor for a geometry.
`protected java.lang.String`	`getInfo(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Get an identifying string for geometry and appearance for use in tracing and dbg.
`protected RX`	`getLocalTranslationRXToPixel()` `getLocalTranslationRXToPixel(Point, RX)`, uses current mouse position or (0, 0) if mouse not on canvas, conses.
`protected RX`	`getLocalTranslationRXToPixel(java.awt.Point pixel)` `getLocalTranslationRXToPixel(Point, RX)`, conses
`protected RX`	`getLocalTranslationRXToPixel(java.awt.Point pixel, RX ret)` `getTranslationRXToPixel(RX, Point)` using the current `localToWorldRX`.
`protected RX`	`getLocalTranslationRXToPixel(RX ret)` `getLocalTranslationRXToPixel(Point, RX)`, uses current mouse position or (0, 0) if mouse not on canvas.
`float`	`getMaskAlpha()` get `maskAlpha`
`int`	`getNumFrames()` get `numFrames`
`int`	`getNumFramesSaved()` Get the total number of frames saved in the current or previous regular-rate save sequence.
`int`	`getNumSamples()` get the number of antialiasing samples
`protected int`	`getPickCullFace(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Hook called by the smaller `pickGeometry(...)` APIs to get the pick cull face for the given geometry.
`protected float`	`getPickThreshold(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Hook called by the smaller `pickGeometry(...)` APIs to get the pick threshold for the given geometry in local frame.
`float`	`getPickThresholdPixels()` get `pickThresholdPixels`
`protected J3DPrimitiveIterator`	`getPrimitiveIteratorFor(javax.media.j3d.Geometry g)` Covers `getPrimitiveIteratorFor(Geometry, boolean...)`, enables all components.
`protected J3DPrimitiveIterator`	`getPrimitiveIteratorFor(javax.media.j3d.Geometry g, boolean... enableComponent)` Get a primitive iterator for a geometry.
`int`	`getRedBits()` get the bit width of the red buffer
`int`	`getStencilBits()` get the bit width of the stencil buffer
`RX`	`getTranslationRXToPixel(RX localFrameCMT)` `getTranslationRXToPixel(RX, Point, RX)`, uses current mouse position or (0, 0) if mouse not on canvas, conses.
`RX`	`getTranslationRXToPixel(RX localFrameCMT, java.awt.Point pixel)` `getTranslationRXToPixel(RX, Point, RX)`, conses
`RX`	`getTranslationRXToPixel(RX localFrameCMT, java.awt.Point pixel, RX ret)` Compute translation which takes (0, 0, 0) to the nearest point on the ray through pixel to the origin of a local frame.
`RX`	`getTranslationRXToPixel(RX localFrameCMT, RX ret)` `getTranslationRXToPixel(RX, Point, RX)`, uses current mouse position or (0, 0) if mouse not on canvas.
`protected J3DVertexAccessor`	`getVertexAccessorFor(javax.media.j3d.Geometry g)` Covers `getVertexAccessorFor(Geometry, boolean...)`, enables all components.
`protected J3DVertexAccessor`	`getVertexAccessorFor(javax.media.j3d.Geometry g, boolean... enableComponent)` Get a vertex accessor for a geometry.
`float`	`getViewToCanvasScale()` get current `viewToCanvasScale`
`float`	`getZCenterInView()` Get the z coordinate of the center of `viewAABB` in view frame.
`protected java.io.File`	`grabAndSaveFrame(java.io.File directory, java.lang.String basename, int index, boolean withCursor)` Implementation hook to grab and save a frame.
`boolean`	`hasAccumBuffer()` check whether an accumulation buffer is available
`float[]`	`interpolateOnPickSegmentInLocal(float u)` `interpolateOnPickSegmentInLocal(float, float[])`, conses
`float[]`	`interpolateOnPickSegmentInLocal(float u, float[] p)` similar to `interpolateOnPickSegmentInView(float, float[])`
`float[]`	`interpolateOnPickSegmentInView(float u)` `interpolateOnPickSegmentInView(float, float[])`, conses
`float[]`	`interpolateOnPickSegmentInView(float u, float[] p)` Compute the coordinates of a point on the pick segment in view frame, or NaN if un-set.
`boolean`	`isDepthSortTransparentEnabled()` get `enableDepthSortTransparent(boolean)`
`boolean`	`isDrawingEnabled()` get `enableDrawing(boolean)`
`boolean`	`isFrustumCullEnabled()` get `enableFrustumCull(boolean)`
`protected boolean`	`isHighlighted(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Hook that generic renderer uses to determine whether a geometry/appearance combination should be categorized as highlighted, if `highlightingEnabled`.
`boolean`	`isHighlightingEnabled()` get `enableHighlighting(boolean)`
`protected boolean`	`isMasked(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Hook that generic renderer uses to determine whether a geometry/appearance combination should be categorized as masked, if `maskingEnabled`.
`boolean`	`isMaskingEnabled()` get `enableMasking(boolean)`
`boolean`	`isNavigationEnabled()` get `navigationEnabled`
`protected boolean`	`isPickable(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Check if the given geometry should be considered pickable.
`boolean`	`isPickingEnabled()` get `enablePicking(boolean)`
`boolean`	`isPickSegmentSet()` check if the pick segment is set
`boolean`	`isSphereVisible(float[] centerInView, float radiusInView)` Check if a view-frame sphere intersects the view volume.
`protected boolean`	`isTransparent(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Hook that `render(Geometry, Appearance, float[], float)` uses to determine whether a geometry/appearance combination should be categorized as transparent.
`protected float[]`	`localToCanvas(float... point)` Applies cmt and projection transforms.
`protected float`	`localToCanvas(float length)` Applies cmt and projection transforms.
`protected float[]`	`localToView(boolean doScale, boolean doRotate, boolean doTranslate, float... v)` Transform a 3D vector v from local frame to view frame, i.e.
`protected float[]`	`localToView(float... v)` Covers `localToView(boolean, boolean, boolean, float...)`, does all three transformations
`protected float`	`localToView(float length)` Applies `cmtScale`.
`protected float[]`	`localToWorld(boolean doRotate, boolean doTranslate, float... v)` Transform a 3D vector v from local frame to world frame by applying `localToWorldRX`.
`protected float[]`	`localToWorld(float... v)` covers `localToWorld(boolean, boolean, float...)`, does both transformations
`void`	`navigateToDefaultView()` Covers `navigateToDefaultView(boolean, boolean)`, never resets rotaion center and always interpolates.
`void`	`navigateToDefaultView(boolean resetRotationCenter)` Covers `navigateToDefaultView(boolean, boolean)`, always interpolates.
`void`	`navigateToDefaultView(boolean resetRotationCenter, boolean jump)` Navigate to `getDefaultViewTXEM()`, `getDefaultViewScale()`.
`void`	`navigateToView(RX localToWorld)` `navigateToView(RX, boolean, boolean, boolean, boolean)`, always interpolates, does not set rotation center or defaults.
`void`	`navigateToView(RX localToWorld, boolean setRotationCenter)` `navigateToView(RX, boolean, boolean, boolean, boolean)`, always interpolates, does not set defaults.
`void`	`navigateToView(RX localToWorld, boolean setRotationCenter, boolean setDefaultView, boolean setDefaultRotationCenter)` `navigateToView(RX, boolean, boolean, boolean, boolean)`, always interpolates.
`void`	`navigateToView(RX localToWorld, boolean setRotationCenter, boolean setDefaultView, boolean setDefaultRotationCenter, boolean jump)` Navigate to a viewpoint that aligns the coordinate frame identified by cmt with the view frame.
`protected boolean`	`picked(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, int prim, float u)` Picking callback.
`protected int`	`pickGeometry(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Covers `pickGeometry(Geometry, Appearance, J3DPrimitiveIterator, float[], float[], float, int)` using `getPrimitiveIteratorFor(javax.media.j3d.Geometry, boolean...)`, `getPickThreshold(javax.media.j3d.Geometry, javax.media.j3d.Appearance)`, and `getPickCullFace(javax.media.j3d.Geometry, javax.media.j3d.Appearance)`, `pickStartInLocal`, and `pickExtentInLocal`.
`protected int`	`pickGeometry(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float[] pickStart, float[] pickExtent)` Covers `pickGeometry(Geometry, Appearance, J3DPrimitiveIterator, float[], float[], float, int)` using `getPrimitiveIteratorFor(javax.media.j3d.Geometry, boolean...)`, `getPickThreshold(javax.media.j3d.Geometry, javax.media.j3d.Appearance)`, and `getPickCullFace(javax.media.j3d.Geometry, javax.media.j3d.Appearance)`.
`protected int`	`pickGeometry(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, J3DPrimitiveIterator primitiveIterator, float[] pickStart, float[] pickExtent, float pickThreshold, int cullFace)` Perform a geometry pick.
`float`	`pickSphereInView(float[] pickStart, float[] pickExtent, float[] center, float radius, boolean checkOnly)` Check if a view-frame sphere and pick segment intersect.
`float`	`pickSphereInView(float[] center, float radius, boolean checkOnly)` Covers `pickSphereInView(float[], float[], float[], float, boolean)` using current `pickStartInView` and `pickExtentInView`.
`protected boolean`	`popLocalToWorld()` `popLocalToWorld(boolean)` not alwaysUpdate
`protected boolean`	`popLocalToWorld(boolean alwaysUpdate)` Pop the top transform off `localToWorldStack` and set it by copy to `localToWorldRX`, then `updateCMT()` iff changed or alwaysUpdate.
`protected void`	`postMasking(int numMaskedGeometries)` Hook called from generic `render()` after masking pass.
`protected void`	`postRender(double frameTimeSoFar)` Hook called at end of generic `render()`.
`protected void`	`postScene()` Hook called from generic `render()` after `renderScene()`.
`protected void`	`postSwap()` Hook called from generic `render()` after `swapBuffers()`.
`protected boolean`	`prependInverseLocalToWorld(RX rx)` `prependInverseLocalToWorld(RX, boolean)` not alwaysUpdate.
`protected boolean`	`prependInverseLocalToWorld(RX rx, boolean alwaysUpdate)` Prepend rx^{-1} to `localToWorldRX`, then `updateCMT()` iff changed.
`protected boolean`	`prependLocalToWorld(RX rx)` `prependLocalToWorld(RX, boolean)` not alwaysUpdate
`protected boolean`	`prependLocalToWorld(RX rx, boolean alwaysUpdate)` Prepend rx to `localToWorldRX`, then `updateCMT()` iff changed or alwayUpdate.
`protected void`	`preRender()` Hook called at beginning of generic `render()`.
`protected void`	`preSwap()` Hook called from generic `render()` before `swapBuffers()`.
`protected void`	`projectionChanged()` Hook called when the projection transform has changed, default impl does nothing.
`protected void`	`pushLocalToWorld()` Push `localToWorldRX` by copy onto the top of `localToWorldStack`.
`float`	`recenterZ()` covers `recenterZ(boolean)`, always interpolates
`float`	`recenterZ(boolean jump)` Move the viewpoint so that the current rotation center is on the z plane midway between the front and rear clip planes.
`void`	`render()` The generic renderer.
`protected void`	`render(Display3D.QueuedGeometry[] queue, int queueSize)` Render a queue of geometry.
`protected void`	`render(javax.media.j3d.Geometry geometry)` Covers `render(Geometry, Appearance, float[], float)`, no bounding sphere and default appearance.
`protected void`	`render(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Covers `render(Geometry, Appearance, float[], float)`, no bounding sphere.
`protected void`	`render(javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float[] boundingSphereCenterInView, float boundingSphereRadiusInView)` Render geometry in local frame.
`protected void`	`render(java.util.List<Widget> widgets)` Render a list of `Widget`s.
`protected void`	`render(javax.media.j3d.Shape3D shape)` renders all geometries of shape
`protected void`	`render(Widget w)` covers `render(Widget, RX)`, no extra local-to-world transform
`protected void`	`render(Widget w, RX extraLocalToWorld)` Render a `Widget`.
`protected boolean`	`renderAccept(Widget widget)` Filter hook for `render(List)`.
`protected void`	`renderDepthOnly(Display3D.QueuedGeometry queuedGeometry)` Covers `renderDepthOnly(RX, float, Geometry, Appearance)`.
`protected void`	`renderDepthOnly(Display3D.QueuedGeometry[] queue, int queueSize)` Hook called from generic `render()` to render a queue of geometry depth-only.
`protected void`	`renderDepthOnly(RX cmtRX, float cmtScale, javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Render only the depth component of a geometry.
`protected void`	`renderHighlighted(RX cmtRX, float cmtScale, javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance)` Hook called from generic `render()` to render a highlighted geometry.
`protected void`	`renderImpl()` actual implementation of `render()`
`protected void`	`renderInView()` Hook called from generic `render()` to render geometry in view frame.
`protected void`	`renderScene()` Hook called from generic `render()` to actually render the scene.
`protected void`	`renderTransparent(Display3D.QueuedGeometry queuedGeometry)` Covers `renderTransparent(RX, float, Geometry, Appearance, float)`.
`protected void`	`renderTransparent(Display3D.QueuedGeometry[] queue, int queueSize)` Hook called from generic `render()` to render a queue of transparent geometry.
`protected void`	`renderTransparent(RX cmtRX, float cmtScale, javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float extraAlpha)` Covers `renderTransparent(RX, float, Geometry, Appearance, float)`, always disables depth write.
`protected void`	`renderTransparent(RX cmtRX, float cmtScale, javax.media.j3d.Geometry geometry, javax.media.j3d.Appearance appearance, float extraAlpha, boolean disableDepthWrite)` Render a transparent geometry.
`protected void`	`rePicking()` Hook called from generic render when pick will be performed for a render.
`protected boolean`	`resetPendingMetrics()` Reset any metrics that need it.
`protected void`	`resetPickMetrics()` resets pick metrics
`void`	`resetRenderMetrics()` Resets the render metrics.
`protected void`	`resetRenderMetricsImpl()` Impl of `resetRenderMetrics()`, run at beginning of generic render when `resetRenderMetricsPending` is set.
`protected void`	`resetSceneMetrics(boolean resetPickMetrics)` Resets scene metrics, the generic render implementation does this at the beginning of each render.
`void`	`rotateAboutDefaultCenter()` Set the navigation rotation center to `defaultRotationCenter`.
`void`	`saveFrame(java.io.File directory, java.lang.String basename, double time)` Save the first frame whose rendering completes at or after time to file.
`void`	`saveFrame(java.lang.String basename, double time)` `saveFrame(File, String, double)` to current dir
`void`	`saveFrame(java.lang.String directory, java.lang.String basename, double time)` covers `saveFrame(File, String, double)`
`protected boolean`	`saveFrameFailed(java.lang.Exception exception)` Called when any frame save fails.
`protected boolean`	`saveFrameFinished(java.io.File file)` Called after any frame save is completed or fails.
`void`	`saveNextFrame(java.io.File directory, java.lang.String basename)` `saveFrame(File, String, double)` asap
`void`	`saveNextFrame(java.lang.String basename)` `saveFrame(File, String, double)` asap to current dir
`void`	`saveNextFrame(java.lang.String directory, java.lang.String basename)` covers `saveNextFrame(File, String)`
`void`	`setAmbientAlpha(float alpha)` set `ambientAlpha`
`abstract void`	`setAmbientLightIntensity(float intensity)` concrete subclasses must implement to set ambient light intensity
`abstract void`	`setBackgroundColor(float... color)` concrete subclasses must implement this to set the background color
`protected void`	`setCanvas(java.awt.Canvas canvas, int width, int height)` Concrete subclasses call this to set `canvas`, thread safe.
`void`	`setCanvasSize(int width, int height)` `setCanvasSize(int, int, boolean)` and re-pack
`void`	`setCanvasSize(int width, int height, boolean rePack)` set the canvas preferred size
`protected void`	`setCMT(RX cmtRX, float cmtScale)` Set `cmtRX` and `cmtScale` by copy, then `applyCMT()`.
`void`	`setDefaultRotationCenter(double... rc)` Set the default rotation center in world frame as returned by the default impl of `getDefaultRotationCenter()`.
`void`	`setDefaultView(RX rx, double scale)` Set the default world-to-view transform as returned by the default impl of `getDefaultViewTXEM()`.
`void`	`setDefaultViewScale(double scale)` Set `defaultViewScale`.
`void`	`setDefaultViewTXEM(double... txem)` Set the default world-to-view TXEM vector as returned by the default impl of `getDefaultViewTXEM()`.
`void`	`setDefaultViewTXEMS(double... txems)` `setDefaultViewTXEM(double...)` and `setDefaultViewScale(double)`
`abstract void`	`setDirectionalLightDirection(float... direction)` concrete subclasses must implement to set directional light direction
`abstract void`	`setDirectionalLightIntensity(float intensity)` concrete subclasses must implement to set directional light intensity
`void`	`setHighlightColor(float... color)` set `highlightColor`
`void`	`setHighlightFactor(float factor)` set `highlightFactor`
`protected boolean`	`setLocalToWorld(RX rx)` `setLocalToWorld(RX, boolean)` not alwaysUpdate
`protected boolean`	`setLocalToWorld(RX rx, boolean alwaysUpdate)` Set identity `localToWorldRX` by copy, then `updateCMT()` iff changed or alwaysUpdate.
`void`	`setLongFrameWarningThreshold(float threshold)` Set the threshold in ms above whidh a warning will be issued for long frame render times.
`void`	`setMaskAlpha(float alpha)` set `maskAlpha`
`void`	`setPickPointOnCanvas(float x, float y)` Convenience to `setPickSegmentInView(float[], float[])` given a location on the canvas in pixels.
`void`	`setPickSegmentInView(float[] start, float[] extent)` Set the pick segment in view frame.
`void`	`setPickThresholdPixels(float threshold)` set `pickThresholdPixels`
`boolean`	`setSymmetricZClip(float depth)` `setZClip(float, float)` symmetrically for a total span of depth
`protected void`	`setTraceFlags(int flags)` hook to set `traceFlags`
`protected void`	`setTraceOptions(boolean... options)` covers `setTraceOptions(int, boolean...)`, no base flags
`protected void`	`setTraceOptions(int baseFlags, boolean... options)` Accumulate options as a bitfield, in order starting with LSB, on top of baseFlags, and then `setTraceFlags(int)`.
`boolean`	`setViewInMeters()` `setViewToCanvasScale(float)` to 1.0f/`SCREEN_METERS_PER_PIXEL`.
`boolean`	`setViewInPixels()` `setViewToCanvasScale(float)` to 1.0f
`boolean`	`setViewToCanvasScale(float viewToCanvasScale)` Set `viewToCanvasScale`.
`boolean`	`setZClip(float near, float far)` Set the near and far planes of the view volume in view frame.
`void`	`startSavingFrames(java.io.File directory, java.lang.String prefix)` `startSavingFrames(File, String, double, int)` with start index 0, saving every render.
`void`	`startSavingFrames(java.io.File directory, java.lang.String prefix, double fps)` `startSavingFrames(File, String, double, int)` with start index 0.
`void`	`startSavingFrames(java.io.File directory, java.lang.String prefix, double fps, int startIndex)` Save frames at a regular rate, starting with with the next render.
`void`	`startSavingFrames(java.lang.String prefix)` `startSavingFrames(File, String, double, int)` with start index 0, saving every render to current dir.
`void`	`startSavingFrames(java.lang.String prefix, double fps)` `startSavingFrames(File, String, double, int)` with start index 0, to current dir.
`void`	`startSavingFrames(java.lang.String directory, java.lang.String prefix)` Covers `startSavingFrames(File, String)`.
`void`	`startSavingFrames(java.lang.String directory, java.lang.String prefix, double fps)` Covers `startSavingFrames(File, String, double)`.
`void`	`startSavingFrames(java.lang.String directory, java.lang.String prefix, double fps, int startIndex)` Covers `startSavingFrames(File, String, double, int)`.
`double`	`stopSavingFrames()` Abort any pending one-shot or regular-rate frame save.
`protected abstract void`	`swapBuffers()` subclasses must implement this to swap display buffers
`void`	`traceNextFrame()` Like `traceNextFrame(boolean, boolean)` but only traces renderer.
`void`	`traceNextFrame(boolean tracePicking, boolean traceRenderer)` Enable tracing for next frame with given options.
`void`	`traceNextPickingFrame()` Like `traceNextFrame(boolean, boolean)` but only traces picking.
`void`	`unsetPickSegment()` un-set the pick segment
`protected void`	`updateCMT()` Set `cmtRX` and `cmtScale` as the concatenation of `localToWorldRX`, `worldToViewScale`, and `worldToViewRX`, in that order, then `applyCMT()`.
`protected void`	`updateHighlightedMaterial()` Update `defaultHighlightedMaterial` from `highlightFactor` and `highlightColor`.
`protected void`	`updatePickSegmentInLocal()` Update `pickStartInLocal` and `pickExtentInLocal` from `pickStartInView` and `pickExtentInView`.
`protected boolean`	`updateProjection(float canvasWidth, float canvasHeight, float viewToCanvasScale)` Recomputes `viewAABB` from canvasWidth, canvasHeight, and `viewToCanvasScale`.
`protected boolean`	`updateWorldToView()` covers `updateWorldToView(boolean)`, always to current
`protected boolean`	`updateWorldToView(boolean toWaypoint)` Updates `worldToViewRX` and `worldToViewScale` from `rxsInteractor`, then `updateCMT()` iff changed.
`boolean`	`usingAccumBuffer()` Check if the accum buffer is currently considered usable.
`float[]`	`viewToCanvas(float... point)` opposite of `canvasToView(float...)`
`float`	`viewToCanvas(float length)` applies the projection transform
`protected float[]`	`viewToLocal(boolean doScale, boolean doRotate, boolean doTranslate, float... v)` inverse of `localToView(boolean, boolean, boolean, float...)`
`protected float[]`	`viewToLocal(float... v)` covers `viewToLocal(boolean, boolean, boolean, float...)`, does all three transformations
`protected float`	`viewToLocal(float length)` Applies `cmtScale`^{-1}.
`float[]`	`viewToWorld(boolean doScale, boolean doRotate, boolean doTranslate, float... v)` inverse of `worldToView(boolean, boolean, boolean, float...)`
`float[]`	`viewToWorld(float... v)` covers `viewToWorld(boolean, boolean, boolean, float...)`, does all three transformations
`float`	`viewToWorld(float length)` applies `worldToViewScale`^{-1}
`protected float[]`	`worldToLocal(boolean doRotate, boolean doTranslate, float... v)` inverse of `localToWorld(boolean, boolean, float...)`
`protected float[]`	`worldToLocal(float... v)` covers `worldToLocal(boolean, boolean, float...)`, does both transformations
`float[]`	`worldToView(boolean doScale, boolean doRotate, boolean doTranslate, float... v)` Transform a 3D vector v from world frame to view frame by applying `worldToViewScale` and `worldToViewRX`.
`float[]`	`worldToView(float... v)` covers `worldToView(boolean, boolean, boolean, float...)`, does all three transformations
`float`	`worldToView(float length)` applies `worldToViewScale`
`protected void`	`worldToViewChanged()` Hook called when the world-to-view transform has changed (e.g.
`boolean`	`worldToViewDirty()` check if a navigation update is waiting to be applied

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
  - MIN
```
public static final int MIN
```
    index of component in a two-element extents vector
    
    See Also:
    Constant Field Values
  - MAX
```
public static final int MAX
```
    index of component in a two-element extents vector
    
    See Also:
    Constant Field Values
  - TRACE_PICKING_EN
```
public static final int TRACE_PICKING_EN
```
    trace flags
    
    See Also:
    Constant Field Values
  - TRACE_GENERIC_EN
```
public static final int TRACE_GENERIC_EN
```
    trace flags
    
    See Also:
    Constant Field Values
  - DEF_Z_CLIP
```
public static final float DEF_Z_CLIP
```
    default symmetric z clip, see setSymmetricZClip(float)
    
    See Also:
    Constant Field Values
  - DEF_VIEW_SCALE
```
public static final double DEF_VIEW_SCALE
```
    default defaultViewScale
    
    See Also:
    Constant Field Values
  - DEF_AMBIENT_LIGHT_INTENSITY
```
public static final float DEF_AMBIENT_LIGHT_INTENSITY
```
    default ambient light intensity
    
    See Also:
    Constant Field Values
  - DEF_DIRECTIONAL_LIGHT_INTENSITY
```
public static final float DEF_DIRECTIONAL_LIGHT_INTENSITY
```
    default directional light intensity
    
    See Also:
    Constant Field Values
  - SQRT3F
```
public static final float SQRT3F
```
    square root of 3.0f
  - DEF_DIRECTIONAL_LIGHT_DIRECTION
```
public static final float[] DEF_DIRECTIONAL_LIGHT_DIRECTION
```
    default directional light direction
  - NUM_RECENT_METRICS
```
public static final int NUM_RECENT_METRICS
```
    length of recentFrameTime and recentCycleTime
    
    See Also:
    Constant Field Values
  - QUEUE_INITIAL_CAPACITY
```
public static final int QUEUE_INITIAL_CAPACITY
```
    defailt initial capacity of the queues
    
    See Also:
    Constant Field Values
  - LOCAL_TO_WORLD_STACK_INITIAL_CAPACITY
```
public static final int LOCAL_TO_WORLD_STACK_INITIAL_CAPACITY
```
    defailt initial capacity of localToWorldStack
    
    See Also:
    Constant Field Values
  - DEF_HIGHLIGHT_FACTOR
```
public static final float DEF_HIGHLIGHT_FACTOR
```
    default highlightFactor
    
    See Also:
    Constant Field Values
  - DEF_HIGHLIGHT_COLOR
```
public static final float[] DEF_HIGHLIGHT_COLOR
```
    default highlightColor
  - DEF_MASK_ALPHA
```
public static final float DEF_MASK_ALPHA
```
    default maskAlpha
    
    See Also:
    Constant Field Values
  - DEF_PICK_THRESHOLD_PIXELS
```
public static final float DEF_PICK_THRESHOLD_PIXELS
```
    default pickThresholdPixels
    
    See Also:
    Constant Field Values
  - COORD_ONLY
```
protected static final boolean[] COORD_ONLY
```
    component enables for vertex accessors and primitive iterators
  - ALL_COMPONENTS
```
protected static final boolean[] ALL_COMPONENTS
```
    component enables for vertex accessors and primitive iterators
  - SCREEN_METERS_PER_PIXEL
```
public static final float SCREEN_METERS_PER_PIXEL
```
    physical screen resolution
  - canvas
```
protected volatile java.awt.Canvas canvas
```
    the canvas
  - redBits
```
protected volatile int redBits
```
    number of bits in the specified canvas component
  - greenBits
```
protected volatile int greenBits
```
    number of bits in the specified canvas component
  - blueBits
```
protected volatile int blueBits
```
    number of bits in the specified canvas component
  - depthBits
```
protected volatile int depthBits
```
    number of bits in the specified canvas component
  - stencilBits
```
protected volatile int stencilBits
```
    number of bits in the specified canvas component
  - numSamples
```
protected volatile int numSamples
```
    number antialiasing samples
  - projectionLock
```
protected final java.lang.Object projectionLock
```
    synchronization lock for projection state
  - canvasSize
```
protected final float[] canvasSize
```
    current cached size of canvas in pixels
  - viewAABB
```
protected final float[][] viewAABB
```
    view volume AABB in view frame
  - viewToCanvasScale
```
protected float viewToCanvasScale
```
    current view-to-canvas scale
  - applyProjectionPending
```
protected boolean applyProjectionPending
```
    whether a applyProjection() is pending
  - canvasMouseLock
```
protected final java.lang.Object canvasMouseLock
```
    synchronization object for canvas mouse location
  - canvasMouseX
```
protected int canvasMouseX
```
    Most recent mouse location on canvas in canvas coords or negative if mouse not on canvas.
  - canvasMouseY
```
protected int canvasMouseY
```
    Most recent mouse location on canvas in canvas coords or negative if mouse not on canvas.
  - rxsInteractor
```
public final RXSInteractor rxsInteractor
```
    The interactor.
    
    Users of this class may configure this directly, e.g. to set factors or enable/disable motion types (while synchronized on it). However, note that the world-to-canvas transform parameters of this interactor are automatically set by updateProjection(float, float, float).
  - rxsInterpolator
```
public final RXSInterpolator rxsInterpolator
```
    the RXSInterpolator in rxsInteractor
  - defaultRotationCenter
```
protected double[] defaultRotationCenter
```
    Current default rotation center, used by getDefaultRotationCenter().
  - defaultViewTXEM
```
protected double[] defaultViewTXEM
```
    Current default world-to-view TXEM, used by getDefaultViewTXEM().
  - defaultViewScale
```
protected double defaultViewScale
```
    Current default world-to-view scale, used by getDefaultViewScale().
  - localToWorldRX
```
protected final RX localToWorldRX
```
    Local-to-world RX.
    
    If used, this is designed to be confined to the render thread.
  - localToWorldStack
```
protected RX[] localToWorldStack
```
    Stack for saving localToWorldRX.
    
    If used, this is designed to be confined to the render thread.
  - localToWorldStackSize
```
protected int localToWorldStackSize
```
    Current number of transforms saved in localToWorldStack.
    
    If used, this is designed to be confined to the render thread.
  - worldToViewRX
```
protected final RX worldToViewRX
```
    world-to-view RX
  - worldToViewRXTemp
```
protected final RX worldToViewRXTemp
```
    temporary world-to-view RX
  - worldToViewScale
```
protected float worldToViewScale
```
    world-to-view scale, updated by updateWorldToView(boolean)
  - cmtRX
```
protected final RX cmtRX
```
    current rigid part of the local-to-view composite model transform.
    
    Confined to the render thread.
  - cmtScale
```
protected float cmtScale
```
    Current scale part of the local-to-view composite model transform.
    
    Confined to the render thread.
  - fitPending
```
protected boolean fitPending
```
    whether a doFit() is pending
  - frameSaveLock
```
protected java.lang.Object frameSaveLock
```
    lock object for frame save state
  - frameSaveNextTime
```
protected double frameSaveNextTime
```
    next frame save wall-clock time in seconds, if any, else NaN
  - frameSaveLastTime
```
protected double frameSaveLastTime
```
    last frame save wall-clock time in seconds, if any, else NaN
  - frameSaveStartTime
```
protected double frameSaveStartTime
```
    Regular-rate frame save sequence start time in wall-clock time in seconds, if any, else NaN.
  - frameSaveDirectory
```
protected java.io.File frameSaveDirectory
```
    frame save destination directory or null for current dir
  - frameSavePrefix
```
protected java.lang.String frameSavePrefix
```
    frame save filename prefix or null for none
  - frameSaveNextIndex
```
protected int frameSaveNextIndex
```
    next index for regular-rate frame save
  - frameSaveCount
```
protected int frameSaveCount
```
    total count of frames saved in current sequence, including errors
  - frameSaveFPS
```
protected double frameSaveFPS
```
    maximum rate for regular frame save.
    
    Zero to save every render.
    
    Negative indicates not regularly saving frames.
  - frameSaveWithCursor
```
public volatile boolean frameSaveWithCursor
```
    Whether to include the cursor in frame saves.
    
    Default false.
  - sceneMetricsLock
```
protected final java.lang.Object sceneMetricsLock
```
    synchronization lock for scene metrics
  - sceneAABBInView
```
protected final float[][] sceneAABBInView
```
    AABB of enclosing union of bounding spheres (including those that would be frustum culled) seen by generic render(Geometry, Appearance, float[], float) since last resetSceneMetrics(boolean).
  - numSceneWidgets
```
protected int numSceneWidgets
```
    Total number of Widgets (including those with zero enabled geometries, and those that would be frustum culled) seen by generic render(Widget, RX) since last resetSceneMetrics(boolean).
  - numDisabledWidgetGeometries
```
protected int numDisabledWidgetGeometries
```
    Total number of disabled Widget geometries seen by generic render(Widget, RX) since last resetSceneMetrics(boolean).
  - numSceneGeometries
```
protected int numSceneGeometries
```
    Total number of geometries (including those that would be frustum culled) seen by generic render(Geometry, Appearance, float[], float) since last resetSceneMetrics(boolean).
  - numVisibleGeometries
```
protected int numVisibleGeometries
```
    Total number of visible (not frustum cull) geometries seen by generic render(Geometry, Appearance, float[], float) since last resetSceneMetrics(boolean).
  - numTransparentGeometries
```
protected int numTransparentGeometries
```
    Total number of visible (not frustum cull) geometries rendered as transparent by generic render(Geometry, Appearance, float[], float) since last resetSceneMetrics(boolean).
  - numHighlightedGeometries
```
protected int numHighlightedGeometries
```
    Total number of visible (not frustum cull) geometries rendered as highlighted by generic render(Geometry, Appearance, float[], float) since last resetSceneMetrics(boolean).
  - numMaskedGeometries
```
protected int numMaskedGeometries
```
    Total number of visible (not frustum cull) geometries rendered as masked by generic render(Geometry, Appearance, float[], float) since last resetSceneMetrics(boolean).
  - numPickableGeometries
```
protected int numPickableGeometries
```
    Total number of visible pickable geometries iff pickingEnabled since last resetSceneMetrics(boolean).
  - renderMetricsLock
```
protected final java.lang.Object renderMetricsLock
```
    synchronization lock for render metrics
  - resetRenderMetricsPending
```
protected volatile boolean resetRenderMetricsPending
```
    see resetRenderMetrics()
  - dumpRenderMetricsPending
```
protected volatile java.io.PrintStream dumpRenderMetricsPending
```
    see dumpRenderMetrics(PrintStream)
  - dumpSceneMetricsPending
```
protected volatile java.io.PrintStream dumpSceneMetricsPending
```
    see dumpSceneMetrics(PrintStream)
  - frameTime
```
protected final double[] frameTime
```
    Min and max generic render() time [s] since last resetRenderMetrics().
  - numPickGeometryHits
```
protected int numPickGeometryHits
```
    Total number of geometries with at least one pick hit in pickGeometry(Geometry, Appearance, J3DPrimitiveIterator, float[], float[], float, int) since last resetSceneMetrics(boolean) on a frame with picking (or if resetPickMetricsEveryRender).
  - numPickBoundsHits
```
protected int numPickBoundsHits
```
    Total number of geometries picked by bounds in generic render since last resetSceneMetrics(boolean) on a frame with picking (or if resetPickMetricsEveryRender).
  - numPickedGeometries
```
protected int numPickedGeometries
```
    Total number of geometries picked either by bounds only or by geometry since last resetSceneMetrics(boolean) on a frame with picking (or if resetPickMetricsEveryRender).
  - recentFrameTime
```
protected final double[] recentFrameTime
```
    Rendering time [s] for up to NUM_RECENT_METRICS most recent generic render() frames.
  - recentFrameTimeWriteIndex
```
protected int recentFrameTimeWriteIndex
```
    next write index in recentFrameTime
  - recentCycleTime
```
protected final double[] recentCycleTime
```
    Cycle time [s] for up to NUM_RECENT_METRICS most recent generic render() frames.
    
    A frame cycle is defined here as beginning at the end of frame n render and ending at the end of frame n+1 render.
  - recentCycleTimeWriteIndex
```
protected int recentCycleTimeWriteIndex
```
    next write index in recentCycleTime
  - lastFrameEndTime
```
protected double lastFrameEndTime
```
    end time [s] of previous generic render(), NaN if none
  - numFrames
```
protected int numFrames
```
    Total num generic render() calls since last resetRenderMetrics().
  - renderImplPreSceneMetrics
```
protected TimeMetrics renderImplPreSceneMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - updateProjectionMetrics
```
protected TimeMetrics updateProjectionMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - preRenderMetrics
```
protected TimeMetrics preRenderMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - updateNavMetrics
```
protected TimeMetrics updateNavMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - clearMetrics
```
protected TimeMetrics clearMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderSceneMetrics
```
protected TimeMetrics renderSceneMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderImplPostSceneMetrics
```
protected TimeMetrics renderImplPostSceneMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderTransparentQueue1Metrics
```
protected TimeMetrics renderTransparentQueue1Metrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - accumPass1Metrics
```
protected TimeMetrics accumPass1Metrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderDepthOnlyQueueMetrics
```
protected TimeMetrics renderDepthOnlyQueueMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderTransparentQueue2Metrics
```
protected TimeMetrics renderTransparentQueue2Metrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - accumPass2Metrics
```
protected TimeMetrics accumPass2Metrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderInViewMetrics
```
protected TimeMetrics renderInViewMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - swapMetrics
```
protected TimeMetrics swapMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - postRenderMetrics
```
protected TimeMetrics postRenderMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderWidgetMetrics
```
protected TimeMetrics renderWidgetMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - applyWidgetRX
```
protected TimeMetrics applyWidgetRX
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - transformWidgetBounds
```
protected TimeMetrics transformWidgetBounds
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderWidgetGeometryMetrics
```
protected TimeMetrics renderWidgetGeometryMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderGeometryMetrics
```
protected TimeMetrics renderGeometryMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderTransparentMetrics
```
protected TimeMetrics renderTransparentMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderHighlightedMetrics
```
protected TimeMetrics renderHighlightedMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - renderDepthOnlyMetrics
```
protected TimeMetrics renderDepthOnlyMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - pickGeometryMetrics
```
protected TimeMetrics pickGeometryMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - frameSaveMetrics
```
protected TimeMetrics frameSaveMetrics
```
    Extended render metrics, iff compiled with ENABLE_EXTENDED_RENDER_METRICS.
  - allExtendedRenderMetrics
```
protected java.util.List<TimeMetrics> allExtendedRenderMetrics
```
    all extended render metrics
  - ENABLE_EXTENDED_RENDER_METRICS
```
protected final boolean ENABLE_EXTENDED_RENDER_METRICS
```
    whether to enable extended render metrics (compile time constant)
    
    See Also:
    Constant Field Values
  - drawingEnabled
```
protected volatile boolean drawingEnabled
```
    enable for indicated feature in generic render() code
  - pickingEnabled
```
protected volatile boolean pickingEnabled
```
    enable for indicated feature in generic render() code
  - depthSortTransparentEnabled
```
protected volatile boolean depthSortTransparentEnabled
```
    enable for indicated feature in generic render() code
  - depthRenderMaskedQueueEnabled
```
protected volatile boolean depthRenderMaskedQueueEnabled
```
    enable for indicated feature in generic render() code
  - highlightingEnabled
```
protected volatile boolean highlightingEnabled
```
    enable for indicated feature in generic render() code
  - maskingEnabled
```
protected volatile boolean maskingEnabled
```
    enable for indicated feature in generic render() code
  - frustumCullEnabled
```
protected volatile boolean frustumCullEnabled
```
    enable for indicated feature in generic render() code
  - navigationEnabled
```
protected volatile boolean navigationEnabled
```
    enable for indicated feature in generic render() code
  - pickBoundsOnly
```
protected volatile boolean pickBoundsOnly
```
    whether picking should be done only on bounding spheres
  - pickVisibleBoundsOnly
```
protected volatile boolean pickVisibleBoundsOnly
```
    whether picking should be done only on non-culled geometry
  - pickSegmentIntersectionsOnly
```
protected volatile boolean pickSegmentIntersectionsOnly
```
    Whether picks should only be reported for pick intersections that actually lie on the pick segment defined by pickStartInView, pickExtentInView.
    
    Otherwise, all intersections with the line through the pick segment will be reported.
  - unsetPickSegmentOnWorldToViewChange
```
protected volatile boolean unsetPickSegmentOnWorldToViewChange
```
    Whether to automatically un-set the pick segment on the given event.
  - unsetPickSegmentOnProjectionChange
```
protected volatile boolean unsetPickSegmentOnProjectionChange
```
    Whether to automatically un-set the pick segment on the given event.
  - unsetPickSegmentAfterRender
```
protected volatile boolean unsetPickSegmentAfterRender
```
    Whether to automatically un-set the pick segment on the given event.
  - resetPickMetricsEveryRender
```
protected volatile boolean resetPickMetricsEveryRender
```
    Whether to reset pick metrics at the beginning of every frame or just at the beginning of frames for pick will be performed.
  - ensureWidgetBoundingSpheresInViewEnabled
```
protected volatile boolean ensureWidgetBoundingSpheresInViewEnabled
```
    Whether render(Widget, RX) calls Widget.ensureBoundingSpheresInView().
  - dbgSceneExtentsEnabled
```
protected volatile boolean dbgSceneExtentsEnabled
```
    whether to enable dbg scene extents
  - dbgSceneExtentsRect
```
protected RectangleWidget dbgSceneExtentsRect
```
    widget for displaying dbg scene extents
  - longFrameWarningThreshold
```
protected volatile float longFrameWarningThreshold
```
    Iif non-NaN this is the threshold in ms above which a warning will be issued for long frame render times.
  - traceFlags
```
protected volatile int traceFlags
```
    trace flags for generic render()
  - traceStream
```
protected volatile java.io.PrintStream traceStream
```
    trace stream for generic render()
  - dbgAppearance
```
protected javax.media.j3d.Appearance dbgAppearance
```
    Appearance for dbg objects.
    
    If used, this is designed to be confined to the render thread.
  - defaultTransparentAppearance
```
protected javax.media.j3d.Appearance defaultTransparentAppearance
```
    Default transparent appearance.
    
    If used, this is designed to be confined to the render thread.
  - depthOnlyAppearance
```
protected javax.media.j3d.Appearance depthOnlyAppearance
```
    Depth-only appearance.
    
    If used, this is designed to be confined to the render thread.
  - environmentLock
```
protected final java.lang.Object environmentLock
```
    lock for bg, light, and highlight params
  - highlightFactor
```
protected float highlightFactor
```
    This is the multiplicative factor by which renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance) increases the emissive color of highlighted geometry, modulated by highlightColor.
    
    This must be in the range [0, 1]. The modulation is computed as n = o+c*f where n is the new color component, o is the original color component, c is the corresponding highlightColor component, and f is the highlight factor. If the resulting n is greater than 1 then the alternate formulat n = c*f is used.
  - highlightColor
```
protected final float[] highlightColor
```
    highlight modulation color, see highlightFactor
  - emissiveColorWas
```
protected final javax.vecmath.Color3f emissiveColorWas
```
    used by renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)
  - newEmissiveColor
```
protected final javax.vecmath.Color3f newEmissiveColor
```
    used by renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)
  - premultipliedHighlightColor
```
protected final javax.vecmath.Color3f premultipliedHighlightColor
```
    used by renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)
  - defaultHighlightedMaterial
```
protected final javax.media.j3d.Material defaultHighlightedMaterial
```
    used by renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)
  - defaultHighlightedAppearance
```
protected final javax.media.j3d.Appearance defaultHighlightedAppearance
```
    used by renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance)
  - ambientAlpha
```
protected volatile float ambientAlpha
```
    Ambient alpha.
    
    Ignored if outside the range [0, 1). Otherwise, ambientAlpha is considered to multiply the original alpha in render(Geometry, Appearance, float[], float).
  - maskAlpha
```
protected volatile float maskAlpha
```
    alpha factor for masked geometry
  - passAlpha
```
protected float passAlpha
```
    Alpha factor for current rendering pass.
    
    If used, this is designed to be confined to the render thread.
  - premultiplyPassAlpha
```
protected boolean premultiplyPassAlpha
```
    Whether the default renderer will use the extraAlpha draw(...) parameter to implement passAlpha.
    
    If used, this is designed to be confined to the render thread.
  - renderMaskedGeometry
```
protected boolean renderMaskedGeometry
```
    Whether to render masked geometry in the current pass.
    
    If used, this is designed to be confined to the render thread.
  - freezeTransparentQueue
```
protected boolean freezeTransparentQueue
```
    Whether to short circuit in enqueueTransparentGeometry(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance, float, float).
    
    If used, this is designed to be confined to the render thread.
  - freezeSceneMetrics
```
protected boolean freezeSceneMetrics
```
    Whether to short circuit in addToSceneMetrics(float[], float, boolean, boolean, boolean, boolean, boolean).
    
    If used, this is designed to be confined to the render thread.
  - freezeWidgetBounds
```
protected boolean freezeWidgetBounds
```
    Whether to skip updating Widget bounds in view render(Widget, RX).
    
    If used, this is designed to be confined to the render thread.
  - transparentQueue
```
protected Display3D.QueuedGeometry[] transparentQueue
```
    Queue for depth sort transparency.
    
    Consed lazily iff depthSortTransparentEnabled.
    
    If used, this is designed to be confined to the render thread.
  - transparentQueueSize
```
protected int transparentQueueSize
```
    Current number of objects in transparentQueue
    
    If used, this is designed to be confined to the render thread.
  - maskedQueue
```
protected Display3D.QueuedGeometry[] maskedQueue
```
    Queue for masked geometry.
    
    Consed lazily iff maskingEnabled.
    
    If used, this is designed to be confined to the render thread.
  - maskedQueueSize
```
protected int maskedQueueSize
```
    Current number of objects in maskedQueue
    
    If used, this is designed to be confined to the render thread.
  - vertexAccessors
```
protected J3DVertexAccessor[] vertexAccessors
```
    Set of available vertex accessors, consed lazily.
    
    If used, this is designed to be confined to the render thread.
  - indexAccessors
```
protected J3DIndexAccessor[] indexAccessors
```
    Set of available index accessors, consed lazily.
    
    If used, this is designed to be confined to the render thread.
  - primitiveIterators
```
protected J3DPrimitiveIterator[] primitiveIterators
```
    Set of available primitive iterators, consed lazily.
    
    If used, this is designed to be confined to the render thread.
  - pickStartInView
```
protected final float[] pickStartInView
```
    Start point of the pick segment in view frame, or NaN if un-set.
  - pickExtentInView
```
protected final float[] pickExtentInView
```
    Extent of the pick segment in view frame, or NaN if un-set.
  - pickStartInLocal
```
protected final float[] pickStartInLocal
```
    Start point of the pick segment in local frame, or NaN if un-set.
  - pickExtentInLocal
```
protected final float[] pickExtentInLocal
```
    Extent of the pick segment in local frame, or NaN if un-set.
  - pickSegmentInLocalDirty
```
protected boolean pickSegmentInLocalDirty
```
    Dirty flag for pickStartInLocal and pickExtentInLocal.
  - pickSegmentInViewPerpCanvas
```
protected boolean pickSegmentInViewPerpCanvas
```
    whether the pick segment in view frame is perpendicular to the canvas
  - pickSegmentLock
```
protected java.lang.Object pickSegmentLock
```
    lock object for pick segment state
  - pickThresholdPixels
```
protected volatile float pickThresholdPixels
```
    Pick threshold in canvas pixels.
- Constructor Detail
  - Display3D
```
public Display3D()
```
    make a new Display3D
- Method Detail
  - getCanvas
```
public java.awt.Canvas getCanvas()
```
    get canvas, thread safe
  - setCanvasSize
```
public void setCanvasSize(int width,
                 int height,
                 boolean rePack)
```
    set the canvas preferred size
  - setCanvasSize
```
public void setCanvasSize(int width,
                 int height)
```
    setCanvasSize(int, int, boolean) and re-pack
  - getCanvasMouseLocation
```
public java.awt.Point getCanvasMouseLocation(java.awt.Point point)
```
    Get the most recent mouse location on canvas in canvas coords.
    
    Returns negative coords if mouse is not on canvas.
  - getCanvasMouseLocation
```
public java.awt.Point getCanvasMouseLocation()
```
    getCanvasMouseLocation(Point), conses
  - getRedBits
```
public int getRedBits()
```
    get the bit width of the red buffer
  - getGreenBits
```
public int getGreenBits()
```
    get the bit width of the green buffer
  - getBlueBits
```
public int getBlueBits()
```
    get the bit width of the blue buffer
  - getDepthBits
```
public int getDepthBits()
```
    get the bit width of the depth buffer
  - getStencilBits
```
public int getStencilBits()
```
    get the bit width of the stencil buffer
  - getNumSamples
```
public int getNumSamples()
```
    get the number of antialiasing samples
  - usingAccumBuffer
```
public boolean usingAccumBuffer()
```
    Check if the accum buffer is currently considered usable.
    
    Default impl chains to hasAccumBuffer().
  - hasAccumBuffer
```
public boolean hasAccumBuffer()
```
    check whether an accumulation buffer is available
  - saveFrame
```
public void saveFrame(java.io.File directory,
             java.lang.String basename,
             double time)
```
    Save the first frame whose rendering completes at or after time to file.
    
    The file format is implementation dependent.
    
    saveFrameFailed(java.lang.Exception) will be called if the save fails for any reason, and saveFrameFinished(java.io.File) will be called after the save is completed (or failed).
    
    Parameters:
    directory - the destination directory, null for current dir
    basename - the name of the destination file without directory or extension
    time - the system time in seconds after which to save a frame
    
    Throws:
    
    java.lang.IllegalStateException - if currently saving frames (see startSavingFrames(java.io.File, java.lang.String, double, int))
  - saveFrame
```
public void saveFrame(java.lang.String directory,
             java.lang.String basename,
             double time)
```
    covers saveFrame(File, String, double)
  - saveFrame
```
public void saveFrame(java.lang.String basename,
             double time)
```
    saveFrame(File, String, double) to current dir
  - saveNextFrame
```
public void saveNextFrame(java.io.File directory,
                 java.lang.String basename)
```
    saveFrame(File, String, double) asap
  - saveNextFrame
```
public void saveNextFrame(java.lang.String directory,
                 java.lang.String basename)
```
    covers saveNextFrame(File, String)
  - saveNextFrame
```
public void saveNextFrame(java.lang.String basename)
```
    saveFrame(File, String, double) asap to current dir
  - startSavingFrames
```
public void startSavingFrames(java.io.File directory,
                     java.lang.String prefix,
                     double fps,
                     int startIndex)
```
    Save frames at a regular rate, starting with with the next render.
    
    The file format is implementation dependent.
    
    saveFrameFailed(java.lang.Exception) will be called if any save fails for any reason, and saveFrameFinished(java.io.File) will be called after each save is completed (or fails).
    
    The frames will be saved no faster than the requested fps. The actual save rate will be limited to the rate at which render() is called by higher level code. The average of this actual rate across all frames will be returned when stopSavingFrames() is called.
    
    Will not overwrite existing files.
    
    Parameters:
    directory - the directory in which to save, null for current dir
    prefix - filename prefix, null for none
    fps - target frames per second, not negative, zero to save every render
    startIndex - initial index, not negative
  - startSavingFrames
```
public void startSavingFrames(java.lang.String directory,
                     java.lang.String prefix,
                     double fps,
                     int startIndex)
```
    Covers startSavingFrames(File, String, double, int).
  - startSavingFrames
```
public void startSavingFrames(java.io.File directory,
                     java.lang.String prefix,
                     double fps)
```
    startSavingFrames(File, String, double, int) with start index 0.
  - startSavingFrames
```
public void startSavingFrames(java.lang.String directory,
                     java.lang.String prefix,
                     double fps)
```
    Covers startSavingFrames(File, String, double).
  - startSavingFrames
```
public void startSavingFrames(java.io.File directory,
                     java.lang.String prefix)
```
    startSavingFrames(File, String, double, int) with start index 0, saving every render.
  - startSavingFrames
```
public void startSavingFrames(java.lang.String directory,
                     java.lang.String prefix)
```
    Covers startSavingFrames(File, String).
  - startSavingFrames
```
public void startSavingFrames(java.lang.String prefix,
                     double fps)
```
    startSavingFrames(File, String, double, int) with start index 0, to current dir.
  - startSavingFrames
```
public void startSavingFrames(java.lang.String prefix)
```
    startSavingFrames(File, String, double, int) with start index 0, saving every render to current dir.
  - stopSavingFrames
```
public double stopSavingFrames()
```
    Abort any pending one-shot or regular-rate frame save.
    
    Returns:
    the actual average fps for the saved sequence
  - getNumFramesSaved
```
public int getNumFramesSaved()
```
    Get the total number of frames saved in the current or previous regular-rate save sequence.
    
    This count includes error frames.
  - grabAndSaveFrame
```
protected java.io.File grabAndSaveFrame(java.io.File directory,
                            java.lang.String basename,
                            int index,
                            boolean withCursor)
                                 throws java.io.IOException
```
    Implementation hook to grab and save a frame.
    
    The file format is implementation dependent; the implementation should generate the full name of the save destination file as directory/basenameindex.ext where ext is appropriate for the frame save format.
    
    If the destination file exists it should not be overridden.
    
    Default impl throws an IOException wrapping an UnsupportedOperationException.
    
    Parameters:
    directory - the destination directory or null for current dir
    basename - the file basename
    index - the frame index, or negative if none
    
    Returns:
    the (attempted) save destination file
    
    Throws:
    
    java.io.IOException - (possibly wrapping another exception) if the save fails for any reason, including would overwrite
  - saveFrameFailed
```
protected boolean saveFrameFailed(java.lang.Exception exception)
```
    Called when any frame save fails.
    
    Default impl prints error message to System.err and returns true.
    
    Parameters:
    exception - the error
    
    Returns:
    false iff any ongoing regular-rate frame save should be aborted
  - saveFrameFinished
```
protected boolean saveFrameFinished(java.io.File file)
```
    Called after any frame save is completed or fails.
    
    Default impl returns true.
    
    Parameters:
    file - the attempted save file
    
    Returns:
    false iff any ongoing regular-rate frame save should be aborted
  - pushLocalToWorld
```
protected void pushLocalToWorld()
```
    Push localToWorldRX by copy onto the top of localToWorldStack.
    
    Grows localToWorldStack as necessary, conses then and only then.
    
    If used, this is designed to be confined to the render thread.
  - popLocalToWorld
```
protected boolean popLocalToWorld(boolean alwaysUpdate)
```
    Pop the top transform off localToWorldStack and set it by copy to localToWorldRX, then updateCMT() iff changed or alwaysUpdate.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    alwaysUpdate - whether to always updateCMT() even if localToWorldRX unchanged
    
    Returns:
    true iff the transform changed
    
    Throws:
    
    java.lang.IllegalStateException - if localToWorldStack is currently empty
  - popLocalToWorld
```
protected boolean popLocalToWorld()
```
    popLocalToWorld(boolean) not alwaysUpdate
  - prependLocalToWorld
```
protected boolean prependLocalToWorld(RX rx,
                          boolean alwaysUpdate)
```
    Prepend rx to localToWorldRX, then updateCMT() iff changed or alwayUpdate.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    alwaysUpdate - whether to always updateCMT() even if localToWorldRX unchanged
    
    Returns:
    true iff the transform changed
  - prependLocalToWorld
```
protected boolean prependLocalToWorld(RX rx)
```
    prependLocalToWorld(RX, boolean) not alwaysUpdate
  - prependInverseLocalToWorld
```
protected boolean prependInverseLocalToWorld(RX rx,
                                 boolean alwaysUpdate)
```
    Prepend rx^{-1} to localToWorldRX, then updateCMT() iff changed.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    alwaysUpdate - whether to always updateCMT() even if localToWorldRX unchanged
    
    Returns:
    true iff the transform changed
  - prependInverseLocalToWorld
```
protected boolean prependInverseLocalToWorld(RX rx)
```
    prependInverseLocalToWorld(RX, boolean) not alwaysUpdate.
  - setLocalToWorld
```
protected boolean setLocalToWorld(RX rx,
                      boolean alwaysUpdate)
```
    Set identity localToWorldRX by copy, then updateCMT() iff changed or alwaysUpdate.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    alwaysUpdate - whether to always updateCMT() even if localToWorldRX unchanged
    
    Returns:
    true iff the transform changed
  - setLocalToWorld
```
protected boolean setLocalToWorld(RX rx)
```
    setLocalToWorld(RX, boolean) not alwaysUpdate
  - clearLocalToWorld
```
protected boolean clearLocalToWorld(boolean alwaysUpdate)
```
    Set identity localToWorldRX, then updateCMT() iff changed or alwaysUpdate.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    alwaysUpdate - whether to always updateCMT() even if localToWorldRX unchanged
    
    Returns:
    true iff the transform changed
  - clearLocalToWorld
```
protected boolean clearLocalToWorld()
```
    clearLocalToWorld(boolean) not alwaysUpdate
  - updateWorldToView
```
protected boolean updateWorldToView(boolean toWaypoint)
```
    Updates worldToViewRX and worldToViewScale from rxsInteractor, then updateCMT() iff changed.
    
    If used, this is designed to be confined to the render thread.
    
    Calls worldToViewChanged() iff the transform changed.
    
    Parameters:
    toWaypoint - if true then the acquired world-to-view transform will be that of the next view waypoint, which may be different than the current effective transform if an interpolation is ongoing. If false then the current effective transform is acquired.
    
    Returns:
    true iff the transform changed
  - updateWorldToView
```
protected boolean updateWorldToView()
```
    covers updateWorldToView(boolean), always to current
  - updateCMT
```
protected void updateCMT()
```
    Set cmtRX and cmtScale as the concatenation of localToWorldRX, worldToViewScale, and worldToViewRX, in that order, then applyCMT().
    
    If used, this is designed to be confined to the render thread.
  - setCMT
```
protected void setCMT(RX cmtRX,
          float cmtScale)
```
    Set cmtRX and cmtScale by copy, then applyCMT().
    
    Note that this is a low-level method; if you are making use of localToWorldRX, worldToViewRX, and worldToViewScale then normally you would call updateCMT() instead.
  - clearCMT
```
protected void clearCMT()
```
    Set cmtRX and cmtScale to identity, then applyCMT().
    
    Subsequent drawing will thus be in view frame.
  - updateProjection
```
protected boolean updateProjection(float canvasWidth,
                       float canvasHeight,
                       float viewToCanvasScale)
```
    Recomputes viewAABB from canvasWidth, canvasHeight, and viewToCanvasScale.
    
    Also updates the cached canvasSize and flags applyProjectionPending, which will trigger an applyProjection() at th next generic render().
    
    Calls projectionChanged() iff the transform changed.
    
    Parameters:
    canvasWidth - the new canvas width, or non-positive to use the current cached value
    canvasHeight - the new canvas height, or non-positive to use the current cached value
    viewToCanvasScale - the new view to canvas scale, or non-positive to use the current value
    
    Returns:
    true iff the transform changed
  - recenterZ
```
public float recenterZ(boolean jump)
```
    Move the viewpoint so that the current rotation center is on the z plane midway between the front and rear clip planes.
    
    Note that the next waypoint will not be engaged till rxsInteractor is jumped or interpolated.
    
    Parameters:
    jump - if true then jump to the new viewpoint, otherwise interpolate
    
    Returns:
    the view frame z coordinate of the plane midway between the front and rear clip planes
  - recenterZ
```
public float recenterZ()
```
    covers recenterZ(boolean), always interpolates
  - getZCenterInView
```
public float getZCenterInView()
```
    Get the z coordinate of the center of viewAABB in view frame.
  - navigateToView
```
public void navigateToView(RX localToWorld,
                  boolean setRotationCenter,
                  boolean setDefaultView,
                  boolean setDefaultRotationCenter,
                  boolean jump)
```
    Navigate to a viewpoint that aligns the coordinate frame identified by cmt with the view frame.
    
    Parameters:
    localToWorld - transform taking object coordinates to world coordinates
    setRotationCenter - whether to also set the navigation rotation center to the origin of the coordinate frame identified by localToWorld
    setDefaultView - whether to also make the new view the default view
    setDefaultRotationCenter - whether to also make the origin of the frame identified by localToWorld the default rotation center
    jump - if true then jump to the new viewpoint, otherwise interpolate
  - navigateToView
```
public void navigateToView(RX localToWorld,
                  boolean setRotationCenter,
                  boolean setDefaultView,
                  boolean setDefaultRotationCenter)
```
    navigateToView(RX, boolean, boolean, boolean, boolean), always interpolates.
  - navigateToView
```
public void navigateToView(RX localToWorld,
                  boolean setRotationCenter)
```
    navigateToView(RX, boolean, boolean, boolean, boolean), always interpolates, does not set defaults.
  - navigateToView
```
public void navigateToView(RX localToWorld)
```
    navigateToView(RX, boolean, boolean, boolean, boolean), always interpolates, does not set rotation center or defaults.
  - navigateToDefaultView
```
public void navigateToDefaultView(boolean resetRotationCenter,
                         boolean jump)
```
    Navigate to getDefaultViewTXEM(), getDefaultViewScale().
    
    Parameters:
    resetRotationCenter - if true then the rotation center is set to getDefaultRotationCenter()
    jump - if true then jump to the new viewpoint, otherwise interpolate
  - navigateToDefaultView
```
public void navigateToDefaultView(boolean resetRotationCenter)
```
    Covers navigateToDefaultView(boolean, boolean), always interpolates.
  - navigateToDefaultView
```
public void navigateToDefaultView()
```
    Covers navigateToDefaultView(boolean, boolean), never resets rotaion center and always interpolates.
  - rotateAboutDefaultCenter
```
public void rotateAboutDefaultCenter()
```
    Set the navigation rotation center to defaultRotationCenter.
  - getDefaultRotationCenter
```
public double[] getDefaultRotationCenter()
```
    Get the default rotation center in world frame, defaul impl returns defaultRotationCenter.
  - setDefaultRotationCenter
```
public void setDefaultRotationCenter(double... rc)
```
    Set the default rotation center in world frame as returned by the default impl of getDefaultRotationCenter().
    
    Parameters:
    rc - the new default rotation center in world frame or null for origin
  - getDefaultViewTXEM
```
public double[] getDefaultViewTXEM()
```
    Get the default world-to-view TXEM vector.
    
    Default impl returns defaultViewTXEM if not null, otherwise identity except that z is backed off so that the world frame origin is at the center of the view volume.
  - setDefaultViewTXEM
```
public void setDefaultViewTXEM(double... txem)
```
    Set the default world-to-view TXEM vector as returned by the default impl of getDefaultViewTXEM().
    
    Parameters:
    txem - the new default view-to-world TXEM vector or null to use default as described in getDefaultViewTXEM()
  - setDefaultViewTXEMS
```
public void setDefaultViewTXEMS(double... txems)
```
    setDefaultViewTXEM(double...) and setDefaultViewScale(double)
  - setDefaultViewScale
```
public void setDefaultViewScale(double scale)
```
    Set defaultViewScale.
    
    Parameters:
    scale - the new default world-to-view scale or null to use default as described in getDefaultViewScale()
  - getDefaultViewScale
```
public double getDefaultViewScale()
```
    Get default world-to-view scale, used by navigateToDefaultView(boolean, boolean), default impl returns defaultViewScale if not NaN, else DEF_VIEW_SCALE.
  - setDefaultView
```
public void setDefaultView(RX rx,
                  double scale)
```
    Set the default world-to-view transform as returned by the default impl of getDefaultViewTXEM().
    
    Parameters:
    rx - the new default view-to-world transform or null to use default as described in getDefaultViewTXEM()
    scale - the new default world-to-view scale or null to use default as described in getDefaultViewScale()
  - fitView
```
public void fitView()
```
    Request a doFit().
    
    This sets fitPending. The generic render() implementation will then do a doFit() with at its next call.
  - worldToViewDirty
```
public boolean worldToViewDirty()
```
    check if a navigation update is waiting to be applied
  - setZClip
```
public boolean setZClip(float near,
               float far)
```
    Set the near and far planes of the view volume in view frame.
    
    Calls projectionChanged() iff the new values differ from the old.
    
    Returns:
    true iff the new values differ from the old
  - setSymmetricZClip
```
public boolean setSymmetricZClip(float depth)
```
    setZClip(float, float) symmetrically for a total span of depth
  - setViewToCanvasScale
```
public boolean setViewToCanvasScale(float viewToCanvasScale)
```
    Set viewToCanvasScale.
    
    Calls projectionChanged() iff the new values differ from the old.
    
    Parameters:
    viewToCanvasScale - the new scale, must be positive
    
    Returns:
    true iff the new values differ from the old
  - getViewToCanvasScale
```
public float getViewToCanvasScale()
```
    get current viewToCanvasScale
  - setViewInMeters
```
public boolean setViewInMeters()
```
    setViewToCanvasScale(float) to 1.0f/SCREEN_METERS_PER_PIXEL.
  - setViewInPixels
```
public boolean setViewInPixels()
```
    setViewToCanvasScale(float) to 1.0f
  - isSphereVisible
```
public boolean isSphereVisible(float[] centerInView,
                      float radiusInView)
```
    Check if a view-frame sphere intersects the view volume.
    
    Parameters:
    centerInView - the center of the sphere in view frame
    radiusInView - the radius of the sphere in view frame, non-negative
  - pickSphereInView
```
public float pickSphereInView(float[] pickStart,
                     float[] pickExtent,
                     float[] center,
                     float radius,
                     boolean checkOnly)
```
    Check if a view-frame sphere and pick segment intersect.
    
    Note that the intersection may be outside the view volume.
    
    Parameters:
    pickStart - the view frame coordinates of the start of the pick segment
    pickExtent - the extent of the pick segment relative to pickStart in view frame
    center - the center of the sphere in view frame
    radius - the radius of the sphere in view frame, non-negative
    
    Returns:
    the signed coordinate of the intersection along the pick segment, normalized to the segment length, or NaN if no intersection
  - pickSphereInView
```
public float pickSphereInView(float[] center,
                     float radius,
                     boolean checkOnly)
```
    Covers pickSphereInView(float[], float[], float[], float, boolean) using current pickStartInView and pickExtentInView.
  - setPickSegmentInView
```
public void setPickSegmentInView(float[] start,
                        float[] extent)
```
    Set the pick segment in view frame.
    
    The pick segment is considered un-set if any of it is NaN.
    
    Parameters:
    start - the start point of the pick segment, if any element is NaN then all should be NaN
    extent - the extent of the pick segment, nonzero, if any element is NaN then all elements of both extent and start should be NaN
  - setPickPointOnCanvas
```
public void setPickPointOnCanvas(float x,
                        float y)
```
    Convenience to setPickSegmentInView(float[], float[]) given a location on the canvas in pixels.
    
    The pick segment will span the view frustum in Z and will pierce the indicated canvas pixel.
  - unsetPickSegment
```
public void unsetPickSegment()
```
    un-set the pick segment
  - isPickSegmentSet
```
public boolean isPickSegmentSet()
```
    check if the pick segment is set
  - interpolateOnPickSegmentInView
```
public float[] interpolateOnPickSegmentInView(float u,
                                     float[] p)
```
    Compute the coordinates of a point on the pick segment in view frame, or NaN if un-set.
  - interpolateOnPickSegmentInView
```
public float[] interpolateOnPickSegmentInView(float u)
```
    interpolateOnPickSegmentInView(float, float[]), conses
  - interpolateOnPickSegmentInLocal
```
public float[] interpolateOnPickSegmentInLocal(float u,
                                      float[] p)
```
    similar to interpolateOnPickSegmentInView(float, float[])
  - interpolateOnPickSegmentInLocal
```
public float[] interpolateOnPickSegmentInLocal(float u)
```
    interpolateOnPickSegmentInLocal(float, float[]), conses
  - localToWorld
```
protected float[] localToWorld(boolean doRotate,
                   boolean doTranslate,
                   float... v)
```
    Transform a 3D vector v from local frame to world frame by applying localToWorldRX.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    doRotate - whether to apply the rotation
    doTranslate - whether to apply the translation
    
    Returns:
    a reference to v
  - localToWorld
```
protected float[] localToWorld(float... v)
```
    covers localToWorld(boolean, boolean, float...), does both transformations
  - worldToLocal
```
protected float[] worldToLocal(boolean doRotate,
                   boolean doTranslate,
                   float... v)
```
    inverse of localToWorld(boolean, boolean, float...)
  - worldToLocal
```
protected float[] worldToLocal(float... v)
```
    covers worldToLocal(boolean, boolean, float...), does both transformations
  - worldToView
```
public float[] worldToView(boolean doScale,
                  boolean doRotate,
                  boolean doTranslate,
                  float... v)
```
    Transform a 3D vector v from world frame to view frame by applying worldToViewScale and worldToViewRX.
    
    Parameters:
    doScale - whether to apply the scaling
    doRotate - whether to apply the rotation
    doTranslate - whether to apply the translation
    
    Returns:
    a reference to v
  - worldToView
```
public float[] worldToView(float... v)
```
    covers worldToView(boolean, boolean, boolean, float...), does all three transformations
  - worldToView
```
public float worldToView(float length)
```
    applies worldToViewScale
  - viewToWorld
```
public float[] viewToWorld(boolean doScale,
                  boolean doRotate,
                  boolean doTranslate,
                  float... v)
```
    inverse of worldToView(boolean, boolean, boolean, float...)
  - viewToWorld
```
public float[] viewToWorld(float... v)
```
    covers viewToWorld(boolean, boolean, boolean, float...), does all three transformations
  - viewToWorld
```
public float viewToWorld(float length)
```
    applies worldToViewScale^{-1}
  - localToView
```
protected float[] localToView(boolean doScale,
                  boolean doRotate,
                  boolean doTranslate,
                  float... v)
```
    Transform a 3D vector v from local frame to view frame, i.e. by applying localToWorldRX, worldToViewScale, and worldToViewRX, in that order.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    doScale - whether to apply the scaling
    doRotate - whether to apply the rotation
    doTranslate - whether to apply the translation
    
    Returns:
    a reference to v
  - localToView
```
protected float[] localToView(float... v)
```
    Covers localToView(boolean, boolean, boolean, float...), does all three transformations
  - localToView
```
protected float localToView(float length)
```
    Applies cmtScale.
    
    If used, this is designed to be confined to the render thread.
  - viewToLocal
```
protected float[] viewToLocal(boolean doScale,
                  boolean doRotate,
                  boolean doTranslate,
                  float... v)
```
    inverse of localToView(boolean, boolean, boolean, float...)
  - viewToLocal
```
protected float[] viewToLocal(float... v)
```
    covers viewToLocal(boolean, boolean, boolean, float...), does all three transformations
  - viewToLocal
```
protected float viewToLocal(float length)
```
    Applies cmtScale^{-1}.
    
    If used, this is designed to be confined to the render thread.
  - canvasToView
```
public float[] canvasToView(float... point)
```
    Transform a point in canvas frame to view frame by applying the projection transform.
    
    See class header doc for the definition of camera frame.
    
    Parameters:
    point - a 2D or 3D point in canvas frame, will be transformed in-place
    
    Returns:
    a reference to point
  - canvasToView
```
public float canvasToView(float length)
```
    applies the projection transform
  - viewToCanvas
```
public float[] viewToCanvas(float... point)
```
    opposite of canvasToView(float...)
  - viewToCanvas
```
public float viewToCanvas(float length)
```
    applies the projection transform
  - localToCanvas
```
protected float[] localToCanvas(float... point)
```
    Applies cmt and projection transforms.
    
    If used, this is designed to be confined to the render thread.
  - localToCanvas
```
protected float localToCanvas(float length)
```
    Applies cmt and projection transforms.
    
    If used, this is designed to be confined to the render thread.
  - canvasToLocal
```
protected float[] canvasToLocal(float... point)
```
    Applies projection^{-1} and cmt^{-1} transforms.
    
    If used, this is designed to be confined to the render thread.
  - canvasToLocal
```
protected float canvasToLocal(float length)
```
    Applies projection^{-1} and cmt^{-1} transforms.
    
    If used, this is designed to be confined to the render thread.
  - getTranslationRXToPixel
```
public RX getTranslationRXToPixel(RX localFrameCMT,
                         java.awt.Point pixel,
                         RX ret)
```
    Compute translation which takes (0, 0, 0) to the nearest point on the ray through pixel to the origin of a local frame.
    
    Parameters:
    localFrameCMT - transform taking local frame coordinates to world frame, or null to use identity
    pixel - the canvas pixel coordinates or null to use (0, 0)
    ret - the computed translation is set as the translation part of this transform. The rotation part is not modified. If null a new identity transform is consed.
  - getTranslationRXToPixel
```
public RX getTranslationRXToPixel(RX localFrameCMT,
                         RX ret)
```
    getTranslationRXToPixel(RX, Point, RX), uses current mouse position or (0, 0) if mouse not on canvas.
  - getTranslationRXToPixel
```
public RX getTranslationRXToPixel(RX localFrameCMT,
                         java.awt.Point pixel)
```
    getTranslationRXToPixel(RX, Point, RX), conses
  - getTranslationRXToPixel
```
public RX getTranslationRXToPixel(RX localFrameCMT)
```
    getTranslationRXToPixel(RX, Point, RX), uses current mouse position or (0, 0) if mouse not on canvas, conses.
  - getLocalTranslationRXToPixel
```
protected RX getLocalTranslationRXToPixel(java.awt.Point pixel,
                              RX ret)
```
    getTranslationRXToPixel(RX, Point) using the current localToWorldRX.
    
    If used, this is designed to be confined to the render thread.
  - getLocalTranslationRXToPixel
```
protected RX getLocalTranslationRXToPixel(RX ret)
```
    getLocalTranslationRXToPixel(Point, RX), uses current mouse position or (0, 0) if mouse not on canvas.
  - getLocalTranslationRXToPixel
```
protected RX getLocalTranslationRXToPixel(java.awt.Point pixel)
```
    getLocalTranslationRXToPixel(Point, RX), conses
  - getLocalTranslationRXToPixel
```
protected RX getLocalTranslationRXToPixel()
```
    getLocalTranslationRXToPixel(Point, RX), uses current mouse position or (0, 0) if mouse not on canvas, conses.
  - setBackgroundColor
```
public abstract void setBackgroundColor(float... color)
```
    concrete subclasses must implement this to set the background color
  - setAmbientLightIntensity
```
public abstract void setAmbientLightIntensity(float intensity)
```
    concrete subclasses must implement to set ambient light intensity
  - setDirectionalLightIntensity
```
public abstract void setDirectionalLightIntensity(float intensity)
```
    concrete subclasses must implement to set directional light intensity
  - setDirectionalLightDirection
```
public abstract void setDirectionalLightDirection(float... direction)
```
    concrete subclasses must implement to set directional light direction
  - setHighlightFactor
```
public void setHighlightFactor(float factor)
```
    set highlightFactor
  - updateHighlightedMaterial
```
protected void updateHighlightedMaterial()
```
    Update defaultHighlightedMaterial from highlightFactor and highlightColor.
  - getHighlightFactor
```
public float getHighlightFactor()
```
    get highlightFactor
  - setHighlightColor
```
public void setHighlightColor(float... color)
```
    set highlightColor
  - getHighlightColor
```
public float[] getHighlightColor(float[] color)
```
    get highlightColor
  - getHighlightColor
```
public float[] getHighlightColor()
```
    covers getHighlightColor(float[]), always conses
  - setAmbientAlpha
```
public void setAmbientAlpha(float alpha)
```
    set ambientAlpha
  - getAmbientAlpha
```
public float getAmbientAlpha()
```
    get ambientAlpha
  - setMaskAlpha
```
public void setMaskAlpha(float alpha)
```
    set maskAlpha
  - getMaskAlpha
```
public float getMaskAlpha()
```
    get maskAlpha
  - setPickThresholdPixels
```
public void setPickThresholdPixels(float threshold)
```
    set pickThresholdPixels
  - getPickThresholdPixels
```
public float getPickThresholdPixels()
```
    get pickThresholdPixels
  - getNumFrames
```
public int getNumFrames()
```
    get numFrames
  - enableDrawing
```
public void enableDrawing(boolean enable)
```
    set enableDrawing(boolean)
  - isDrawingEnabled
```
public boolean isDrawingEnabled()
```
    get enableDrawing(boolean)
  - enablePicking
```
public void enablePicking(boolean enable)
```
    set enablePicking(boolean)
  - isPickingEnabled
```
public boolean isPickingEnabled()
```
    get enablePicking(boolean)
  - enableDepthSortTransparent
```
public void enableDepthSortTransparent(boolean enable)
```
    set enableDepthSortTransparent(boolean)
  - isDepthSortTransparentEnabled
```
public boolean isDepthSortTransparentEnabled()
```
    get enableDepthSortTransparent(boolean)
  - enableHighlighting
```
public void enableHighlighting(boolean enable)
```
    set enableHighlighting(boolean)
  - isHighlightingEnabled
```
public boolean isHighlightingEnabled()
```
    get enableHighlighting(boolean)
  - enableMasking
```
public void enableMasking(boolean enable)
```
    set enableMasking(boolean)
  - isMaskingEnabled
```
public boolean isMaskingEnabled()
```
    get enableMasking(boolean)
  - enableFrustumCull
```
public void enableFrustumCull(boolean enable)
```
    set enableFrustumCull(boolean)
  - isFrustumCullEnabled
```
public boolean isFrustumCullEnabled()
```
    get enableFrustumCull(boolean)
  - enableNavigation
```
public void enableNavigation(boolean enable)
```
    set navigationEnabled
  - isNavigationEnabled
```
public boolean isNavigationEnabled()
```
    get navigationEnabled
  - enableDBGSceneExtents
```
public void enableDBGSceneExtents(boolean enable)
```
    set dbgSceneExtentsEnabled
  - enableEnsureWidgetBoundingSpheresInView
```
public void enableEnsureWidgetBoundingSpheresInView(boolean enable)
```
    set ensureWidgetBoundingSpheresInViewEnabled
  - dumpPickSegment
```
public void dumpPickSegment(java.io.PrintStream s)
```
    dump pick segment in view
  - dumpPickSegment
```
public void dumpPickSegment()
```
    dumpPickSegment(PrintStream) to System.out
  - dumpSceneMetrics
```
public void dumpSceneMetrics(java.io.PrintStream s)
```
    Dumps scene metrics.
    
    Note that this API is asynchronous; the dump will be produced at the end of the next generic render cycle.
  - dumpSceneMetricsImpl
```
protected void dumpSceneMetricsImpl(java.io.PrintStream s)
```
    Impl of dumpSceneMetrics(java.io.PrintStream), run at end of generic render when dumpSceneMetricsPending is set.
  - dumpSceneMetrics
```
public void dumpSceneMetrics()
```
    dumpSceneMetrics(PrintStream) to System.out
  - dumpAABB
```
protected void dumpAABB(float[][] aabb,
            java.lang.String msg,
            java.io.PrintStream s)
```
    dump the coords of an axis aligned bounding box
  - dumpRenderMetrics
```
public void dumpRenderMetrics(java.io.PrintStream s)
```
    Dumps the *FrameTime* fields and related.
    
    Note that this API is asynchronous; the dump will be produced at the end of the next generic render cycle.
  - dumpRenderMetricsImpl
```
protected void dumpRenderMetricsImpl(java.io.PrintStream s)
```
    Impl of dumpRenderMetrics(java.io.PrintStream), run at end of generic render when dumpRenderMetricsPending is set.
  - dumpRenderMetrics
```
public void dumpRenderMetrics()
```
    dumpRenderMetrics(PrintStream) to System.out
  - resetRenderMetrics
```
public void resetRenderMetrics()
```
    Resets the render metrics.
    
    Note that this API is asynchronous; the metrics will be reset at the beginning of the next generic render cycle.
  - resetRenderMetricsImpl
```
protected void resetRenderMetricsImpl()
```
    Impl of resetRenderMetrics(), run at beginning of generic render when resetRenderMetricsPending is set.
  - getAvgRecentFPS
```
public double getAvgRecentFPS()
```
    Get the avg recent FPS according to the recentCycleTime metrics, which are maintained by the generic render()er.
    
    Returns:
    the average of the recent cycle times or 0.0 if no frame cycles have been completed yet
  - dumpProjection
```
public void dumpProjection(java.io.PrintStream s)
```
    dump the current projection parameters
  - dumpProjection
```
public void dumpProjection()
```
    dumpProjection(PrintStream) to System.out
  - dumpWorldToView
```
public void dumpWorldToView(java.io.PrintStream s)
```
    dumps the current world-to-view transform
  - dumpWorldToView
```
public void dumpWorldToView()
```
    dumpWorldToView(PrintStream) to System.out
  - dumpCMT
```
public void dumpCMT(java.io.PrintStream s)
```
    Dumps the current composite model transform taking local coordinates to view coordinates.
  - dumpCMT
```
public void dumpCMT()
```
    dumpCMT(PrintStream) to System.out
  - dumpLocalToWorld
```
protected void dumpLocalToWorld(java.io.PrintStream s)
```
    Dump the current local-to-world transform.
    
    If used, this is designed to be confined to the render thread.
  - dumpLocalToWorld
```
protected void dumpLocalToWorld()
```
    dumpLocalToWorld(PrintStream) to System.out
  - dumpCanvasProperties
```
public void dumpCanvasProperties(java.io.PrintStream s)
```
    dumps properties of canvas
  - dumpCanvasProperties
```
public void dumpCanvasProperties()
```
    dumpCanvasProperties(PrintStream) to System.out
  - dumpInteractor
```
public void dumpInteractor(java.io.PrintStream s)
```
    dumps rxsInteractor and its RXSInterpolator
  - dumpHelp
```
public void dumpHelp(java.io.PrintStream s,
            java.lang.String meters)
```
    RXSInteractor.dumpHelp(PrintStream, String, String, String, String, String, String).
  - dumpHelp
```
public void dumpHelp(java.lang.String meters)
```
    dumpHelp(PrintStream, String) to System.out
  - dumpHelp
```
public void dumpHelp(java.io.PrintStream s)
```
    dumpHelp(PrintStream, String) using "meters"
  - dumpHelp
```
public void dumpHelp()
```
    dumpHelp(PrintStream, String) to System.out using "meters"
  - dumpInteractor
```
public void dumpInteractor()
```
    dumpInteractor(PrintStream) to System.out
  - dumpStats
```
public void dumpStats(java.io.PrintStream s)
```
    dumpSceneMetrics(java.io.PrintStream), dumpRenderMetrics(java.io.PrintStream)
  - dumpStats
```
public void dumpStats()
```
    dumpStats(PrintStream) to System.out
  - dump
```
public void dump(java.io.PrintStream s)
```
    dump everything
  - dump
```
public void dump()
```
    dump(PrintStream) to System.out
  - setLongFrameWarningThreshold
```
public void setLongFrameWarningThreshold(float threshold)
```
    Set the threshold in ms above whidh a warning will be issued for long frame render times.
    
    Parameters:
    threshold - the threshold in ms or NaN to disable
  - disableLongFrameWarningThreshold
```
public void disableLongFrameWarningThreshold()
```
    Disable the long-frame warning threshold, see setLongFrameWarningThreshold(float).
  - traceNextFrame
```
public void traceNextFrame(boolean tracePicking,
                  boolean traceRenderer)
```
    Enable tracing for next frame with given options.
    
    Note: if tracePicking is set then the trace will be deferred until the next frame with picking.
    
    Parameters:
    traceRenderer - whether to emit render algorithm dbg
    tracePicking - whether to emit pick algorithm dbg
  - setTraceOptions
```
protected void setTraceOptions(int baseFlags,
                   boolean... options)
```
    Accumulate options as a bitfield, in order starting with LSB, on top of baseFlags, and then setTraceFlags(int).
  - setTraceOptions
```
protected void setTraceOptions(boolean... options)
```
    covers setTraceOptions(int, boolean...), no base flags
  - setTraceFlags
```
protected void setTraceFlags(int flags)
```
    hook to set traceFlags
  - getAllRenderTraceFlags
```
protected int getAllRenderTraceFlags()
```
    Hook to get combination of all trace flags that apply to the render algorithm.
  - traceNextFrame
```
public void traceNextFrame()
```
    Like traceNextFrame(boolean, boolean) but only traces renderer.
  - traceNextPickingFrame
```
public void traceNextPickingFrame()
```
    Like traceNextFrame(boolean, boolean) but only traces picking.
  - render
```
public void render()
```
    The generic renderer.
    
    See class header doc for features and details.
    
    Default impl does resetPendingMetrics(), renderImpl(), dumpPendingMetrics().
  - resetPendingMetrics
```
protected boolean resetPendingMetrics()
```
    Reset any metrics that need it.
    
    Returns:
    true if any metrics were reset
  - dumpPendingMetrics
```
protected boolean dumpPendingMetrics()
```
    Dump any metrics that need it.
    
    Returns:
    true if any metrics were dumped
  - renderImpl
```
protected void renderImpl()
```
    actual implementation of render()
  - addToSceneMetrics
```
protected void addToSceneMetrics(float[] boundingSphereCenterInView,
                     float boundingSphereRadiusInView,
                     boolean culled,
                     boolean transparent,
                     boolean highlighted,
                     boolean masked,
                     boolean pickable)
```
    Add the information for a geometry to the scene metrics.
    
    Parameters:
    boundingSphereCenterInView - the view frame center of the geometry or null if not known
  - resetSceneMetrics
```
protected void resetSceneMetrics(boolean resetPickMetrics)
```
    Resets scene metrics, the generic render implementation does this at the beginning of each render.
  - resetPickMetrics
```
protected void resetPickMetrics()
```
    resets pick metrics
  - applyProjection
```
protected abstract void applyProjection()
```
    Subclasses must implement this to engage viewAABB so that it is applied to subsequent drawing.
    
    The default render() impl calls this while holding projectionLock.
  - applyCMT
```
protected abstract void applyCMT()
```
    Subclasses must implement this to engage cmtRX and cmtScale so that they are applied to subsequent drawing.
    
    Implementations may choose to short circuit unless drawingEnabled.
    
    Remember to synchronize on rxsInteractor while accessing cmtRX and cmtScale.
  - clearDrawingBuffer
```
protected abstract void clearDrawingBuffer()
```
    subclasses must implement this to clear the render buffer
  - swapBuffers
```
protected abstract void swapBuffers()
```
    subclasses must implement this to swap display buffers
  - renderScene
```
protected void renderScene()
```
    Hook called from generic render() to actually render the scene.
    
    The CMT at time of call will be the world-to-view transform; local-to-world is initialized to identity.
    
    No Display3D locks are held at time of call.
    
    Default impl does nothing.
  - renderInView
```
protected void renderInView()
```
    Hook called from generic render() to render geometry in view frame.
    
    Default impl does nothing.
  - preRender
```
protected void preRender()
```
    Hook called at beginning of generic render().
    
    Default impl does nothing.
  - postScene
```
protected void postScene()
```
    Hook called from generic render() after renderScene().
    
    Default impl does nothing.
  - postMasking
```
protected void postMasking(int numMaskedGeometries)
```
    Hook called from generic render() after masking pass.
    
    Default impl does nothing.
  - preSwap
```
protected void preSwap()
```
    Hook called from generic render() before swapBuffers().
    
    Default impl does nothing.
  - postSwap
```
protected void postSwap()
```
    Hook called from generic render() after swapBuffers().
    
    Default impl does nothing.
  - postRender
```
protected void postRender(double frameTimeSoFar)
```
    Hook called at end of generic render().
    
    Default impl does nothing.
  - doFit
```
protected void doFit()
```
    Calls RXSInteractor.fit(double, double, double, double) on the curent sceneAABBInView.
  - render
```
protected void render(Widget w,
          RX extraLocalToWorld)
```
    Render a Widget.
    
    Calls Widget.ensureBoundingSpheresInView() iff ensureWidgetBoundingSpheresInViewEnabled, and updates the widget's bounding spheres in view frame (if present) for each enabled geometry with a valid bounding sphere.
    
    If used, this is designed to be confined to the render thread.
    
    If w.rx it not null and not identity, it is prepended to localToWorldRX and the result is applied as a temporary CMT for rendering w.
    
    Parameters:
    extraLocalToWorld - if not null and not identity, then this is appended to the value of w.rx (which itself is not mutated) before that is prepended to localToWorldRX
  - render
```
protected void render(Widget w)
```
    covers render(Widget, RX), no extra local-to-world transform
  - render
```
protected void render(java.util.List<Widget> widgets)
```
    Render a list of Widgets.
    
    Each Widget that passes renderAccept(Widget) is rendered.
  - renderAccept
```
protected boolean renderAccept(Widget widget)
```
    Filter hook for render(List).
    
    Default impl returns true.
  - render
```
protected void render(javax.media.j3d.Geometry geometry,
          javax.media.j3d.Appearance appearance,
          float[] boundingSphereCenterInView,
          float boundingSphereRadiusInView)
```
    Render geometry in local frame.
    
    Bounding sphere is optional, but frustum cull and depth sort transparent do not apply if there is no bounding sphere.
    
    Applies ambientAlpha, if any.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    geometry - the geometry in local frame
    appearance - the appearance to set, null to use default
    boundingSphereCenterInView - the center of a bounding sphere for geometry in view frame, or null if none
    boundingSphereRadiusInView - the radius of a bounding sphere for geometry centered at boundingSphereCenterInView or negative if none
  - getInfo
```
protected java.lang.String getInfo(javax.media.j3d.Geometry geometry,
                       javax.media.j3d.Appearance appearance)
```
    Get an identifying string for geometry and appearance for use in tracing and dbg.
    
    Default impl calls J3DUtils.getInfo(Geometry).
  - render
```
protected void render(javax.media.j3d.Geometry geometry,
          javax.media.j3d.Appearance appearance)
```
    Covers render(Geometry, Appearance, float[], float), no bounding sphere.
  - render
```
protected void render(javax.media.j3d.Shape3D shape)
```
    renders all geometries of shape
  - render
```
protected void render(javax.media.j3d.Geometry geometry)
```
    Covers render(Geometry, Appearance, float[], float), no bounding sphere and default appearance.
  - renderTransparent
```
protected void renderTransparent(RX cmtRX,
                     float cmtScale,
                     javax.media.j3d.Geometry geometry,
                     javax.media.j3d.Appearance appearance,
                     float extraAlpha,
                     boolean disableDepthWrite)
```
    Render a transparent geometry.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    extraAlpha - if in the range [0.0, 1.0) then this multiplies the alpha used for rendering
    disableDepthWrite - if true then temporarily disable depth buffer write
  - renderTransparent
```
protected void renderTransparent(RX cmtRX,
                     float cmtScale,
                     javax.media.j3d.Geometry geometry,
                     javax.media.j3d.Appearance appearance,
                     float extraAlpha)
```
    Covers renderTransparent(RX, float, Geometry, Appearance, float), always disables depth write.
  - renderTransparent
```
protected void renderTransparent(Display3D.QueuedGeometry queuedGeometry)
```
    Covers renderTransparent(RX, float, Geometry, Appearance, float).
  - renderTransparent
```
protected void renderTransparent(Display3D.QueuedGeometry[] queue,
                     int queueSize)
```
    Hook called from generic render() to render a queue of transparent geometry.
    
    The queue has already been sorted and local-to-world set identity before this hook is called.
    
    Default impl calls renderTransparent(QueuedGeometry) for each geometry in the queue.
  - isTransparent
```
protected boolean isTransparent(javax.media.j3d.Geometry geometry,
                    javax.media.j3d.Appearance appearance)
```
    Hook that render(Geometry, Appearance, float[], float) uses to determine whether a geometry/appearance combination should be categorized as transparent.
    
    Default impl returns true iff
    - appearance is non-null and has a non-null TransparencyAttributes with a non-zero transparency
    - appearance is null and geometry is a JOGLGeometry that JOGLGeometry.hasAlpha().
    - appearance is null and geometry is a GeometryArray including COLOR_4 and/or TEXTURE_COORDINATE_4 in its vertex format.
  - enqueueTransparentGeometry
```
protected void enqueueTransparentGeometry(RX cmtRX,
                              float cmtScale,
                              javax.media.j3d.Geometry geometry,
                              javax.media.j3d.Appearance appearance,
                              float maxViewZ,
                              float ambientAlpha)
```
    Add an item to the transparentQueue, unless freezeTransparentQueue is set.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    cmtRX - the rigid part of the CMT, or null to use the current cmtRX
    cmtScale - the scale part of the CMT, if cmtRX is null then the current cmtScale is used instead
  - enqueue
```
protected Display3D.QueuedGeometry[] enqueue(RX cmtRX,
                                 float cmtScale,
                                 javax.media.j3d.Geometry geometry,
                                 javax.media.j3d.Appearance appearance,
                                 float maxViewZ,
                                 float ambientAlpha,
                                 Display3D.QueuedGeometry[] queue,
                                 int queueSize)
```
    Implmentation of enqueueTransparentGeometry(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance, float, float) and enqueueMaskedGeometry(javax.media.j3d.Geometry, javax.media.j3d.Appearance, float).
    
    Automatically conses or grows the queue as necessary. The implementation only does heap allocations when the queue capacity needs to change.
    
    If used, this is designed to be confined to the render thread.
    
    Parameters:
    cmtRX - the rigid part of the CMT, or null to use the current cmtRX
    cmtScale - the scale part of the CMT, if cmtRX is null then the current cmtScale is used instead
  - clearQueue
```
protected void clearQueue(Display3D.QueuedGeometry[] queue,
              int queueSize)
```
    clears the geometry and appearance refs in a queue
  - compareQueued
```
protected int compareQueued(Display3D.QueuedGeometry a,
                Display3D.QueuedGeometry b)
```
    Implementation of Display3D.QueuedGeometry.compareTo(vona.ui.Display3D.QueuedGeometry).
    
    Default impl is the sort order of the Display3D.QueuedGeometry.maxViewZ. Subclasses can override this to implement other orderings.
    
    Returns:
    -1, 0, or +1 as a is behind, equal to, or in front of b
  - render
```
protected void render(Display3D.QueuedGeometry[] queue,
          int queueSize)
```
    Render a queue of geometry.
    
    The queue is rendered in order. Picking, frustum cull, and scene metrics collection are not performed; typically these steps would have been done before the geometry was enqueued, e.g. in render(Geometry, Appearance, float[], float).
    
    Any transparent geometry is not rendered immediately, but rather re-enqueued to transparentQueue. Highlighed geometry is passed to renderHighlighted(vona.math.RX, float, javax.media.j3d.Geometry, javax.media.j3d.Appearance).
  - isHighlighted
```
protected boolean isHighlighted(javax.media.j3d.Geometry geometry,
                    javax.media.j3d.Appearance appearance)
```
    Hook that generic renderer uses to determine whether a geometry/appearance combination should be categorized as highlighted, if highlightingEnabled.
    
    Default impl returns false.
  - renderHighlighted
```
protected void renderHighlighted(RX cmtRX,
                     float cmtScale,
                     javax.media.j3d.Geometry geometry,
                     javax.media.j3d.Appearance appearance)
```
    Hook called from generic render() to render a highlighted geometry.
    
    Default impl temporarily changes emissive color and then renders geometry.
    
    If used, this is designed to be confined to the render thread.
  - isMasked
```
protected boolean isMasked(javax.media.j3d.Geometry geometry,
               javax.media.j3d.Appearance appearance)
```
    Hook that generic renderer uses to determine whether a geometry/appearance combination should be categorized as masked, if maskingEnabled.
    
    Default impl returns false.
  - enqueueMaskedGeometry
```
protected void enqueueMaskedGeometry(javax.media.j3d.Geometry geometry,
                         javax.media.j3d.Appearance appearance,
                         float maxViewZ)
```
    Add an item to the maskedQueue.
    
    If used, this is designed to be confined to the render thread.
  - renderDepthOnly
```
protected void renderDepthOnly(RX cmtRX,
                   float cmtScale,
                   javax.media.j3d.Geometry geometry,
                   javax.media.j3d.Appearance appearance)
```
    Render only the depth component of a geometry.
    
    Default impl temporarily sets NOOP raster op and then renders geometry.
    
    If used, this is designed to be confined to the render thread.
  - renderDepthOnly
```
protected void renderDepthOnly(Display3D.QueuedGeometry queuedGeometry)
```
    Covers renderDepthOnly(RX, float, Geometry, Appearance).
  - renderDepthOnly
```
protected void renderDepthOnly(Display3D.QueuedGeometry[] queue,
                   int queueSize)
```
    Hook called from generic render() to render a queue of geometry depth-only.
    
    Default impl calls renderDepthOnly(QueuedGeometry) for each geometry in the queue.
  - accumPass
```
protected void accumPass()
```
    Hook called from generic render() to accumulate a rendering pass.
    
    Subclasses that have an accumulation buffer can use this hook to accumulate the current contents of the drawing buffer using passAlpha.
    
    Default impl does nothing.
  - draw
```
protected abstract void draw(RX cmtRX,
        float cmtScale,
        javax.media.j3d.Geometry geometry,
        javax.media.j3d.Appearance appearance,
        float extraAlpha)
```
    Concrete subclasses must implement this to draw geometry.
    
    Parameters:
    cmtRX - the rigid part of the CMT to set prior to drawing, or null to leave the current CMT in effect
    cmtScale - the scale part of the CMT to set prior to drawing, ignored if cmtRX is null
    geometry - the geometry to draw
    appearance - the appearance to set, or null to set the default appearance
    extraAlpha - if in the range [0.0, 1.0) then this multiplies the alpha used for rendering
  - draw
```
protected void draw(RX cmtRX,
        float cmtScale,
        javax.media.j3d.Geometry geometry,
        javax.media.j3d.Appearance appearance)
```
    Covers draw(RX, float, Geometry, Appearance, float).
  - draw
```
protected void draw(javax.media.j3d.Geometry geometry,
        javax.media.j3d.Appearance appearance,
        float extraAlpha)
```
    covers draw(RX, float, Geometry, Appearance, float)
  - draw
```
protected void draw(javax.media.j3d.Geometry geometry,
        javax.media.j3d.Appearance appearance)
```
    Covers draw(RX, float, Geometry, Appearance, float).
  - draw
```
protected void draw(javax.media.j3d.Geometry geometry,
        float extraAlpha)
```
    covers draw(RX, float, Geometry, Appearance, float)
  - draw
```
protected void draw(javax.media.j3d.Geometry geometry)
```
    Covers draw(RX, float, Geometry, Appearance, float).
  - getVertexAccessorFor
```
protected J3DVertexAccessor getVertexAccessorFor(javax.media.j3d.Geometry g,
                                     boolean... enableComponent)
```
    Get a vertex accessor for a geometry.
    
    If used, this is designed to be confined to the render thread.
  - getVertexAccessorFor
```
protected J3DVertexAccessor getVertexAccessorFor(javax.media.j3d.Geometry g)
```
    Covers getVertexAccessorFor(Geometry, boolean...), enables all components.
  - getIndexAccessorFor
```
protected J3DIndexAccessor getIndexAccessorFor(javax.media.j3d.Geometry g)
```
    Get an index accessor for a geometry.
    
    If used, this is designed to be confined to the render thread.
  - getPrimitiveIteratorFor
```
protected J3DPrimitiveIterator getPrimitiveIteratorFor(javax.media.j3d.Geometry g,
                                           boolean... enableComponent)
```
    Get a primitive iterator for a geometry.
    
    If used, this is designed to be confined to the render thread.
  - getPrimitiveIteratorFor
```
protected J3DPrimitiveIterator getPrimitiveIteratorFor(javax.media.j3d.Geometry g)
```
    Covers getPrimitiveIteratorFor(Geometry, boolean...), enables all components.
  - isPickable
```
protected boolean isPickable(javax.media.j3d.Geometry geometry,
                 javax.media.j3d.Appearance appearance)
```
    Check if the given geometry should be considered pickable.
    
    Default impl returns true.
  - getPickCullFace
```
protected int getPickCullFace(javax.media.j3d.Geometry geometry,
                  javax.media.j3d.Appearance appearance)
```
    Hook called by the smaller pickGeometry(...) APIs to get the pick cull face for the given geometry.
    
    Default impl returns the cull face of the PolygonAttributes of appearance, if any, else PolygonAttributes.CULL_BACK.
  - getPickThreshold
```
protected float getPickThreshold(javax.media.j3d.Geometry geometry,
                     javax.media.j3d.Appearance appearance)
```
    Hook called by the smaller pickGeometry(...) APIs to get the pick threshold for the given geometry in local frame.
    
    If used, this is designed to be confined to the render thread.
    
    Default impl returns canvasToLocal(float...) of pickThresholdPixels.
  - updatePickSegmentInLocal
```
protected void updatePickSegmentInLocal()
```
    Update pickStartInLocal and pickExtentInLocal from pickStartInView and pickExtentInView.
    
    Clears pickSegmentInLocalDirty.
  - pickGeometry
```
protected int pickGeometry(javax.media.j3d.Geometry geometry,
               javax.media.j3d.Appearance appearance,
               J3DPrimitiveIterator primitiveIterator,
               float[] pickStart,
               float[] pickExtent,
               float pickThreshold,
               int cullFace)
```
    Perform a geometry pick.
    
    Calls picked(javax.media.j3d.Geometry, javax.media.j3d.Appearance, int, float) for each hit, stopping on the first call that returns false.
    
    The corresponding pick metrics numPickGeometryHits and numPickedGeometries are updated.
    
    Parameters:
    primitiveIterator - the iterator to use, if null then no hits are registered; the iterator is not internally reset at any time
    pickStart - the start of the pick segment in the same frame as the geometry
    pickExtent - the end of the pick segment in the same frame as the geometry
    pickThreshold - the pick threshold distance in the same frame as the geometry
    cullFace - one of PolygonAttributes.CULL_BACK, PolygonAttributes.CULL_FRONT, or PolygonAttributes.CULL_NONE
    
    Returns:
    the number of pick hits registered
  - pickGeometry
```
protected int pickGeometry(javax.media.j3d.Geometry geometry,
               javax.media.j3d.Appearance appearance,
               float[] pickStart,
               float[] pickExtent)
```
    Covers pickGeometry(Geometry, Appearance, J3DPrimitiveIterator, float[], float[], float, int) using getPrimitiveIteratorFor(javax.media.j3d.Geometry, boolean...), getPickThreshold(javax.media.j3d.Geometry, javax.media.j3d.Appearance), and getPickCullFace(javax.media.j3d.Geometry, javax.media.j3d.Appearance).
  - pickGeometry
```
protected int pickGeometry(javax.media.j3d.Geometry geometry,
               javax.media.j3d.Appearance appearance)
```
    Covers pickGeometry(Geometry, Appearance, J3DPrimitiveIterator, float[], float[], float, int) using getPrimitiveIteratorFor(javax.media.j3d.Geometry, boolean...), getPickThreshold(javax.media.j3d.Geometry, javax.media.j3d.Appearance), and getPickCullFace(javax.media.j3d.Geometry, javax.media.j3d.Appearance), pickStartInLocal, and pickExtentInLocal.
    
    First does updatePickSegmentInLocal() iff pickSegmentInLocalDirty.
  - picked
```
protected boolean picked(javax.media.j3d.Geometry geometry,
             javax.media.j3d.Appearance appearance,
             int prim,
             float u)
```
    Picking callback.
    
    This is called for every pick intersection detected in render(Geometry, Appearance, float[], float).
    
    Default impl returns false.
    
    Parameters:
    prim - the prim index of the intersection, or negative if picked by bounds only
    u - the signed distance along the pick segment (pickStartInView, pickExtentInView) of the intersection normalized to the pick segment length. Note that this may imply a pick intersection outside the view frustum, however, as long as frustumCullEnabled and pickVisibleBoundsOnly are set, then the bounding sphere of geometry is known to intersect the view frustum. Also, if the pick segment is itself known to be within the view frustum (as it will be, e.g., when set by setPickPointOnCanvas(float, float)), and pickSegmentIntersectionsOnly is set, then reported pick intersections will always be within the view frustum.
    
    Returns:
    false to abort picking for this geometry in this frame
  - worldToViewChanged
```
protected void worldToViewChanged()
```
    Hook called when the world-to-view transform has changed (e.g. due to navigation, default impl does nothing.
    
    Note that this may be called after worldToViewScale and worldToViewRX have been updated but before the CMT has been updated or applied.
    
    Default impl does nothing.
  - projectionChanged
```
protected void projectionChanged()
```
    Hook called when the projection transform has changed, default impl does nothing.
    
    Note that this may be called after viewToCanvasScale and viewAABB have been updated but before applyProjection() has happened.
    
    Default impl does nothing.
  - rePicking
```
protected void rePicking()
```
    Hook called from generic render when pick will be performed for a render.
    
    Default impl does nothing.
  - ensureDBGAppearance
```
protected void ensureDBGAppearance()
```
    makes sure that dbgAppearance has been consed
  - setCanvas
```
protected void setCanvas(java.awt.Canvas canvas,
             int width,
             int height)
```
    Concrete subclasses call this to set canvas, thread safe.
    
    This should be called exactly once. It does addCanvasListeners(), configures the canvas sizes, and sets the initial background color, light properties, and projection.
    
    Parameters:
    canvas - the canvas to set, not null
    width - if both this and height are positive then they are set as the preferred size of canvas
  - addCanvasListeners
```
protected void addCanvasListeners()
```
    Adds all necessary event listeners to canvas.
    
    Automatically called from setCanvas(java.awt.Canvas, int, int).
    
    Calls RXSInteractor.addListeners(java.awt.Component) on rxsInteractor iff autoAddListenersToRXSInteractor().
  - autoAddListenersToRXSInteractor
```
protected boolean autoAddListenersToRXSInteractor()
```
    Whether to call RXSInteractor.addListeners(java.awt.Component) on rxsInteractor in addCanvasListeners().
    
    Default impl returns true. Subclasses can override if they don't want to use rxsInteractor or if they want to add its listeners in order after other listeners.

Class Display3D

Picking

Synchronization Policies

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

cvsid

MIN

MAX

TRACE_PICKING_EN

TRACE_GENERIC_EN

DEF_Z_CLIP

DEF_VIEW_SCALE

DEF_AMBIENT_LIGHT_INTENSITY

DEF_DIRECTIONAL_LIGHT_INTENSITY

SQRT3F

DEF_DIRECTIONAL_LIGHT_DIRECTION

NUM_RECENT_METRICS

QUEUE_INITIAL_CAPACITY

LOCAL_TO_WORLD_STACK_INITIAL_CAPACITY

DEF_HIGHLIGHT_FACTOR

DEF_HIGHLIGHT_COLOR

DEF_MASK_ALPHA

DEF_PICK_THRESHOLD_PIXELS

COORD_ONLY

ALL_COMPONENTS

SCREEN_METERS_PER_PIXEL

canvas

redBits

greenBits

blueBits

depthBits

stencilBits

numSamples

projectionLock

canvasSize

viewAABB

viewToCanvasScale

applyProjectionPending

canvasMouseLock

canvasMouseX

canvasMouseY

rxsInteractor

rxsInterpolator

defaultRotationCenter

defaultViewTXEM

defaultViewScale

localToWorldRX

localToWorldStack

localToWorldStackSize

worldToViewRX

worldToViewRXTemp

worldToViewScale

cmtRX

cmtScale

fitPending

frameSaveLock

frameSaveNextTime

frameSaveLastTime

frameSaveStartTime

frameSaveDirectory

frameSavePrefix

frameSaveNextIndex

frameSaveCount

frameSaveFPS

frameSaveWithCursor

sceneMetricsLock

sceneAABBInView

numSceneWidgets

numDisabledWidgetGeometries

numSceneGeometries

numVisibleGeometries

numTransparentGeometries

numHighlightedGeometries

numMaskedGeometries

numPickableGeometries

renderMetricsLock