vona.j3d

Class ConeWidget

java.lang.Object

vona.j3d.Widget

vona.j3d.FacetedWidget

vona.j3d.EdgedFacetedWidget

vona.j3d.JOGLEdgedFacetedWidget

vona.j3d.ConeWidget

public class ConeWidget
extends JOGLEdgedFacetedWidget

A cone.

The face geometry is tessellated into radial wedges, with defined normals. The edge geometry is composed of the endcap circle plus four axial lines where the cone intersects the coordinate planes.

The radius and height are is mutable. The cone base is centered at the origin of the local coordinate frame and is symmetric about the Z axis, with apex extending in the positive Z direction. It may be further positioned e.g. by manipulating Widget.rx.

trackWidgetLength(float...) may be called to enable Widget.widgetLength tracking, which causes the radius and/or the height to track Widget.widgetLength*trackRadiusFactor corresp. Widget.widgetLength*trackHeightFactor.

Face vertex array is 1+ns fans:

• bottom fan in ccw order from (radius, 0.0f, 0.0f)
• one vert fan in ccw order from (0.0f, 0.0f, height) per sector

Edge vertex array is five line strips:

• bottom perimeter strip in ccw order from (radius, 0.0f, 0.0f)
• (0.0f, 0.0f, height) - (radius, 0.0f, 0.0f)
• (0.0f, 0.0f, height) - (0.0f, radius, 0.0f)
• (0.0f, 0.0f, height) - (-radius, 0.0f, 0.0f)
• (0.0f, 0.0f, height) - (0.0f, -radius, 0.0f)

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
private static java.lang.String	cvsid
static int	DEF_NUM_SECTORS default ns
protected float	height current height
int	ns number of radial sectors
protected float	radius current radius
float	sectorAngle angle span of each sector
protected float	trackHeightFactor mapping from Widget.widgetLength to height, NaN if none
protected float	trackRadiusFactor mapping from Widget.widgetLength to radius, NaN if none

Fields inherited from class vona.j3d.JOGLEdgedFacetedWidget

edgeGeometry, edgeVertices, faceGeometry, faceVertices, X, Y, Z

Fields inherited from class vona.j3d.EdgedFacetedWidget

DASHED_PATTERN, DEF_EDGE_COLOR, DEF_OFFSET_BIAS, DEF_OFFSET_FACTOR, DOTTED_PATTERN, edgeAppearance, edgeColoringAttributes, edgeLineAttributes, EDGES, edgeTransparencyAttributes, facePolygonAttributes, SOLID_PATTERN

Fields inherited from class vona.j3d.FacetedWidget

faceAppearance, faceMaterial, FACES, faceTransparencyAttributes

Fields inherited from class vona.j3d.Widget

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

Constructor Summary

Constructors

Constructor and Description
ConeWidget() Covers ConeWidget(float, float, int), uses DEF_NUM_SECTORS, radius = 0.5f, height = 0.5f.
ConeWidget(float radius, float height) Covers ConeWidget(float, float, int), uses DEF_NUM_SECTORS.
ConeWidget(float radius, float height, int numSectors) Creates a new ConeWidget with given radius, height, and ns.

Method Summary

Methods

Modifier and Type	Method and Description
void	enableAxialEdges(boolean enable) enable/disable the four axial edges
void	enableRadialEdges(boolean enable) enable/disable the endcap edges
boolean	setHeight(float height) covers setLengths(float, float), only changes height
boolean	setLengths(float radius, float height) Set the radius and height.
boolean	setRadius(float radius) covers setLengths(float, float), only changes radius
void	trackWidgetLength(float... trackFactor) Set trackRadiusFactor and trackHeightFactor, see class header doc.
protected void	widgetLengthChanged() implements Widget.widgetLength tracking, see class header doc

Methods inherited from class vona.j3d.JOGLEdgedFacetedWidget

gevc, gfnc, gfvc, sev, sevc, sfn, sfnc, sfv, sfvc

Methods inherited from class vona.j3d.EdgedFacetedWidget

enableEdges, getEdgeAppearance, getEdgeGeometry, setAlpha, setColor, setColor, setEdgeAlpha, setEdgeColor, setEdgeColor, setEdgePattern, setEdgePattern, setEdgeWidth, setFaceOffset, setFaceOffsetBias, setFaceOffsetFactor

Methods inherited from class vona.j3d.FacetedWidget

enableFaces, getFaceAppearance, getFaceGeometry, setFaceAlpha, setFaceColor, setFaceColor

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, recomputeBoundingSpheres, 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

DEF_NUM_SECTORS

public static final int DEF_NUM_SECTORS

default ns

See Also:

Constant Field Values

ns

public final int ns

number of radial sectors

sectorAngle

public final float sectorAngle

angle span of each sector

radius

protected float radius

current radius

height

protected float height

current height

trackRadiusFactor

protected float trackRadiusFactor

mapping from Widget.widgetLength to radius, NaN if none

trackHeightFactor

protected float trackHeightFactor

mapping from Widget.widgetLength to height, NaN if none

Constructor Detail

ConeWidget

public ConeWidget(float radius,
          float height,
          int numSectors)

Creates a new ConeWidget with given radius, height, and ns.

Parameters:

radius - the non-negative radius

height - the non-negative height

numSectors - the number of sectors, must be positive

ConeWidget

public ConeWidget(float radius,
          float height)

Covers ConeWidget(float, float, int), uses DEF_NUM_SECTORS.

ConeWidget

public ConeWidget()

Covers ConeWidget(float, float, int), uses DEF_NUM_SECTORS, radius = 0.5f, height = 0.5f.

Method Detail

enableAxialEdges

public void enableAxialEdges(boolean enable)

enable/disable the four axial edges

enableRadialEdges

public void enableRadialEdges(boolean enable)

enable/disable the endcap edges

setLengths

public boolean setLengths(float radius,
                 float height)

Set the radius and height.

Parameters:

radius - the new radius, ignored if NaN, otherwise must be non-negative

height - the new height, ignored if NaN, otherwise must be non-negative

Returns:

true if anything changed

setRadius

public boolean setRadius(float radius)

covers setLengths(float, float), only changes radius

setHeight

public boolean setHeight(float height)

covers setLengths(float, float), only changes height

trackWidgetLength

public void trackWidgetLength(float... trackFactor)

Set trackRadiusFactor and trackHeightFactor, see class header doc.

Overrides:

trackWidgetLength in class Widget

widgetLengthChanged

protected void widgetLengthChanged()

implements Widget.widgetLength tracking, see class header doc

Overrides:

widgetLengthChanged in class Widget