gov.nasa.worldwind

Class WorldWindowImpl

java.lang.Object

gov.nasa.worldwind.avlist.AVListImpl

gov.nasa.worldwind.WWObjectImpl

gov.nasa.worldwind.WorldWindowImpl

All Implemented Interfaces:

AVList, MessageListener, WorldWindow, WWObject, PropertyChangeListener, EventListener

Direct Known Subclasses:

WorldWindowGLAutoDrawable

public abstract class WorldWindowImpl
extends WWObjectImpl
implements WorldWindow

An implementation class for the WorldWindow interface. Classes implementing WorldWindow can subclass or aggregate this object to provide default WorldWindow functionality.

Field Summary

Fields

Modifier and Type	Field and Description
protected GpuResourceCache	gpuResourceCache

Constructor Summary

Constructors

Constructor and Description
WorldWindowImpl()

Method Summary

Modifier and Type	Method and Description
void	addPositionListener(PositionListener listener) Adds a position listener to this world window.
void	addRenderingExceptionListener(RenderingExceptionListener listener) Adds an exception listener to this world window.
void	addRenderingListener(RenderingListener listener) Adds a rendering listener to this world window.
void	addSelectListener(SelectListener listener) Adds a select listener to this world window.
protected void	callPositionListeners(PositionEvent event)
protected void	callRenderingExceptionListeners(Throwable exception)
protected void	callRenderingListeners(RenderingEvent event)
protected void	callSelectListeners(SelectEvent event)
static GpuResourceCache	createGpuResourceCache()
protected PickedObjectList	getCurrentBoxSelection()
Position	getCurrentPosition() Returns the current latitude, longitude and altitude of the current cursor position, or null if the cursor is not on the globe.
protected PickedObject	getCurrentSelection()
GpuResourceCache	getGpuResourceCache() Returns the GPU Resource used by this World Window.
InputHandler	getInputHandler() Returns the input handler associated with this instance.
Model	getModel() Returns the window's current model.
PickedObjectList	getObjectsAtCurrentPosition() Returns the World Wind objects at the current cursor position.
PickedObjectList	getObjectsInSelectionBox() Returns the World Wind objects intersecting the current selection box.
Collection<PerformanceStatistic>	getPerFrameStatistics() Returns the active per-frame performance statistics such as number of tiles drawn in the most recent frame.
SceneController	getSceneController() Returns the scene controller associated with this instance.
View	getView() Returns this window's current view.
void	redraw() Causes a repaint event to be enqueued with the window system for this world window.
void	redrawNow() Immediately repaints the world window without waiting for a window system repaint event.
void	removePositionListener(PositionListener listener) Removes the specified position listener associated with this world window.
void	removeRenderingExceptionListener(RenderingExceptionListener listener) Removes the specified rendering exception listener associated with this world window.
void	removeRenderingListener(RenderingListener listener) Removes a specified rendering listener associated with this world window.
void	removeSelectListener(SelectListener listener) Removes the specified select listener associated with this world window.
void	setGpuResourceCache(GpuResourceCache gpuResourceCache)
void	setInputHandler(InputHandler inputHandler) Sets the input handler to use for this instance.
void	setModel(Model model) Sets the model to display in this window.
void	setModelAndView(Model model, View view) Sets the model to display in this window and the view used to display it.
void	setPerFrameStatisticsKeys(Set<String> keys) Activates the per-frame performance statistic specified.
void	setSceneController(SceneController sc) Specifies a new scene controller for the window.
void	setView(View view) Sets the view to use when displaying this window's model.
void	shutdown() Causes resources used by the World Window to be freed.

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.WorldWindow

getContext, isEnableGpuCacheReinitialization, setEnableGpuCacheReinitialization

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

gpuResourceCache

protected GpuResourceCache gpuResourceCache

Constructor Detail

WorldWindowImpl

public WorldWindowImpl()

Method Detail

addPositionListener

public void addPositionListener(PositionListener listener)

Description copied from interface: WorldWindow

Adds a position listener to this world window. Position listeners are called when the cursor's position changes. They identify the position of the cursor on the globe, or that the cursor is not on the globe.

Specified by:

addPositionListener in interface WorldWindow

Parameters:

listener - The position listener to add.

addRenderingExceptionListener

public void addRenderingExceptionListener(RenderingExceptionListener listener)

Description copied from interface: WorldWindow

Adds an exception listener to this world window. Exception listeners are called when an exception or other critical event occurs during drawable initialization or during rendering.

Specified by:

addRenderingExceptionListener in interface WorldWindow

Parameters:

listener - the The exception listener to add.

addRenderingListener

public void addRenderingListener(RenderingListener listener)

Description copied from interface: WorldWindow

Adds a rendering listener to this world window. Rendering listeners are called at key point during World Wind drawing and provide applications the ability to participate or monitor rendering.

Specified by:

addRenderingListener in interface WorldWindow

Parameters:

listener - The rendering listener to add to those notified of rendering events by this world window.

addSelectListener

public void addSelectListener(SelectListener listener)

Description copied from interface: WorldWindow

Adds a select listener to this world window. Select listeners are called when a selection is made by the user in the world window. A selection is any operation that identifies a visible item.

Specified by:

addSelectListener in interface WorldWindow

Parameters:

listener - The select listener to add.

callPositionListeners

protected void callPositionListeners(PositionEvent event)

callRenderingExceptionListeners

protected void callRenderingExceptionListeners(Throwable exception)

callRenderingListeners

protected void callRenderingListeners(RenderingEvent event)

callSelectListeners

protected void callSelectListeners(SelectEvent event)

createGpuResourceCache

public static GpuResourceCache createGpuResourceCache()

getCurrentBoxSelection

protected PickedObjectList getCurrentBoxSelection()

getCurrentPosition

public Position getCurrentPosition()

Description copied from interface: WorldWindow

Returns the current latitude, longitude and altitude of the current cursor position, or null if the cursor is not on the globe.

Specified by:

getCurrentPosition in interface WorldWindow

Returns:

The current position of the cursor, or null if the cursor is not positioned on the globe.

getCurrentSelection

protected PickedObject getCurrentSelection()

getGpuResourceCache

public GpuResourceCache getGpuResourceCache()

Description copied from interface: WorldWindow

Returns the GPU Resource used by this World Window. This method is for internal use only.

Note: Applications do not need to interact with the GPU resource cache. It is self managed. Modifying it in any way will cause significant problems such as excessive memory usage or application crashes. The only reason to use the GPU resource cache is to request management of GPU resources within implementations of shapes or layers. And then access should be only through the draw context only.

Specified by:

getGpuResourceCache in interface WorldWindow

Returns:

The GPU Resource cache used by this World Window.

getInputHandler

public InputHandler getInputHandler()

Description copied from interface: WorldWindow

Returns the input handler associated with this instance.

Specified by:

getInputHandler in interface WorldWindow

Returns:

The input handler associated with this instance, or null if no input handler is associated.

getModel

public Model getModel()

Description copied from interface: WorldWindow

Returns the window's current model.

Specified by:

getModel in interface WorldWindow

Returns:

the window's current model.

getObjectsAtCurrentPosition

public PickedObjectList getObjectsAtCurrentPosition()

Description copied from interface: WorldWindow

Returns the World Wind objects at the current cursor position. The list of objects under the cursor is determined each time the world window is repainted. This method returns the list of objects determined when the most recent repaint was performed.

Specified by:

getObjectsAtCurrentPosition in interface WorldWindow

Returns:

The list of objects at the cursor position, or null if no objects are under the cursor.

getObjectsInSelectionBox

public PickedObjectList getObjectsInSelectionBox()

Description copied from interface: WorldWindow

Returns the World Wind objects intersecting the current selection box. The list of objects in the selection box is determined each time the world window is repainted. This method returns the list of objects determined when the most recent repaint was performed.

Specified by:

getObjectsInSelectionBox in interface WorldWindow

Returns:

The list of objects intersecting the selection box, or null if no objects are in the box.

getPerFrameStatistics

public Collection<PerformanceStatistic> getPerFrameStatistics()

Description copied from interface: WorldWindow

Returns the active per-frame performance statistics such as number of tiles drawn in the most recent frame.

Specified by:

getPerFrameStatistics in interface WorldWindow

Returns:

The keys and values of the active per-frame statistics.

getSceneController

public SceneController getSceneController()

Description copied from interface: WorldWindow

Returns the scene controller associated with this instance.

Specified by:

getSceneController in interface WorldWindow

Returns:

The scene controller associated with the instance, or null if no scene controller is associated.

getView

public View getView()

Description copied from interface: WorldWindow

Returns this window's current view.

Specified by:

getView in interface WorldWindow

Returns:

the window's current view.

redraw

public void redraw()

Description copied from interface: WorldWindow

Causes a repaint event to be enqueued with the window system for this world window. The repaint will occur at the window system's discretion, within the window system toolkit's event loop, and on the thread of that loop. This is the preferred method for requesting a repaint of the world window.

Specified by:

redraw in interface WorldWindow

redrawNow

public void redrawNow()

Description copied from interface: WorldWindow

Immediately repaints the world window without waiting for a window system repaint event. This is not the preferred way to cause a repaint, but is provided for the rare cases that require it.

Specified by:

redrawNow in interface WorldWindow

removePositionListener

public void removePositionListener(PositionListener listener)

Description copied from interface: WorldWindow

Removes the specified position listener associated with this world window.

Specified by:

removePositionListener in interface WorldWindow

Parameters:

listener - The listener to remove.

removeRenderingExceptionListener

public void removeRenderingExceptionListener(RenderingExceptionListener listener)

Description copied from interface: WorldWindow

Removes the specified rendering exception listener associated with this world window.

Specified by:

removeRenderingExceptionListener in interface WorldWindow

Parameters:

listener - The listener to remove.

removeRenderingListener

public void removeRenderingListener(RenderingListener listener)

Description copied from interface: WorldWindow

Removes a specified rendering listener associated with this world window.

Specified by:

removeRenderingListener in interface WorldWindow

Parameters:

listener - The rendering listener to remove.

removeSelectListener

public void removeSelectListener(SelectListener listener)

Description copied from interface: WorldWindow

Removes the specified select listener associated with this world window.

Specified by:

removeSelectListener in interface WorldWindow

Parameters:

listener - The select listener to remove.

setGpuResourceCache

public void setGpuResourceCache(GpuResourceCache gpuResourceCache)

setInputHandler

public void setInputHandler(InputHandler inputHandler)

Description copied from interface: WorldWindow

Sets the input handler to use for this instance.

Specified by:

setInputHandler in interface WorldWindow

Parameters:

inputHandler - The input handler to use for this world window. May by null if null is specified, the current input handler, if any, is disassociated with the world window.

setModel

public void setModel(Model model)

Description copied from interface: WorldWindow

Sets the model to display in this window. If null is specified for the model, the current model, if any, is disassociated with the window.

Specified by:

setModel in interface WorldWindow

Parameters:

model - the model to display. May be null.

setModelAndView

public void setModelAndView(Model model,
                            View view)

Description copied from interface: WorldWindow

Sets the model to display in this window and the view used to display it. If null is specified for the model, the current model, if any, is disassociated with the window. If null is specified for the view, the current view, if any, is disassociated with the window.

Specified by:

setModelAndView in interface WorldWindow

Parameters:

model - the model to display. May benull.

view - the view to use to display this window's model. May benull.

setPerFrameStatisticsKeys

public void setPerFrameStatisticsKeys(Set<String> keys)

Description copied from interface: WorldWindow

Activates the per-frame performance statistic specified. Per-frame statistics measure values within a single frame of rendering, such as number of tiles drawn to produce the frame.

Specified by:

setPerFrameStatisticsKeys in interface WorldWindow

Parameters:

keys - The statistics to activate.

setSceneController

public void setSceneController(SceneController sc)

Description copied from interface: WorldWindow

Specifies a new scene controller for the window. The caller is responsible for populating the new scene controller with a View, Model and any desired per-frame statistics keys.

Specified by:

setSceneController in interface WorldWindow

Parameters:

sc - the new scene controller.

See Also:

SceneController.setView(View), SceneController.setModel(Model), SceneController.setPerFrameStatisticsKeys(java.util.Set)

setView

public void setView(View view)

Description copied from interface: WorldWindow

Sets the view to use when displaying this window's model. If null is specified for the view, the current view, if any, is disassociated with the window.

Specified by:

setView in interface WorldWindow

Parameters:

view - the view to use to display this window's model. May be null.

shutdown

public void shutdown()

Causes resources used by the World Window to be freed. The World Window cannot be used once this method is called. An OpenGL context for the window must be current.

Specified by:

shutdown in interface WorldWindow