vona.j3d

Class SectorWidget

java.lang.Object

vona.j3d.Widget

vona.j3d.FacetedWidget

vona.j3d.EdgedFacetedWidget

vona.j3d.JOGLEdgedFacetedWidget

vona.j3d.SectorWidget

public class SectorWidget
extends JOGLEdgedFacetedWidget

A circular sector.

The face geometry is tessellated into radial wedges, with defined normals. The edge geometry is composed of the two perimeter circular arcs plus the two encap segments.

The radius, radial width, start angle, and angular span are mutable, and the sector is centered at the origin of the local coordinate frame, with outward normal along the positive Z axis. 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 radial width to track Widget.widgetLength*trackInnerRadiusFactor corresp. Widget.widgetLength*trackWidthFactor.

The start angle is measured CCW from the positive X axis, and the angular span is measured CCW from the start angle.

Face vertex array is one tri strip in ccw order from (ir, sa).

Edge vertex array is four strips

• inner arc from (ir, sa)
• outer arc from (ir+w, sa)
• start radius (ir, sa) - (ir+w, sa)
• end radius (ir, sa+a) - (ir+w, sa+a)

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 float	angle current angular span
private static java.lang.String	cvsid
static int	DEF_NUM_SECTORS default ns
protected float	innerRadius current inner radius
int	ns number of azimuth and elevation sectors
protected float	sectorAngle angle span of each sector
protected float	startAngle current start angle
protected float	trackInnerRadiusFactor mapping from Widget.widgetLength to radius, NaN if none
protected float	trackWidthFactor mapping from Widget.widgetLength to radial width, NaN if none
protected float	width current radial width

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
SectorWidget() Covers SectorWidget(float, float, float, float int), uses DEF_NUM_SECTORS, innerRadius = 0.25f, width = 0.25f, startAngle = 0.0f, angle = 2*pi.
SectorWidget(float innerRadius, float width, float startAngle, float angle) Covers SectorWidget(float, float, float, float int), uses DEF_NUM_SECTORS.
SectorWidget(float innerRadius, float width, float startAngle, float angle, int numSectors) Creates a new AnnulusWidget with given radius, radial width, and ns.
SectorWidget(int numSectors) Covers SectorWidget(float, float, float, float int), uses innerRadius = 0.25f, width = 0.25f, startAngle = 0.0f, angle = 2*pi.

Method Summary

Methods

Modifier and Type	Method and Description
void	enableArcEdges(boolean enable) enable/disable arc edges
void	enableEndEdges(boolean enable) enable/disable end edges
boolean	setAngle(float angle) Covers setLengthsAndAngles(float, float, float, float), only changes angle span.
boolean	setAngles(float startAngle, float angle) Covers setLengthsAndAngles(float, float, float, float), only changes angle span and start angle.
boolean	setInnerRadius(float innerRadius) Covers setLengthsAndAngles(float, float, float, float), only changes inner radius.
boolean	setLengths(float innerRadius, float width) Covers setLengthsAndAngles(float, float, float, float), only changes radius and radial width.
boolean	setLengthsAndAngles(float innerRadius, float width, float startAngle, float angle) Set the inner radius, radial width, start angle, and angle span.
boolean	setStartAngle(float startAngle) Covers setLengthsAndAngles(float, float, float, float), only changes start angle.
boolean	setWidth(float width) Covers setLengthsAndAngles(float, float, float, float), only changes radial width.
void	trackWidgetLength(float... trackFactor) Set trackInnerRadiusFactor and trackWidthFactor, 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 azimuth and elevation sectors

sectorAngle

protected float sectorAngle

angle span of each sector

innerRadius

protected float innerRadius

current inner radius

width

protected float width

current radial width

startAngle

protected float startAngle

current start angle

angle

protected float angle

current angular span

trackInnerRadiusFactor

protected float trackInnerRadiusFactor

mapping from Widget.widgetLength to radius, NaN if none

trackWidthFactor

protected float trackWidthFactor

mapping from Widget.widgetLength to radial width, NaN if none

Constructor Detail

SectorWidget

public SectorWidget(float innerRadius,
            float width,
            float startAngle,
            float angle,
            int numSectors)

Creates a new AnnulusWidget with given radius, radial width, and ns.

Parameters:

innerRadius - the non-negative inner radius

width - the non-negative radial width

startAngle - the start angle

angle - the angular span, in the closed interval [0, 2pi]

numSectors - the number of sectors, must be positive

SectorWidget

public SectorWidget(float innerRadius,
            float width,
            float startAngle,
            float angle)

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

SectorWidget

public SectorWidget(int numSectors)

Covers SectorWidget(float, float, float, float int), uses innerRadius = 0.25f, width = 0.25f, startAngle = 0.0f, angle = 2*pi.

SectorWidget

public SectorWidget()

Covers SectorWidget(float, float, float, float int), uses DEF_NUM_SECTORS, innerRadius = 0.25f, width = 0.25f, startAngle = 0.0f, angle = 2*pi.

Method Detail

enableEndEdges

public void enableEndEdges(boolean enable)

enable/disable end edges

enableArcEdges

public void enableArcEdges(boolean enable)

enable/disable arc edges

setLengthsAndAngles

public boolean setLengthsAndAngles(float innerRadius,
                          float width,
                          float startAngle,
                          float angle)

Set the inner radius, radial width, start angle, and angle span.

Parameters:

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

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

startAngle - the start angle, ignored if NaN

angle - the angular span, ignored if NaN, otherwise must be in the closed interval [0, 2pi]

Returns:

true if anything changed

setInnerRadius

public boolean setInnerRadius(float innerRadius)

Covers setLengthsAndAngles(float, float, float, float), only changes inner radius.

setWidth

public boolean setWidth(float width)

Covers setLengthsAndAngles(float, float, float, float), only changes radial width.

setLengths

public boolean setLengths(float innerRadius,
                 float width)

Covers setLengthsAndAngles(float, float, float, float), only changes radius and radial width.

setStartAngle

public boolean setStartAngle(float startAngle)

Covers setLengthsAndAngles(float, float, float, float), only changes start angle.

setAngle

public boolean setAngle(float angle)

Covers setLengthsAndAngles(float, float, float, float), only changes angle span.

setAngles

public boolean setAngles(float startAngle,
                float angle)

Covers setLengthsAndAngles(float, float, float, float), only changes angle span and start angle.

trackWidgetLength

public void trackWidgetLength(float... trackFactor)

Set trackInnerRadiusFactor and trackWidthFactor, 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