com.mousebird.maply

Class GlobeController

java.lang.Object

com.mousebird.maply.BaseController

com.mousebird.maply.GlobeController

All Implemented Interfaces:

android.view.Choreographer.FrameCallback, android.view.View.OnTouchListener, RenderController.TaskManager, RenderControllerInterface

public class GlobeController
extends BaseController
implements android.view.View.OnTouchListener, android.view.Choreographer.FrameCallback

The GlobeController is the main object in the Maply library when using a 3D globe. Toolkit users add and remove their geometry through here.

The controller starts by creating an OpenGL ES surface and handling all the various setup between Maply and that surface. It also kicks off a LayerThread, which it uses to queue requests to the rest of Maply.

Once the controller is set up and running the toolkit user can make calls to add and remove geometry. Those calls are thread safe.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	GlobeController.GestureDelegate Use this delegate when you want user interface feedback from the maply controller.
static class	GlobeController.Settings Settings needed on startup so we can create the proper elements.
class	GlobeController.ViewState This encapulates the entire view state.

Nested classes/interfaces inherited from class com.mousebird.maply.BaseController

BaseController.ScreenshotListener

Nested classes/interfaces inherited from interface com.mousebird.maply.RenderControllerInterface

RenderControllerInterface.ContextInfo, RenderControllerInterface.TextureSettings, RenderControllerInterface.ThreadMode

Field Summary

Fields

Modifier and Type	Field and Description
GlobeController.GestureDelegate	gestureDelegate Set the gesture delegate to get callbacks when the user taps somewhere.

Fields inherited from class com.mousebird.maply.BaseController

activity, coordAdapter, frameInterval, httpClient, metroThread, renderControl, renderWrapper, running, scene, view

Constructor Summary

Constructors

Constructor and Description
GlobeController(android.app.Activity mainActivity)
GlobeController(android.app.Activity mainActivity, GlobeController.Settings settings)

Method Summary

Modifier and Type	Method and Description
void	animatePositionGeo(double x, double y, double z, double howLong) Animate to a new view position
Point3d	displayPointFromGeo(Point3d geoPt) Return a point in display space.
void	doFrame(long frameTimeNanos) Frame callback for the Choreographer
double	findHeightToViewBounds(Mbr mbr, Point2d pos) For a given position, how high do we have to be to see the given area.
Point2d	geoPointFromScreen(Point2d screenPt) Return the geographic point (radians) corresponding to the screen point.
Mbr	getCurrentViewGeo() Returns what the user is currently looking at in geographic extents.
GlobeView	getGlobeView()
boolean	getKeepNorthUp() True if the globe is keeping north facing up on the screen.
Point3d	getPositionGeo() Returns the position in on the globe in terms of longitude and latitude in radians and height.
GlobeController.ViewState	getViewState() Return a simple description of the view state parameters.
Point3d[]	getVisibleCorners() Calculate visible corners for what's currently being seen.
void	handleStartMoving(boolean userMotion) Called by the gesture handler to filter out start motion events.
void	handleStopMoving(boolean userMotion) Called by the gesture handler to filter out end motion events.
protected void	Init(android.app.Activity mainActivity, int clearColor)
protected boolean	isCompletelySetup()
Point3d	modelPointFromScreen(Point2d screenPt) Return the model point corresponding to a screen point.
boolean	onTouch(android.view.View view, android.view.MotionEvent e)
void	panDidEnd(boolean userMotion)
void	panDidStart(boolean userMotion)
void	processLongPress(Point2d screenLoc) Set the gesture delegate to fire callbacks when the user did long press somwhere
void	processTap(Point2d screenLoc)
Point2d	realWorldSizeFromScreen(Point2d pt0, Point2d pt1) Calculate a size in meters by projecting the two screen points onto the globe.
void	rotateDidEnd(boolean userMotion)
void	rotateDidStart(boolean userMotion)
Point2d	screenPointFromGeo(Point2d geoCoord) Return the screen coordinate for a given geographic coordinate (in radians).
void	setAllowTilt(boolean allowTilt) Call this to allow the user to tilt with three fingers.
void	setAutoRotate(float autoRotateInterval, float autoRotateDegrees) This turns on an auto-rotate mode.
void	setHeading(double heading)
void	setKeepNorthUp(boolean newVal) Set the keep north up parameter on or off.
void	setPositionGeo(double x, double y, double z) Set the current view position.
void	setViewState(GlobeController.ViewState viewState) Set all the view parameters at once.
void	setZoomLimits(double inMin, double inMax) Set the zoom limits for the globe.
void	shutdown() Call shutdown when you're done with the MaplyController.
void	tiltDidEnd(boolean userMotion)
void	tiltDidStart(boolean userMotion)
void	zoomDidEnd(boolean userMotion)
void	zoomDidStart(boolean userMotion)

Methods inherited from class com.mousebird.maply.BaseController

addActiveObject, addActiveObjectAtStart, addBillboards, addClusterGenerator, addLayer, addLight, addLoftedPoly, addLoftedPolys, addMainThreadTask, addMainThreadTaskAfter, addMarker, addMarkers, addParticleBatch, addParticleSystem, addPoints, addPoints, addPostSurfaceRunnable, addRenderTarget, addScreenLabel, addScreenLabels, addScreenMarker, addScreenMarkers, addScreenMovingLabels, addScreenMovingMarkers, addShaderProgram, addShapes, addStickers, addTask, addTexture, addTexture, addTileFetcher, addVector, addVectors, addWideVector, addWideVectors, changeRenderTarget, changeSticker, changeVector, clearLights, clearRenderTarget, clearTempContext, createTexture, currentMapScale, currentMapZoom, disableObject, disableObjects, displayCoord, enableObject, enableObjects, findSamplingLayer, geoPointFromScreenBatch, getActivity, getContentView, getCoordSystem, getFrameBufferSize, getFrameSize, getHttpClient, getLayerThread, getMaxLineWidth, getObjectAtScreenLoc, getObjectsAtScreenLoc, getOfflineMode, getRenderController, getScene, getShader, getViewSize, getWorkingThread, heightForMapScale, Init, instanceVectors, instanceWideVectors, makeLayerThread, processChangeSet, releaseSamplingLayer, removeActiveObject, removeLayer, removeLayerThread, removeLight, removeObject, removeObjects, removeRenderTarget, removeShader, removeTexture, removeTextures, removeTexturesByID, rendererIsAttached, requestRender, resetLights, screenPointFromGeoBatch, setClearColor, setDisplayRate, setEGLContext, setPerfInterval, setupTempContext, setViewExtents, takeScreenshot, usesTextureView

Methods inherited from class java.lang.Object

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

Field Detail

gestureDelegate

public GlobeController.GestureDelegate gestureDelegate

Set the gesture delegate to get callbacks when the user taps somewhere.

Constructor Detail

GlobeController

public GlobeController(android.app.Activity mainActivity,
                       GlobeController.Settings settings)

GlobeController

public GlobeController(android.app.Activity mainActivity)

Method Detail

Init

protected void Init(android.app.Activity mainActivity,
                    int clearColor)

shutdown

public void shutdown()

Description copied from class: BaseController

Call shutdown when you're done with the MaplyController. It will shut down the layer thread(s) and all the associated logic.

Overrides:

shutdown in class BaseController

getGlobeView

public GlobeView getGlobeView()

getKeepNorthUp

public boolean getKeepNorthUp()

True if the globe is keeping north facing up on the screen.

setKeepNorthUp

public void setKeepNorthUp(boolean newVal)

Set the keep north up parameter on or off. On means we will always rotate the globe to keep north up. Off means we won't.

setAllowTilt

public void setAllowTilt(boolean allowTilt)

Call this to allow the user to tilt with three fingers.

screenPointFromGeo

public Point2d screenPointFromGeo(Point2d geoCoord)

Return the screen coordinate for a given geographic coordinate (in radians).

Overrides:

screenPointFromGeo in class BaseController

Parameters:

geoCoord - Geographic coordinate to convert (in radians).

Returns:

Screen coordinate.

setZoomLimits

public void setZoomLimits(double inMin,
                          double inMax)

Set the zoom limits for the globe.

Parameters:

inMin - Closest the user is allowed to zoom in.

inMax - Farthest the user is allowed to zoom out.

geoPointFromScreen

public Point2d geoPointFromScreen(Point2d screenPt)

Return the geographic point (radians) corresponding to the screen point.

Overrides:

geoPointFromScreen in class BaseController

Parameters:

screenPt - Input point on the screen.

Returns:

The geographic coordinate (radians) corresponding to the screen point.

modelPointFromScreen

public Point3d modelPointFromScreen(Point2d screenPt)

Return the model point corresponding to a screen point. Models space is centered on the globe with a radius of 1.0. Will return nil if the screen point does not intersect the globe.

getCurrentViewGeo

public Mbr getCurrentViewGeo()

Returns what the user is currently looking at in geographic extents.

displayPointFromGeo

public Point3d displayPointFromGeo(Point3d geoPt)

Return a point in display space. Display space is close to what's rendered. For the globe it's a model space based on a radius of 1.0.

findHeightToViewBounds

public double findHeightToViewBounds(Mbr mbr,
                                     Point2d pos)

For a given position, how high do we have to be to see the given area.

Even for 2D maps we represent things in terms of height.

Parameters:

mbr - Bounding box for the area we want to see in geographic (radians).

pos - Center of the viewing area in geographic (radians).

Returns:

Returns a height for the viewer.

realWorldSizeFromScreen

public Point2d realWorldSizeFromScreen(Point2d pt0,
                                       Point2d pt1)

Calculate a size in meters by projecting the two screen points onto the globe. Return -1, -1 if the points weren't on the globe.

setViewState

public void setViewState(GlobeController.ViewState viewState)

Set all the view parameters at once.

getViewState

public GlobeController.ViewState getViewState()

Return a simple description of the view state parameters.

setPositionGeo

public void setPositionGeo(double x,
                           double y,
                           double z)

Set the current view position.

Parameters:

x - Horizontal location of the center of the screen in geographic radians (not degrees).

y - Vertical location of the center of the screen in geographic radians (not degrees).

z - Height above the map in display units.

getPositionGeo

public Point3d getPositionGeo()

Returns the position in on the globe in terms of longitude and latitude in radians and height. Height is height above the globe. The globe has a radius of 1.0.

isCompletelySetup

protected boolean isCompletelySetup()

animatePositionGeo

public void animatePositionGeo(double x,
                               double y,
                               double z,
                               double howLong)

Animate to a new view position

Parameters:

x - Horizontal location of the center of the screen in geographic radians (not degrees).

y - Vertical location of the center of the screen in geographic radians (not degrees).

z - Height above the map in display units.

howLong - Time (in seconds) to animate.

setHeading

public void setHeading(double heading)

setAutoRotate

public void setAutoRotate(float autoRotateInterval,
                          float autoRotateDegrees)

This turns on an auto-rotate mode. The globe will start rotating after a delay by the given number of degrees per second. Very pleasant.

Parameters:

autoRotateInterval - Wait this number of seconds after user interaction to auto rotate.

autoRotateDegrees - Rotate this number of degrees (not radians) per second.

processTap

public void processTap(Point2d screenLoc)

processLongPress

public void processLongPress(Point2d screenLoc)

Set the gesture delegate to fire callbacks when the user did long press somwhere

Parameters:

screenLoc -

onTouch

public boolean onTouch(android.view.View view,
                       android.view.MotionEvent e)

Specified by:

onTouch in interface android.view.View.OnTouchListener

tiltDidStart

public void tiltDidStart(boolean userMotion)

tiltDidEnd

public void tiltDidEnd(boolean userMotion)

panDidStart

public void panDidStart(boolean userMotion)

panDidEnd

public void panDidEnd(boolean userMotion)

zoomDidStart

public void zoomDidStart(boolean userMotion)

zoomDidEnd

public void zoomDidEnd(boolean userMotion)

rotateDidStart

public void rotateDidStart(boolean userMotion)

rotateDidEnd

public void rotateDidEnd(boolean userMotion)

handleStartMoving

public void handleStartMoving(boolean userMotion)

Called by the gesture handler to filter out start motion events.

Parameters:

userMotion - Set if kicked off by user motion.

handleStopMoving

public void handleStopMoving(boolean userMotion)

Called by the gesture handler to filter out end motion events.

Parameters:

userMotion - Set if kicked off by user motion.

doFrame

public void doFrame(long frameTimeNanos)

Frame callback for the Choreographer

Specified by:

doFrame in interface android.view.Choreographer.FrameCallback

getVisibleCorners

public Point3d[] getVisibleCorners()

Calculate visible corners for what's currently being seen. If the eye point is too high, expect null corners.

Returns: