vona.j3d

Class CurveWidget

java.lang.Object

vona.j3d.Widget

vona.j3d.CurveWidget

Direct Known Subclasses:

RouteWidget, SegmentWidget

public abstract class CurveWidget
extends Widget

Base class for widgets that are curves.

trackWidgetLength(float...) may be called to enable Widget.widgetLength tracking, which causes the length to track Widget.widgetLength*trackLengthFactor, maintaining the same midpoint and spatial orientation.

Copyright (C) 2008 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

Field Summary

Fields

Modifier and Type	Field and Description
protected javax.media.j3d.Appearance	appearance the appearance
private static java.lang.String	cvsid
static int	DASHED_PATTERN line attributes pattern mask
static float[]	DEF_COLOR default line color
static float[]	DEF_END_COORD default coords
static float[]	DEF_START_COORD default coords
static int	DOTTED_PATTERN line attributes pattern mask
protected float[]	endColor endpoint vertex colors
protected float[]	endCoord endpoint vertices
protected JOGLGeometry	geometry the geometry
protected javax.media.j3d.LineAttributes	lineAttributes the line attributes
static float[]	ORIGIN 3D origin
static int	SOLID_PATTERN line attributes pattern mask
protected float[]	startColor endpoint vertex colors
protected float[]	startCoord endpoint vertices
protected float[]	tempV3 temp storage
protected float	trackLengthFactor mapping from Widget.widgetLength to segment length, NaN if none
protected java.nio.FloatBuffer	vertexBuffer the vertex buffer
static int	X coordinate indices
static int	Y coordinate indices
static int	Z coordinate indices

Fields inherited from class vona.j3d.Widget

alpha, autoSetBoundingSpheres, boundingSphereCenter, boundingSphereCenterInView, boundingSphereRadius, boundingSphereRadiusInView, dbgEnabled, dbgNormalsGeometry, dbgNormalsVertices, dbgSpheresGeometry, dbgSpheresVertices, DEF_DBG_NORMAL_LENGTH, DEF_WIDGET_LENGTH, enabled, numGeometries, primitiveIterator, propertyMap, rx, vertexAccessor, widgetLength

Constructor Summary

Constructors

Constructor and Description
CurveWidget(int numVertices, float[] startCoord, float[] endCoord, float[] startColor, float[] endColor) Creates a new CurveWidget from startCoord to endCoord.

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	different(float[] a, float[] b) check if two vectors differ, iff they are the same length
protected void	endDiffChanged(float... diffCoord) hook called from setEndDiff(float...)
protected void	extentsChanged(boolean startDiffers, boolean endDiffers) hook called from setExtents(float[], float[])
boolean	isDegenerate() check if startCoord and endCoord are the same
protected void	lengthChanged(float length, float dx, float dy, float dz) hook called from setLength(float)
protected void	recomputeBoundingSphere(float[] a, float[] b) compute bounding sphere given two points on its diameter
void	recomputeBoundingSpheres() recompute the geometric bounding sphere
boolean	setColor(java.awt.Color color) covers setColors(Color, Color) sets same colors
boolean	setColor(float... color) covers setColors(float[], float[]) sets same colors
boolean	setColors(java.awt.Color startColor, java.awt.Color endColor) covers setColors(float[], float[])
boolean	setColors(float[] startColor, float[] endColor) Update the terminal colors.
boolean	setEnd(float... coord) covers setExtents(float[], float[]), only sets end
boolean	setEndColor(java.awt.Color color) covers setColors(Color, Color), only sets end color
boolean	setEndColor(float... color) covers setColors(float[], float[]), only sets end color
boolean	setEndDiff(float... diffCoord) set the end coord relative to the start coord
boolean	setExtents(float[] startCoord, float[] endCoord) Update the terminal vertices.
boolean	setLength(float length) Update the start-to-end length, maintaining current midpoint and spatial orientation.
void	setLinePattern(int pattern) covers setLinePattern(int, int), does not change scale
void	setLinePattern(int pattern, int scale) set the line pattern mask and scale
void	setLineWidth(float width) set the line width
boolean	setStart(float... coord) covers setExtents(float[], float[]), only sets start
boolean	setStartColor(java.awt.Color color) covers setColors(Color, Color), only sets start color
boolean	setStartColor(float... color) covers setColors(float[], float[]), only sets start color
void	trackWidgetLength(float... trackFactor) set trackLengthFactor, see class header doc
protected abstract void	update() recompute coords, colors, and recomputeBoundingSpheres()
protected void	widgetLengthChanged() implements Widget.widgetLength tracking, see class header doc

Methods inherited from class vona.j3d.Widget

cons, countGeometryArrays, disableBoundingSphere, disableBoundingSpheres, dump, dump, enableDBGGeometry, enableGeometry, ensureBoundingSpheresInView, getAppearance, getBoundingSphereCenter, getBoundingSphereRadius, getGeometry, getProperty, getWidget, getWidgetAlpha, hasBoundingSphere, hasBoundingSphereInView, hasProperty, indexOf, populateFrom, recomputeBoundingSphere, removeDBGNormals, removeDBGSpheres, removeGeometry, removeGeometry, removeProperty, replaceAppearanceWithClone, replaceGeometryWithClone, scaleWidget, setAppearance, setBoundingSphereCenter, setBoundingSphereRadius, setGeometry, setGeometryAlpha, setGeometryAlpha, setGeometryAndAppearance, setProperty, setProperty, setWidgetAlpha, setWidgetLength, updateAllDBGNormals, updateAllDBGNormals, updateAllDBGSpheres, updateDBGNormals, updateDBGNormals, updateDBGSpheres, updateExistingDBGNormals, updateExistingDBGSpheres

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

DASHED_PATTERN

public static final int DASHED_PATTERN

line attributes pattern mask

See Also:

Constant Field Values

DOTTED_PATTERN

public static final int DOTTED_PATTERN

line attributes pattern mask

See Also:

Constant Field Values

SOLID_PATTERN

public static final int SOLID_PATTERN

line attributes pattern mask

See Also:

Constant Field Values

X

public static final int X

coordinate indices

See Also:

Constant Field Values

Y

public static final int Y

coordinate indices

See Also:

Constant Field Values

Z

public static final int Z

coordinate indices

See Also:

Constant Field Values

DEF_COLOR

public static final float[] DEF_COLOR

default line color

ORIGIN

public static final float[] ORIGIN

3D origin

DEF_START_COORD

public static final float[] DEF_START_COORD

default coords

DEF_END_COORD

public static final float[] DEF_END_COORD

default coords

geometry

protected final JOGLGeometry geometry

the geometry

appearance

protected final javax.media.j3d.Appearance appearance

the appearance

lineAttributes

protected final javax.media.j3d.LineAttributes lineAttributes

the line attributes

vertexBuffer

protected final java.nio.FloatBuffer vertexBuffer

the vertex buffer

trackLengthFactor

protected float trackLengthFactor

mapping from Widget.widgetLength to segment length, NaN if none

startCoord

protected final float[] startCoord

endpoint vertices

endCoord

protected final float[] endCoord

endpoint vertices

startColor

protected final float[] startColor

endpoint vertex colors

endColor

protected final float[] endColor

endpoint vertex colors

tempV3

protected final float[] tempV3

temp storage

Constructor Detail

CurveWidget

public CurveWidget(int numVertices,
           float[] startCoord,
           float[] endCoord,
           float[] startColor,
           float[] endColor)

Creates a new CurveWidget from startCoord to endCoord.

Parameters:

startCoord - the coordinates of the start vertex, or null to use DEF_START_COORD

endCoord - the coordinates of the end vertex, or null to use DEF_END_COORD

startColor - the color at the start vertex, or null to use DEF_COLOR

endColor - the color at the end vertex, or null to use DEF_COLOR

Method Detail

setExtents

public boolean setExtents(float[] startCoord,
                 float[] endCoord)

Update the terminal vertices.

Parameters:

startCoord - the new start vertex coords, or null to keep current

endCoord - the new end vertex coords, or null to keep current

Returns:

true iff anything changed

extentsChanged

protected void extentsChanged(boolean startDiffers,
                  boolean endDiffers)

hook called from setExtents(float[], float[])

setStart

public boolean setStart(float... coord)

covers setExtents(float[], float[]), only sets start

setEnd

public boolean setEnd(float... coord)

covers setExtents(float[], float[]), only sets end

setEndDiff

public boolean setEndDiff(float... diffCoord)

set the end coord relative to the start coord

endDiffChanged

protected void endDiffChanged(float... diffCoord)

hook called from setEndDiff(float...)

setLength

public boolean setLength(float length)

Update the start-to-end length, maintaining current midpoint and spatial orientation.

If the segment is currently degenerate its spatial orientation is taken to be (0, 0, 1).

Parameters:

length - the new length, NaN or same as current to leave unchanged

Returns:

true iff anything changed

lengthChanged

protected void lengthChanged(float length,
                 float dx,
                 float dy,
                 float dz)

hook called from setLength(float)

setColors

public boolean setColors(float[] startColor,
                float[] endColor)

Update the terminal colors.

Parameters:

startColor - the new start color, or null to keep current

endColor - the new end color, or null to keep current

Returns:

true iff anything changed

setColors

public boolean setColors(java.awt.Color startColor,
                java.awt.Color endColor)

covers setColors(float[], float[])

setStartColor

public boolean setStartColor(float... color)

covers setColors(float[], float[]), only sets start color

setEndColor

public boolean setEndColor(float... color)

covers setColors(float[], float[]), only sets end color

setColor

public boolean setColor(float... color)

covers setColors(float[], float[]) sets same colors

setStartColor

public boolean setStartColor(java.awt.Color color)

covers setColors(Color, Color), only sets start color

setEndColor

public boolean setEndColor(java.awt.Color color)

covers setColors(Color, Color), only sets end color

setColor

public boolean setColor(java.awt.Color color)

covers setColors(Color, Color) sets same colors

setLineWidth

public void setLineWidth(float width)

set the line width

setLinePattern

public void setLinePattern(int pattern,
                  int scale)

set the line pattern mask and scale

setLinePattern

public void setLinePattern(int pattern)

covers setLinePattern(int, int), does not change scale

trackWidgetLength

public void trackWidgetLength(float... trackFactor)

set trackLengthFactor, see class header doc

Overrides:

trackWidgetLength in class Widget

isDegenerate

public boolean isDegenerate()

check if startCoord and endCoord are the same

widgetLengthChanged

protected void widgetLengthChanged()

implements Widget.widgetLength tracking, see class header doc

Overrides:

widgetLengthChanged in class Widget

update

protected abstract void update()

recompute coords, colors, and recomputeBoundingSpheres()

recomputeBoundingSpheres

public void recomputeBoundingSpheres()

recompute the geometric bounding sphere

Overrides:

recomputeBoundingSpheres in class Widget

recomputeBoundingSphere

protected void recomputeBoundingSphere(float[] a,
                           float[] b)

compute bounding sphere given two points on its diameter

different

protected boolean different(float[] a,
                float[] b)

check if two vectors differ, iff they are the same length