com.mousebird.maply

Class MapController

java.lang.Object

com.mousebird.maply.BaseController

com.mousebird.maply.MapController

All Implemented Interfaces:

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

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

The MaplyController is the main object in the Maply library when using a 2D map. 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	MapController.GestureDelegate Use this delegate when you want user interface feedback from the maply controller.
static class	MapController.Settings Settings are parameters we need at the very start of the setup process.

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
MapController.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
MapController(android.app.Activity mainActivity) Initialize a new map controller with the standard (spherical mercator) coordinate system.
MapController(android.app.Activity mainActivity, MapController.Settings settings) Construct with the activity and a coordinate system.

Method Summary

Modifier and Type	Method and Description
void	animatePositionGeo(double x, double y, double z, double howLong) Animate to a new view position
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.
double	getHeading() Return the current heading.
Point3d	getPositionGeo() Return the position in lat/lon in radians.
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 void	InitCoordSys(android.app.Activity mainActivity, CoordSystem coordSys, Point3d displayCenter, int clearColor)
boolean	onTouch(android.view.View view, android.view.MotionEvent e)
void	panDidEnd(boolean userMotion)
void	panDidStart(boolean userMotion)
void	processLongPress(Point2d screenLoc) Called by the gesture handler to let us know the user long pressed somewhere
void	processTap(Point2d screenLoc)
void	rotateDidEnd(boolean userMotion)
void	rotateDidStart(boolean userMotion)
Point2d	screenPointFromGeo(Point2d geoCoord) Return the screen coordinate for a given geographic coordinate (in radians).
void	setAllowPan(boolean allowPan) If set, the user can pan around.
void	setAllowRotateGesture(boolean allowRotate) If set we'll allow the user to rotate.
void	setAllowZoom(boolean allowZoom) If set, the user can zoom in and out.
void	setHeading(double heading) Set the heading for the current visual.
void	setPositionGeo(double x, double y, double z) Set the current view position.
protected void	setupTheRest(com.mousebird.maply.CoordSystemDisplayAdapter inCoordAdapter, int clearColor)
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	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 MapController.GestureDelegate gestureDelegate

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

Constructor Detail

MapController

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

Construct with the activity and a coordinate system. You use this one if you're using a custom coordinate system.

Parameters:

mainActivity - The activity this is part of.

MapController

public MapController(android.app.Activity mainActivity)

Initialize a new map controller with the standard (spherical mercator) coordinate system.

Method Detail

InitCoordSys

protected void InitCoordSys(android.app.Activity mainActivity,
                            CoordSystem coordSys,
                            Point3d displayCenter,
                            int clearColor)

Init

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

setupTheRest

protected void setupTheRest(com.mousebird.maply.CoordSystemDisplayAdapter inCoordAdapter,
                            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

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.

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.

getCurrentViewGeo

public Mbr getCurrentViewGeo()

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

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.

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.

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()

Return the position in lat/lon in radians. Height is height above the plane, which around M_PI in size.

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)

Set the heading for the current visual. 0 is due north.

getHeading

public double getHeading()

Return the current heading. 0 is due north.

setAllowRotateGesture

public void setAllowRotateGesture(boolean allowRotate)

If set we'll allow the user to rotate. If not, we'll keep north up at all times.

setAllowZoom

public void setAllowZoom(boolean allowZoom)

If set, the user can zoom in and out. If not set, they can't. On by default.

setAllowPan

public void setAllowPan(boolean allowPan)

If set, the user can pan around. If not set, they can't. On by default.

processTap

public void processTap(Point2d screenLoc)

processLongPress

public void processLongPress(Point2d screenLoc)

Called by the gesture handler to let us know the user long pressed somewhere

Parameters:

screenLoc -

onTouch

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

Specified by:

onTouch in interface android.view.View.OnTouchListener

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: