gov.nasa.worldwindx.examples

Class RadarVolume

java.lang.Object

gov.nasa.worldwind.avlist.AVListImpl

gov.nasa.worldwind.WWObjectImpl

gov.nasa.worldwind.render.AbstractShape

gov.nasa.worldwindx.examples.RadarVolume

All Implemented Interfaces:

AVList, Draggable, MessageListener, Exportable, ExtentHolder, Movable, Movable2, Attributable, GeographicExtent, Highlightable, OrderedRenderable, PreRenderable, Renderable, Restorable, WWObject, PropertyChangeListener, EventListener

public class RadarVolume
extends AbstractShape

Displays a volume defined by a near and far grid of positions. This shape is meant to represent a radar volume, with the radar having a minimum and maximum range.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	RadarVolume.ShapeData This class holds globe-specific data for this shape.

Nested classes/interfaces inherited from class gov.nasa.worldwind.render.AbstractShape

AbstractShape.AbstractShapeData

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	enableSides
static int	EXTERNAL_OBSTRUCTION
protected int	height
static int	INTERNAL_OBSTRUCTION
static int	NO_OBSTRUCTION
protected int[]	obstructionFlags
protected List<Position>	positions
protected IntBuffer	sideIndices
protected static int	TRIANGLE_NORMAL
protected static int	VERTEX_NORMAL
protected int	width

Fields inherited from class gov.nasa.worldwind.render.AbstractShape

activeAttributes, altitudeMode, BEogsh, currentData, DEFAULT_ALTITUDE_MODE, DEFAULT_GEOMETRY_GENERATION_INTERVAL, DEFAULT_HIGHLIGHT_MATERIAL, DEFAULT_INTERIOR_MATERIAL, DEFAULT_OUTLINE_MATERIAL, DEFAULT_OUTLINE_PICK_WIDTH, defaultAttributes, delegateOwner, dragEnabled, draggableSupport, enableBatchPicking, enableBatchRendering, enableDepthOffset, highlightAttrs, highlighted, maxExpiryTime, minExpiryTime, normalAttrs, outlinePickWidth, outlineShapeRenderer, pickLayer, pickSupport, referencePosition, sector, shapeDataCache, surfaceShape, VBO_THRESHOLD, viewDistanceExpiration, visible

Fields inherited from interface gov.nasa.worldwind.Exportable

FORMAT_NOT_SUPPORTED, FORMAT_PARTIALLY_SUPPORTED, FORMAT_SUPPORTED

Constructor Summary

Constructors

Constructor and Description
RadarVolume(List<Position> positions, int[] obstructionFlags, int width, int height) Constructs a radar volume.

Method Summary

Modifier and Type	Method and Description
protected void	computeCenterPoint()
protected AbstractShape.AbstractShapeData	createCacheEntry(DrawContext dc) Creates and returns a new cache entry specific to the subclass.
protected void	doDrawInterior(DrawContext dc) Draws this shape's interior.
protected void	doDrawOutline(DrawContext dc) Draws this shape's outline.
protected void	doExportAsKML(XMLStreamWriter xmlWriter) Exports shape-specific fields.
protected boolean	doMakeOrderedRenderable(DrawContext dc) Produces the geometry and other state necessary to represent this shape as an ordered renderable.
protected void	drawModel(DrawContext dc, int displayMode)
protected void	fillVBO(DrawContext dc) Fill this shape's vertex buffer objects.
protected RadarVolume.ShapeData	getCurrent() Returns the current shape data cache entry.
Extent	getExtent(Globe globe, double verticalExaggeration) Returns the objects enclosing volume as an Extent in model coordinates, given a specified Globe and vertical exaggeration (see SceneController.getVerticalExaggeration().
int	getHeight() Indicates the grid height.
int[]	getObstructionFlags() Returns the inclusion flags as specified to this object's constructor.
List<Position>	getPositions() Returns the grid positions as specified to this object's constructor.
Position	getReferencePosition() A position associated with the object that indicates its aggregate geographic position.
Sector	getSector() Returns the object's geographic extent.
int	getWidth() Indicates the grid width.
protected void	initialize() Called during construction to establish any subclass-specific state such as different default values than those set by this class.
List<Intersection>	intersect(Line line, Terrain terrain) Compute the intersections of a specified line with this shape.
boolean	isEnableSides()
String	isExportFormatSupported(String mimeType) Does this object support a certain export format?
protected boolean	isOrderedRenderableValid(DrawContext dc) Determines whether this shape's ordered renderable state is valid and can be rendered.
protected void	makeGridNormals()
protected void	makeGridTriangles() Forms the volume's front, back and bottom vertices and computes appropriate normals.
protected void	makeGridVertices(DrawContext dc)
protected void	makeSides()
void	moveTo(Position position) Move the shape over the globe's surface while maintaining its original azimuth, its orientation relative to North.
protected boolean	mustApplyTexture(DrawContext dc) Indicates whether texture should be applied to this shape.
void	setEnableSides(boolean enableSides)
protected void	setTriangleNormals(int[] flags, int[] indices)
protected boolean	shouldUseVBOs(DrawContext dc) Indicates whether this shape should use OpenGL vertex buffer objects.
protected static FloatBuffer	trimBuffer(FloatBuffer buffer)

Methods inherited from class gov.nasa.worldwind.render.AbstractShape

addOrderedRenderable, beginDrawing, checkViewDistanceExpiration, clearCachedVbos, computeExtentFromPositions, computePoint, computePoint, countTriangleVertices, createPickedObject, createSurfaceShape, determineActiveAttributes, doDrag, doDrawOrderedRenderable, doGetRestorableState, doRestoreState, drag, drawBatched, drawInterior, drawOrderedRenderable, drawOutline, endDrawing, export, exportAsKML, getActiveAttributes, getAltitudeMode, getAttributes, getCurrentData, getDelegateOwner, getDistanceFromEye, getExtent, getGeometryRegenerationInterval, getHighlightAttributes, getOutlinePickWidth, getReferencePoint, getRestorableState, getVboIds, intersectsFrustum, isDragEnabled, isEnableBatchPicking, isEnableBatchRendering, isEnableDepthOffset, isHighlighted, isTerrainDependent, isViewDistanceExpiration, isVisible, makeOrderedRenderable, makeTexture, move, moveTo, mustApplyLighting, mustApplyLighting, mustCreateNormals, mustCreateNormals, mustDrawInterior, mustDrawOutline, mustRegenerateGeometry, pick, prepareToDrawInterior, prepareToDrawOutline, preRender, render, reset, restoreState, setAltitudeMode, setAttributes, setDelegateOwner, setDragEnabled, setEnableBatchPicking, setEnableBatchRendering, setEnableDepthOffset, setGeometryRegenerationInterval, setHighlightAttributes, setHighlighted, setOutlinePickWidth, setReferencePosition, setViewDistanceExpiration, setVisible, updateSurfaceShape

Methods inherited from class gov.nasa.worldwind.WWObjectImpl

onMessage, propertyChange

Methods inherited from class gov.nasa.worldwind.avlist.AVListImpl

addPropertyChangeListener, addPropertyChangeListener, clearList, copy, firePropertyChange, firePropertyChange, getBooleanValue, getBooleanValue, getChangeSupport, getDoubleValue, getDoubleValue, getEntries, getIntegerValue, getIntegerValue, getLongValue, getLongValue, getRestorableStateForAVPair, getStringValue, getStringValue, getStringValue, getValue, getValues, hasKey, removeKey, removePropertyChangeListener, removePropertyChangeListener, setValue, setValues

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface gov.nasa.worldwind.avlist.AVList

addPropertyChangeListener, addPropertyChangeListener, clearList, copy, firePropertyChange, firePropertyChange, getEntries, getStringValue, getValue, getValues, hasKey, removeKey, removePropertyChangeListener, removePropertyChangeListener, setValue, setValues

Field Detail

enableSides

protected boolean enableSides

EXTERNAL_OBSTRUCTION

public static final int EXTERNAL_OBSTRUCTION

See Also:

Constant Field Values

height

protected int height

INTERNAL_OBSTRUCTION

public static final int INTERNAL_OBSTRUCTION

See Also:

Constant Field Values

NO_OBSTRUCTION

public static final int NO_OBSTRUCTION

See Also:

Constant Field Values

obstructionFlags

protected int[] obstructionFlags

positions

protected List<Position> positions

sideIndices

protected IntBuffer sideIndices

TRIANGLE_NORMAL

protected static final int TRIANGLE_NORMAL

See Also:

Constant Field Values

VERTEX_NORMAL

protected static final int VERTEX_NORMAL

See Also:

Constant Field Values

width

protected int width

Constructor Detail

RadarVolume

public RadarVolume(List<Position> positions,
                   int[] obstructionFlags,
                   int width,
                   int height)

Constructs a radar volume.

Parameters:

positions - the volume's positions, organized as two grids. The near grid is held in the first width x height entries, the far grid is held in the next width x height entries. This list is retained as-is and is not copied.

obstructionFlags - flags indicating the obstruction state of the specified positions. This array is retained as-is and is not copied. Recognized values are NO_OBSTRUCTION indicating that the specified position is unobstructed, INTERNAL_OBSTRUCTION indicating that the position is obstructed beyond the near grid but before the far grid, EXTERNAL_OBSTRUCTION indicating that the position is obstructed before the near grid.

width - the horizontal dimension of the grid.

height - the vertical dimension of the grid.

Throws:

IllegalArgumentException - if the positions list or inclusion flags array is null, the size of the inclusion flags array is less than the number of grid positions, the positions list is less than the specified size, or the width or height are less than 2.

Method Detail

computeCenterPoint

protected void computeCenterPoint()

createCacheEntry

protected AbstractShape.AbstractShapeData createCacheEntry(DrawContext dc)

Description copied from class: AbstractShape

Creates and returns a new cache entry specific to the subclass.

Specified by:

createCacheEntry in class AbstractShape

Parameters:

dc - the current draw context.

Returns:

a data cache entry for the state in the specified draw context.

doDrawInterior

protected void doDrawInterior(DrawContext dc)

Description copied from class: AbstractShape

Draws this shape's interior. Called immediately after calling AbstractShape.prepareToDrawInterior(DrawContext, ShapeAttributes, ShapeAttributes), which establishes OpenGL state for lighting, blending, pick color and interior attributes. Subclasses should execute the drawing commands specific to the type of shape.

A AbstractShape.AbstractShapeData must be current when this method is called.

Specified by:

doDrawInterior in class AbstractShape

Parameters:

dc - the current draw context.

doDrawOutline

protected void doDrawOutline(DrawContext dc)

Description copied from class: AbstractShape

Draws this shape's outline. Called immediately after calling AbstractShape.prepareToDrawOutline(DrawContext, ShapeAttributes, ShapeAttributes), which establishes OpenGL state for lighting, blending, pick color and line attributes. Subclasses should execute the drawing commands specific to the type of shape.

A AbstractShape.AbstractShapeData must be current when this method is called.

Specified by:

doDrawOutline in class AbstractShape

Parameters:

dc - the current draw context.

doExportAsKML

protected void doExportAsKML(XMLStreamWriter xmlWriter)
                      throws IOException,
                             XMLStreamException

Description copied from class: AbstractShape

Exports shape-specific fields.

Specified by:

doExportAsKML in class AbstractShape

Parameters:

xmlWriter - the export writer to write to.

Throws:

IOException - if an IO error occurs while writing to the output destination.

XMLStreamException - if an exception occurs converting this shape's fields to XML.

doMakeOrderedRenderable

protected boolean doMakeOrderedRenderable(DrawContext dc)

Description copied from class: AbstractShape

Produces the geometry and other state necessary to represent this shape as an ordered renderable. Places this shape on the draw context's ordered renderable list for subsequent rendering. This method is called during AbstractShape.pick(DrawContext, java.awt.Point) and AbstractShape.render(DrawContext) when it's been determined that the shape is likely to be visible.

Specified by:

doMakeOrderedRenderable in class AbstractShape

Parameters:

dc - the current draw context.

Returns:

true if the ordered renderable state was successfully computed, otherwise false, in which case the current pick or render pass is terminated for this shape. Subclasses should return false if it is not possible to create the ordered renderable state.

See Also:

AbstractShape.pick(DrawContext, java.awt.Point), AbstractShape.render(DrawContext)

drawModel

protected void drawModel(DrawContext dc,
                         int displayMode)

fillVBO

protected void fillVBO(DrawContext dc)

Description copied from class: AbstractShape

Fill this shape's vertex buffer objects. If the vertex buffer object resource IDs don't yet exist, create them.

A AbstractShape.AbstractShapeData must be current when this method is called.

Specified by:

fillVBO in class AbstractShape

Parameters:

dc - the current draw context.

getCurrent

protected RadarVolume.ShapeData getCurrent()

Returns the current shape data cache entry.

Returns:

the current data cache entry.

getExtent

public Extent getExtent(Globe globe,
                        double verticalExaggeration)

Description copied from interface: ExtentHolder

Returns the objects enclosing volume as an Extent in model coordinates, given a specified Globe and vertical exaggeration (see SceneController.getVerticalExaggeration().

Specified by:

getExtent in interface ExtentHolder

Overrides:

getExtent in class AbstractShape

Parameters:

globe - the Globe the object is related to.

verticalExaggeration - the vertical exaggeration of the scene containing this object.

Returns:

the object's Extent in model coordinates.

getHeight

public int getHeight()

Indicates the grid height.

Returns:

the grid height.

getObstructionFlags

public int[] getObstructionFlags()

Returns the inclusion flags as specified to this object's constructor.

Returns:

this object's inclusion flags.

getPositions

public List<Position> getPositions()

Returns the grid positions as specified to this object's constructor.

Returns:

this object's grid positions.

getReferencePosition

public Position getReferencePosition()

Description copied from interface: Movable

A position associated with the object that indicates its aggregate geographic position. The chosen position varies among implementers of this interface. For objects defined by a list of positions, the reference position is typically the first position in the list. For symmetric objects the reference position is often the center of the object. In many cases the object's reference position may be explicitly specified by the application.

Returns:

the object's reference position, or null if no reference position is available.

getSector

public Sector getSector()

Description copied from interface: GeographicExtent

Returns the object's geographic extent.

Returns:

the object's geographic extent.

getWidth

public int getWidth()

Indicates the grid width.

Returns:

the grid width.

initialize

protected void initialize()

Description copied from class: AbstractShape

Called during construction to establish any subclass-specific state such as different default values than those set by this class.

Specified by:

initialize in class AbstractShape

intersect

public List<Intersection> intersect(Line line,
                                    Terrain terrain)
                             throws InterruptedException

Description copied from class: AbstractShape

Compute the intersections of a specified line with this shape. If the shape's altitude mode is other than WorldWind.ABSOLUTE, the shape's geometry is created relative to the specified terrain rather than the terrain used during rendering, which may be at lower level of detail than required for accurate intersection determination.

Specified by:

intersect in class AbstractShape

Parameters:

line - the line to intersect.

terrain - the Terrain to use when computing the shape's geometry.

Returns:

a list of intersections identifying where the line intersects the shape, or null if the line does not intersect the shape.

Throws:

InterruptedException - if the operation is interrupted.

See Also:

Terrain

isEnableSides

public boolean isEnableSides()

isExportFormatSupported

public String isExportFormatSupported(String mimeType)

Description copied from interface: Exportable

Does this object support a certain export format?

Specified by:

isExportFormatSupported in interface Exportable

Overrides:

isExportFormatSupported in class AbstractShape

Parameters:

mimeType - Desired export format.

Returns:

One of Exportable.FORMAT_SUPPORTED, Exportable.FORMAT_NOT_SUPPORTED, or Exportable.FORMAT_PARTIALLY_SUPPORTED.

See Also:

Exportable.export(String, Object)

isOrderedRenderableValid

protected boolean isOrderedRenderableValid(DrawContext dc)

Description copied from class: AbstractShape

Determines whether this shape's ordered renderable state is valid and can be rendered. Called by AbstractShape.makeOrderedRenderable(DrawContext)just prior to adding the shape to the ordered renderable list.

Specified by:

isOrderedRenderableValid in class AbstractShape

Parameters:

dc - the current draw context.

Returns:

true if this shape is ready to be rendered as an ordered renderable.

makeGridNormals

protected void makeGridNormals()

makeGridTriangles

protected void makeGridTriangles()

Forms the volume's front, back and bottom vertices and computes appropriate normals.

makeGridVertices

protected void makeGridVertices(DrawContext dc)

makeSides

protected void makeSides()

moveTo

public void moveTo(Position position)

Description copied from interface: Movable

Move the shape over the globe's surface while maintaining its original azimuth, its orientation relative to North.

Parameters:

position - the new position of the shape's reference position.

mustApplyTexture

protected boolean mustApplyTexture(DrawContext dc)

Description copied from class: AbstractShape

Indicates whether texture should be applied to this shape. Called during rendering to determine whether texture state should be established during preparation for interior drawing.

Note: This method always returns false during the pick pass.

Specified by:

mustApplyTexture in class AbstractShape

Parameters:

dc - the current draw context

Returns:

true if texture should be applied, otherwise false.

setEnableSides

public void setEnableSides(boolean enableSides)

setTriangleNormals

protected void setTriangleNormals(int[] flags,
                                  int[] indices)

shouldUseVBOs

protected boolean shouldUseVBOs(DrawContext dc)

Description copied from class: AbstractShape

Indicates whether this shape should use OpenGL vertex buffer objects.

Overrides:

shouldUseVBOs in class AbstractShape

Parameters:

dc - the current draw context.

Returns:

true if this shape should use vertex buffer objects, otherwise false.

trimBuffer

protected static FloatBuffer trimBuffer(FloatBuffer buffer)