gov.nasa.worldwind

Class WorldWindow

java.lang.Object

android.view.View

android.view.SurfaceView

android.opengl.GLSurfaceView

gov.nasa.worldwind.WorldWindow

All Implemented Interfaces:

android.graphics.drawable.Drawable.Callback, android.opengl.GLSurfaceView.Renderer, android.view.accessibility.AccessibilityEventSource, android.view.Choreographer.FrameCallback, android.view.KeyEvent.Callback, android.view.SurfaceHolder.Callback, android.view.SurfaceHolder.Callback2, MessageListener

public class WorldWindow
extends android.opengl.GLSurfaceView
implements android.view.Choreographer.FrameCallback, android.opengl.GLSurfaceView.Renderer, MessageListener

Provides a World Wind window that implements a virtual globe inside of the Android view hierarchy. By default, World Window is configured to display an ellipsoidal globe using the WGS 84 reference values.

Nested Class Summary

Nested classes/interfaces inherited from class android.opengl.GLSurfaceView

android.opengl.GLSurfaceView.EGLConfigChooser, android.opengl.GLSurfaceView.EGLContextFactory, android.opengl.GLSurfaceView.EGLWindowSurfaceFactory, android.opengl.GLSurfaceView.GLWrapper, android.opengl.GLSurfaceView.Renderer

Nested classes/interfaces inherited from class android.view.View

android.view.View.AccessibilityDelegate, android.view.View.BaseSavedState, android.view.View.DragShadowBuilder, android.view.View.MeasureSpec, android.view.View.OnApplyWindowInsetsListener, android.view.View.OnAttachStateChangeListener, android.view.View.OnClickListener, android.view.View.OnContextClickListener, android.view.View.OnCreateContextMenuListener, android.view.View.OnDragListener, android.view.View.OnFocusChangeListener, android.view.View.OnGenericMotionListener, android.view.View.OnHoverListener, android.view.View.OnKeyListener, android.view.View.OnLayoutChangeListener, android.view.View.OnLongClickListener, android.view.View.OnScrollChangeListener, android.view.View.OnSystemUiVisibilityChangeListener, android.view.View.OnTouchListener

Field Summary

Fields inherited from class android.opengl.GLSurfaceView

DEBUG_CHECK_GL_ERROR, DEBUG_LOG_GL_CALLS, RENDERMODE_CONTINUOUSLY, RENDERMODE_WHEN_DIRTY

Fields inherited from class android.view.View

ACCESSIBILITY_LIVE_REGION_ASSERTIVE, ACCESSIBILITY_LIVE_REGION_NONE, ACCESSIBILITY_LIVE_REGION_POLITE, ALPHA, DRAG_FLAG_GLOBAL, DRAG_FLAG_GLOBAL_PERSISTABLE_URI_PERMISSION, DRAG_FLAG_GLOBAL_PREFIX_URI_PERMISSION, DRAG_FLAG_GLOBAL_URI_READ, DRAG_FLAG_GLOBAL_URI_WRITE, DRAG_FLAG_OPAQUE, DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, FIND_VIEWS_WITH_CONTENT_DESCRIPTION, FIND_VIEWS_WITH_TEXT, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUSABLES_ALL, FOCUSABLES_TOUCH_MODE, GONE, HAPTIC_FEEDBACK_ENABLED, IMPORTANT_FOR_ACCESSIBILITY_AUTO, IMPORTANT_FOR_ACCESSIBILITY_NO, IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS, IMPORTANT_FOR_ACCESSIBILITY_YES, INVISIBLE, KEEP_SCREEN_ON, LAYER_TYPE_HARDWARE, LAYER_TYPE_NONE, LAYER_TYPE_SOFTWARE, LAYOUT_DIRECTION_INHERIT, LAYOUT_DIRECTION_LOCALE, LAYOUT_DIRECTION_LTR, LAYOUT_DIRECTION_RTL, MEASURED_HEIGHT_STATE_SHIFT, MEASURED_SIZE_MASK, MEASURED_STATE_MASK, MEASURED_STATE_TOO_SMALL, NO_ID, OVER_SCROLL_ALWAYS, OVER_SCROLL_IF_CONTENT_SCROLLS, OVER_SCROLL_NEVER, ROTATION, ROTATION_X, ROTATION_Y, SCALE_X, SCALE_Y, SCREEN_STATE_OFF, SCREEN_STATE_ON, SCROLL_AXIS_HORIZONTAL, SCROLL_AXIS_NONE, SCROLL_AXIS_VERTICAL, SCROLL_INDICATOR_BOTTOM, SCROLL_INDICATOR_END, SCROLL_INDICATOR_LEFT, SCROLL_INDICATOR_RIGHT, SCROLL_INDICATOR_START, SCROLL_INDICATOR_TOP, SCROLLBAR_POSITION_DEFAULT, SCROLLBAR_POSITION_LEFT, SCROLLBAR_POSITION_RIGHT, SCROLLBARS_INSIDE_INSET, SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_OUTSIDE_INSET, SCROLLBARS_OUTSIDE_OVERLAY, SOUND_EFFECTS_ENABLED, STATUS_BAR_HIDDEN, STATUS_BAR_VISIBLE, SYSTEM_UI_FLAG_FULLSCREEN, SYSTEM_UI_FLAG_HIDE_NAVIGATION, SYSTEM_UI_FLAG_IMMERSIVE, SYSTEM_UI_FLAG_IMMERSIVE_STICKY, SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN, SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION, SYSTEM_UI_FLAG_LAYOUT_STABLE, SYSTEM_UI_FLAG_LIGHT_STATUS_BAR, SYSTEM_UI_FLAG_LOW_PROFILE, SYSTEM_UI_FLAG_VISIBLE, SYSTEM_UI_LAYOUT_FLAGS, TEXT_ALIGNMENT_CENTER, TEXT_ALIGNMENT_GRAVITY, TEXT_ALIGNMENT_INHERIT, TEXT_ALIGNMENT_TEXT_END, TEXT_ALIGNMENT_TEXT_START, TEXT_ALIGNMENT_VIEW_END, TEXT_ALIGNMENT_VIEW_START, TEXT_DIRECTION_ANY_RTL, TEXT_DIRECTION_FIRST_STRONG, TEXT_DIRECTION_FIRST_STRONG_LTR, TEXT_DIRECTION_FIRST_STRONG_RTL, TEXT_DIRECTION_INHERIT, TEXT_DIRECTION_LOCALE, TEXT_DIRECTION_LTR, TEXT_DIRECTION_RTL, TRANSLATION_X, TRANSLATION_Y, TRANSLATION_Z, VISIBLE, X, Y, Z

Constructor Summary

Constructors

Constructor and Description
WorldWindow(android.content.Context context) Constructs a WorldWindow associated with the specified application context.
WorldWindow(android.content.Context context, android.util.AttributeSet attrs) Constructs a WorldWindow associated with the specified application context and attributes from an XML tag.
WorldWindow(android.content.Context context, android.opengl.GLSurfaceView.EGLConfigChooser configChooser) Constructs a WorldWindow associated with the specified application context and EGL configuration chooser.

Method Summary

Modifier and Type	Method and Description
void	addNavigatorListener(NavigatorListener listener)
boolean	cartesianToScreenPoint(double x, double y, double z, android.graphics.PointF result) Transforms a Cartesian coordinate point to Android screen coordinates.
double	distanceToViewGlobeExtents() Returns the minimum distance from the globe's surface necessary to make the globe's extents visible in this World Window.
void	doFrame(long frameTimeNanos)
boolean	geographicToScreenPoint(double latitude, double longitude, double altitude, android.graphics.PointF result) Transforms a geographic position to Android screen coordinates.
double	getFieldOfView()
FrameController	getFrameController()
FrameMetrics	getFrameMetrics()
Globe	getGlobe() Indicates the planet or celestial object displayed by this World Window.
LayerList	getLayers()
Navigator	getNavigator()
long	getNavigatorStoppedDelay()
RenderResourceCache	getRenderResourceCache()
double	getVerticalExaggeration()
WorldWindowController	getWorldWindowController()
void	onDrawFrame(javax.microedition.khronos.opengles.GL10 unused) Implements the GLSurfaceView.Renderer.onDrawFrame interface which is called on the GLThread when rendering is requested.
void	onMessage(java.lang.String name, java.lang.Object sender, java.util.Map<java.lang.Object,java.lang.Object> userProperties)
void	onPause() Called when the activity is paused.
void	onResume() Called when the activity is resumed.
void	onSurfaceChanged(javax.microedition.khronos.opengles.GL10 unused, int width, int height) Implements the GLSurfaceView.Renderer.onSurfaceChanged interface which is called on the GLThread when the window size changes.
void	onSurfaceCreated(javax.microedition.khronos.opengles.GL10 unused, javax.microedition.khronos.egl.EGLConfig config) Implements the GLSurfaceView.Renderer.onSurfaceChanged interface which is called on the GLThread when the surface is created.
boolean	onTouchEvent(android.view.MotionEvent event)
PickedObjectList	pick(float x, float y) Determines the World Wind objects displayed at a screen point.
PickedObjectList	pickShapesInRect(float x, float y, float width, float height) Determines the World Wind shapes displayed in a screen rectangle.
double	pixelSizeAtDistance(double distance) Returns the height of a pixel at a given distance from the eye point.
void	queueEvent(java.lang.Runnable r) Deprecated. See Communicating with the UI Thread instead.
boolean	rayThroughScreenPoint(float x, float y, Line result) Computes a Cartesian coordinate ray that passes through through a screen point.
void	removeNavigatorListener(NavigatorListener listener)
void	requestRedraw() Request that this World Window update its display.
void	requestRender() Deprecated. Use requestRedraw() instead.
void	setFieldOfView(double fovyDegrees)
void	setFrameController(FrameController frameController)
void	setFrameMetrics(FrameMetrics frameMetrics)
void	setGlobe(Globe globe) Sets the planet or celestial object displayed by this World Window.
void	setLayers(LayerList layers)
void	setNavigator(Navigator navigator)
void	setNavigatorStoppedDelay(long delay, java.util.concurrent.TimeUnit unit)
void	setRenderResourceCache(RenderResourceCache cache)
void	setVerticalExaggeration(double verticalExaggeration)
void	setWorldWindowController(WorldWindowController controller)
void	surfaceCreated(android.view.SurfaceHolder holder) Called immediately after the surface is first created, in which case the WorldWindow instance adds itself as a listener to the WorldWind.messageService().
void	surfaceDestroyed(android.view.SurfaceHolder holder) Called immediately before a surface is being destroyed, in which case the WorldWindow instance removes itself from WorldWind.messageService().

Methods inherited from class android.opengl.GLSurfaceView

getDebugFlags, getPreserveEGLContextOnPause, getRenderMode, setDebugFlags, setEGLConfigChooser, setEGLConfigChooser, setEGLConfigChooser, setEGLContextClientVersion, setEGLContextFactory, setEGLWindowSurfaceFactory, setGLWrapper, setPreserveEGLContextOnPause, setRenderer, setRenderMode, surfaceChanged, surfaceRedrawNeeded

Methods inherited from class android.view.SurfaceView

draw, gatherTransparentRegion, getHolder, setSecure, setVisibility, setZOrderMediaOverlay, setZOrderOnTop

Methods inherited from class android.view.View

addChildrenForAccessibility, addFocusables, addFocusables, addOnAttachStateChangeListener, addOnLayoutChangeListener, addTouchables, animate, announceForAccessibility, bringToFront, buildDrawingCache, buildDrawingCache, buildLayer, callOnClick, cancelDragAndDrop, cancelLongPress, cancelPendingInputEvents, canResolveLayoutDirection, canResolveTextAlignment, canResolveTextDirection, canScrollHorizontally, canScrollVertically, checkInputConnectionProxy, clearAnimation, clearFocus, combineMeasuredStates, computeScroll, computeSystemWindowInsets, createAccessibilityNodeInfo, createContextMenu, destroyDrawingCache, dispatchApplyWindowInsets, dispatchConfigurationChanged, dispatchDisplayHint, dispatchDragEvent, dispatchDrawableHotspotChanged, dispatchFinishTemporaryDetach, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyEventPreIme, dispatchKeyShortcutEvent, dispatchNestedFling, dispatchNestedPreFling, dispatchNestedPrePerformAccessibilityAction, dispatchNestedPreScroll, dispatchNestedScroll, dispatchPopulateAccessibilityEvent, dispatchProvideStructure, dispatchStartTemporaryDetach, dispatchSystemUiVisibilityChanged, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchWindowFocusChanged, dispatchWindowSystemUiVisiblityChanged, dispatchWindowVisibilityChanged, drawableHotspotChanged, findFocus, findViewById, findViewsWithText, findViewWithTag, focusSearch, forceHasOverlappingRendering, forceLayout, generateViewId, getAccessibilityClassName, getAccessibilityLiveRegion, getAccessibilityNodeProvider, getAccessibilityTraversalAfter, getAccessibilityTraversalBefore, getAlpha, getAnimation, getApplicationWindowToken, getBackground, getBackgroundTintList, getBackgroundTintMode, getBaseline, getBottom, getCameraDistance, getClipBounds, getClipBounds, getClipToOutline, getContentDescription, getContext, getDefaultSize, getDisplay, getDrawableState, getDrawingCache, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getElevation, getFilterTouchesWhenObscured, getFitsSystemWindows, getFocusables, getFocusedRect, getForeground, getForegroundGravity, getForegroundTintList, getForegroundTintMode, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHasOverlappingRendering, getHeight, getHitRect, getHorizontalFadingEdgeLength, getId, getImportantForAccessibility, getKeepScreenOn, getKeyDispatcherState, getLabelFor, getLayerType, getLayoutDirection, getLayoutParams, getLeft, getLocalVisibleRect, getLocationInWindow, getLocationOnScreen, getMatrix, getMeasuredHeight, getMeasuredHeightAndState, getMeasuredState, getMeasuredWidth, getMeasuredWidthAndState, getMinimumHeight, getMinimumWidth, getNextFocusDownId, getNextFocusForwardId, getNextFocusLeftId, getNextFocusRightId, getNextFocusUpId, getOnFocusChangeListener, getOutlineProvider, getOverlay, getOverScrollMode, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getParent, getParentForAccessibility, getPivotX, getPivotY, getPointerIcon, getResources, getRight, getRootView, getRootWindowInsets, getRotation, getRotationX, getRotationY, getScaleX, getScaleY, getScrollBarDefaultDelayBeforeFade, getScrollBarFadeDuration, getScrollBarSize, getScrollBarStyle, getScrollIndicators, getScrollX, getScrollY, getSolidColor, getStateListAnimator, getSystemUiVisibility, getTag, getTag, getTextAlignment, getTextDirection, getTop, getTouchables, getTouchDelegate, getTransitionName, getTranslationX, getTranslationY, getTranslationZ, getVerticalFadingEdgeLength, getVerticalScrollbarPosition, getVerticalScrollbarWidth, getViewTreeObserver, getVisibility, getWidth, getWindowId, getWindowSystemUiVisibility, getWindowToken, getWindowVisibility, getWindowVisibleDisplayFrame, getX, getY, getZ, hasFocus, hasFocusable, hasNestedScrollingParent, hasOnClickListeners, hasOverlappingRendering, hasTransientState, hasWindowFocus, inflate, invalidate, invalidate, invalidate, invalidateDrawable, invalidateOutline, isAccessibilityFocused, isActivated, isAttachedToWindow, isClickable, isContextClickable, isDirty, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isHapticFeedbackEnabled, isHardwareAccelerated, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isHovered, isImportantForAccessibility, isInEditMode, isInLayout, isInTouchMode, isLaidOut, isLayoutDirectionResolved, isLayoutRequested, isLongClickable, isNestedScrollingEnabled, isOpaque, isPaddingRelative, isPressed, isSaveEnabled, isSaveFromParentEnabled, isScrollbarFadingEnabled, isScrollContainer, isSelected, isShown, isSoundEffectsEnabled, isTemporarilyDetached, isTextAlignmentResolved, isTextDirectionResolved, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, jumpDrawablesToCurrentState, layout, measure, offsetLeftAndRight, offsetTopAndBottom, onApplyWindowInsets, onCancelPendingInputEvents, onCheckIsTextEditor, onCreateInputConnection, onDragEvent, onDrawForeground, onFilterTouchEventForSecurity, onFinishTemporaryDetach, onGenericMotionEvent, onHoverChanged, onHoverEvent, onInitializeAccessibilityEvent, onInitializeAccessibilityNodeInfo, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyPreIme, onKeyShortcut, onKeyUp, onPopulateAccessibilityEvent, onProvideStructure, onProvideVirtualStructure, onResolvePointerIcon, onRtlPropertiesChanged, onScreenStateChanged, onStartTemporaryDetach, onTrackballEvent, onVisibilityAggregated, onWindowFocusChanged, onWindowSystemUiVisibilityChanged, performAccessibilityAction, performClick, performContextClick, performContextClick, performHapticFeedback, performHapticFeedback, performLongClick, performLongClick, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, postInvalidateOnAnimation, postInvalidateOnAnimation, postOnAnimation, postOnAnimationDelayed, refreshDrawableState, removeCallbacks, removeOnAttachStateChangeListener, removeOnLayoutChangeListener, requestApplyInsets, requestFitSystemWindows, requestFocus, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestRectangleOnScreen, requestRectangleOnScreen, requestUnbufferedDispatch, resolveSize, resolveSizeAndState, restoreHierarchyState, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, sendAccessibilityEvent, sendAccessibilityEventUnchecked, setAccessibilityDelegate, setAccessibilityLiveRegion, setAccessibilityTraversalAfter, setAccessibilityTraversalBefore, setActivated, setAlpha, setAnimation, setBackground, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setBackgroundTintList, setBackgroundTintMode, setBottom, setCameraDistance, setClickable, setClipBounds, setClipToOutline, setContentDescription, setContextClickable, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setElevation, setEnabled, setFadingEdgeLength, setFilterTouchesWhenObscured, setFitsSystemWindows, setFocusable, setFocusableInTouchMode, setForeground, setForegroundGravity, setForegroundTintList, setForegroundTintMode, setHapticFeedbackEnabled, setHasTransientState, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setHovered, setId, setImportantForAccessibility, setKeepScreenOn, setLabelFor, setLayerPaint, setLayerType, setLayoutDirection, setLayoutParams, setLeft, setLongClickable, setMinimumHeight, setMinimumWidth, setNestedScrollingEnabled, setNextFocusDownId, setNextFocusForwardId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnApplyWindowInsetsListener, setOnClickListener, setOnContextClickListener, setOnCreateContextMenuListener, setOnDragListener, setOnFocusChangeListener, setOnGenericMotionListener, setOnHoverListener, setOnKeyListener, setOnLongClickListener, setOnScrollChangeListener, setOnSystemUiVisibilityChangeListener, setOnTouchListener, setOutlineProvider, setOverScrollMode, setPadding, setPaddingRelative, setPivotX, setPivotY, setPointerIcon, setPressed, setRight, setRotation, setRotationX, setRotationY, setSaveEnabled, setSaveFromParentEnabled, setScaleX, setScaleY, setScrollBarDefaultDelayBeforeFade, setScrollBarFadeDuration, setScrollbarFadingEnabled, setScrollBarSize, setScrollBarStyle, setScrollContainer, setScrollIndicators, setScrollIndicators, setScrollX, setScrollY, setSelected, setSoundEffectsEnabled, setStateListAnimator, setSystemUiVisibility, setTag, setTag, setTextAlignment, setTextDirection, setTop, setTouchDelegate, setTransitionName, setTranslationX, setTranslationY, setTranslationZ, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVerticalScrollbarPosition, setWillNotCacheDrawing, setWillNotDraw, setX, setY, setZ, showContextMenu, showContextMenu, startActionMode, startActionMode, startAnimation, startDrag, startDragAndDrop, startNestedScroll, stopNestedScroll, toString, unscheduleDrawable, unscheduleDrawable, updateDragShadow, willNotCacheDrawing, willNotDraw

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

WorldWindow

public WorldWindow(android.content.Context context)

Constructs a WorldWindow associated with the specified application context. This is the constructor to use when creating a WorldWindow from code.

WorldWindow

public WorldWindow(android.content.Context context,
                   android.opengl.GLSurfaceView.EGLConfigChooser configChooser)

Constructs a WorldWindow associated with the specified application context and EGL configuration chooser. This is the constructor to use when creating a WorldWindow from code.

WorldWindow

public WorldWindow(android.content.Context context,
                   android.util.AttributeSet attrs)

Constructs a WorldWindow associated with the specified application context and attributes from an XML tag. This constructor is included to provide support for creating WorldWindow from an Android XML layout file, and is not intended to be used directly.

This is called when a view is being constructed from an XML file, supplying attributes that were specified in the XML file. This version uses a default style of 0, so the only attribute values applied are those in the Context's Theme and the given AttributeSet.

Method Detail

getGlobe

public Globe getGlobe()

Indicates the planet or celestial object displayed by this World Window. The Cartesian coordinate system is specified by the globe's GeographicProjection. Defaults to GlobeWgs84.

Returns:

the globe displayed by this World Window

setGlobe

public void setGlobe(Globe globe)

Sets the planet or celestial object displayed by this World Window. The Cartesian coordinate system is specified by the globe's GeographicProjection.

Parameters:

globe - the globe to display

Throws:

java.lang.IllegalArgumentException - if the globe is null

getLayers

public LayerList getLayers()

setLayers

public void setLayers(LayerList layers)

getVerticalExaggeration

public double getVerticalExaggeration()

setVerticalExaggeration

public void setVerticalExaggeration(double verticalExaggeration)

getFieldOfView

public double getFieldOfView()

setFieldOfView

public void setFieldOfView(double fovyDegrees)

getNavigator

public Navigator getNavigator()

setNavigator

public void setNavigator(Navigator navigator)

addNavigatorListener

public void addNavigatorListener(NavigatorListener listener)

removeNavigatorListener

public void removeNavigatorListener(NavigatorListener listener)

getNavigatorStoppedDelay

public long getNavigatorStoppedDelay()

setNavigatorStoppedDelay

public void setNavigatorStoppedDelay(long delay,
                                     java.util.concurrent.TimeUnit unit)

getFrameController

public FrameController getFrameController()

setFrameController

public void setFrameController(FrameController frameController)

getFrameMetrics

public FrameMetrics getFrameMetrics()

setFrameMetrics

public void setFrameMetrics(FrameMetrics frameMetrics)

getWorldWindowController

public WorldWindowController getWorldWindowController()

setWorldWindowController

public void setWorldWindowController(WorldWindowController controller)

getRenderResourceCache

public RenderResourceCache getRenderResourceCache()

setRenderResourceCache

public void setRenderResourceCache(RenderResourceCache cache)

pick

public PickedObjectList pick(float x,
                             float y)

Determines the World Wind objects displayed at a screen point. The screen point is interpreted as coordinates in Android screen pixels relative to this View.

If the screen point intersects any number of World Wind shapes, the returned list contains a picked object identifying the top shape at the screen point. This picked object includes the shape renderable (or its non-null pick delegate) and the World Wind layer that displayed the shape. Shapes which are either hidden behind another shape at the screen point or hidden behind terrain at the screen point are omitted from the returned list. Therefore if the returned list contains a picked object identifying a shape, it is always marked as 'on top'.

If the screen point intersects the World Wind terrain, the returned list contains a picked object identifying the associated geographic position. If there are no shapes in the World Wind scene between the terrain and the screen point, the terrain picked object is marked as 'on top'.

This returns an empty list when nothing in the World Wind scene intersects the screen point, when the screen point is outside this View's bounds, or if the OpenGL thread displaying the World Window's scene is paused (or becomes paused while this method is executing).

Parameters:

x - the screen point's X coordinate in Android screen pixels

y - the screen point's Y coordinate in Android screen pixels

Returns:

a list of World Wind objects at the screen point

pickShapesInRect

public PickedObjectList pickShapesInRect(float x,
                                         float y,
                                         float width,
                                         float height)

Determines the World Wind shapes displayed in a screen rectangle. The screen rectangle is interpreted as coordinates in Android screen pixels relative to this view.

If the screen rectangle intersects any number of World Wind shapes, the returned list contains a picked object identifying the all of the top shapes in the rectangle. This picked object includes the shape renderable (or its non-null pick delegate) and the World Wind layer that displayed the shape. Shapes which are entirely hidden behind another shape in the screen rectangle or are entirely hidden behind terrain in the screen rectangle are omitted from the returned list.

This returns an empty list when no shapes in the World Wind scene intersect the screen rectangle, when the screen rectangle is outside this View's bounds, or if the OpenGL thread displaying the World Window's scene is paused (or becomes paused while this method is executing).

Parameters:

x - the screen rectangle's X coordinate in Android screen pixels

y - the screen rectangle's Y coordinate in Android screen pixels

width - the screen rectangle's width in Android screen pixels

height - the screen rectangle's height in Android screen pixels

Returns:

a list of World Wind shapes in the screen rectangle

cartesianToScreenPoint

public boolean cartesianToScreenPoint(double x,
                                      double y,
                                      double z,
                                      android.graphics.PointF result)

Transforms a Cartesian coordinate point to Android screen coordinates. The resultant screen point is in Android screen pixels relative to this View.

This stores the converted point in the result argument, and returns a boolean value indicating whether or not the converted is successful. This returns false if the Cartesian point is clipped by either the World Window's near clipping plane or far clipping plane.

Parameters:

x - the Cartesian point's x component in meters

y - the Cartesian point's y component in meters

z - the Cartesian point's z component in meters

result - a pre-allocated PointF in which to return the screen point

Returns:

true if the transformation is successful, otherwise false

Throws:

java.lang.IllegalArgumentException - If the result is null

geographicToScreenPoint

public boolean geographicToScreenPoint(double latitude,
                                       double longitude,
                                       double altitude,
                                       android.graphics.PointF result)

Transforms a geographic position to Android screen coordinates. The resultant screen point is in Android screen pixels relative to this View.

This stores the converted point in the result argument, and returns a boolean value indicating whether or not the converted is successful. This returns false if the Cartesian point is clipped by either of the World Window's near clipping plane or far clipping plane.

Parameters:

latitude - the position's latitude in degrees

longitude - the position's longitude in degrees

altitude - the position's altitude in meters

result - a pre-allocated PointF in which to return the screen point

Returns:

true if the transformation is successful, otherwise false

Throws:

java.lang.IllegalArgumentException - If the result is null

rayThroughScreenPoint

public boolean rayThroughScreenPoint(float x,
                                     float y,
                                     Line result)

Computes a Cartesian coordinate ray that passes through through a screen point. The screen point is interpreted as coordinates in Android screen pixels relative to this View.

Parameters:

x - the screen point's X coordinate in Android screen pixels

y - the screen point's Y coordinate in Android screen pixels

result - a pre-allocated Line in which to return the computed ray

Returns:

the result set to the computed ray in Cartesian coordinates

Throws:

java.lang.IllegalArgumentException - If the result is null

pixelSizeAtDistance

public double pixelSizeAtDistance(double distance)

Returns the height of a pixel at a given distance from the eye point. This method assumes the model of a screen composed of rectangular pixels, where pixel coordinates denote infinitely thin space between pixels. The units of the returned size are in meters per pixel.

The result of this method is undefined if the distance is negative.

Parameters:

distance - the distance from the eye point in meters

Returns:

the pixel height in meters per pixel

distanceToViewGlobeExtents

public double distanceToViewGlobeExtents()

Returns the minimum distance from the globe's surface necessary to make the globe's extents visible in this World Window.

Returns:

the distance in meters needed to view the entire globe

requestRedraw

public void requestRedraw()

Request that this World Window update its display. Prior changes to this World Window's Navigator, Globe and Layers (including the contents of layers) are reflected on screen sometime after calling this method. May be called from any thread.

doFrame

public void doFrame(long frameTimeNanos)

Specified by:

doFrame in interface android.view.Choreographer.FrameCallback

requestRender

@Deprecated
public void requestRender()

Deprecated. Use requestRedraw() instead.

Requests that this World Window's OpenGL renderer display another frame on the OpenGL thread. Does not cause the World Window's to display changes in its Navigator, Globe or Layers. Use requestRedraw() instead.

Overrides:

requestRender in class android.opengl.GLSurfaceView

queueEvent

@Deprecated
public void queueEvent(java.lang.Runnable r)

Deprecated. See Communicating with the UI Thread instead.

Queues a runnable to be executed on this World Window's OpenGL thread. Must not be used to affect changes to this World Window's state, including the Navigator, Globe and Layers. See the Android developers guide on Communicating with the UI Thread instead.

Overrides:

queueEvent in class android.opengl.GLSurfaceView

Parameters:

r - the runnable to execute

onSurfaceCreated

public void onSurfaceCreated(javax.microedition.khronos.opengles.GL10 unused,
                             javax.microedition.khronos.egl.EGLConfig config)

Implements the GLSurfaceView.Renderer.onSurfaceChanged interface which is called on the GLThread when the surface is created.

Specified by:

onSurfaceCreated in interface android.opengl.GLSurfaceView.Renderer

onSurfaceChanged

public void onSurfaceChanged(javax.microedition.khronos.opengles.GL10 unused,
                             int width,
                             int height)

Implements the GLSurfaceView.Renderer.onSurfaceChanged interface which is called on the GLThread when the window size changes.

Specified by:

onSurfaceChanged in interface android.opengl.GLSurfaceView.Renderer

onDrawFrame

public void onDrawFrame(javax.microedition.khronos.opengles.GL10 unused)

Implements the GLSurfaceView.Renderer.onDrawFrame interface which is called on the GLThread when rendering is requested.

Specified by:

onDrawFrame in interface android.opengl.GLSurfaceView.Renderer

surfaceCreated

public void surfaceCreated(android.view.SurfaceHolder holder)

Called immediately after the surface is first created, in which case the WorldWindow instance adds itself as a listener to the WorldWind.messageService(). The WorldWind.messageService is a facility for broadcasting global redraw requests to active WorldWindows.

Specified by:

surfaceCreated in interface android.view.SurfaceHolder.Callback

Overrides:

surfaceCreated in class android.opengl.GLSurfaceView

Parameters:

holder - the SurfaceHolder whose surface is being created

surfaceDestroyed

public void surfaceDestroyed(android.view.SurfaceHolder holder)

Called immediately before a surface is being destroyed, in which case the WorldWindow instance removes itself from WorldWind.messageService(). Failure to do so may result in a memory leak this WorldWindow instance when its owner is release/collected.

Specified by:

surfaceDestroyed in interface android.view.SurfaceHolder.Callback

Overrides:

surfaceDestroyed in class android.opengl.GLSurfaceView

Parameters:

holder - the SurfaceHolder whose surface is being destroyed

onPause

public void onPause()

Called when the activity is paused. Calling this method will pause the rendering thread, cause any outstanding pick operations to return an empty pick list, and prevent subsequent calls to pick and requestRedraw to return without performing any action.

Overrides:

onPause in class android.opengl.GLSurfaceView

onResume

public void onResume()

Called when the activity is resumed. Calling this method will resume the rendering thread and enable subsequent calls to pick and requestRedraw to function normally.

Overrides:

onResume in class android.opengl.GLSurfaceView

onTouchEvent

public boolean onTouchEvent(android.view.MotionEvent event)

Overrides:

onTouchEvent in class android.view.View

onMessage

public void onMessage(java.lang.String name,
                      java.lang.Object sender,
                      java.util.Map<java.lang.Object,java.lang.Object> userProperties)

Specified by:

onMessage in interface MessageListener