com.atakmap.android.maps.graphics

Class AbstractGLMapItem2

java.lang.Object

com.atakmap.android.maps.graphics.AbstractGLMapItem2

All Implemented Interfaces:

GLMapItem2, MapItem.OnClickableChangedListener, MapItem.OnVisibleChangedListener, MapItem.OnZOrderChangedListener

Direct Known Subclasses:

GLAssociation2, GLDogHouse, GLImageOverlay, GLPointMapItem2, GLRubberImage, GLRubberModel, GLShape2

public abstract class AbstractGLMapItem2
extends java.lang.Object
implements GLMapItem2, MapItem.OnVisibleChangedListener, MapItem.OnZOrderChangedListener, MapItem.OnClickableChangedListener

Nested Class Summary

Nested classes/interfaces inherited from interface com.atakmap.android.maps.graphics.GLMapItem2

GLMapItem2.OnBoundsChangedListener, GLMapItem2.OnVisibleChangedListener

Field Summary

Fields

Modifier and Type	Field and Description
protected MutableGeoBounds	bounds
protected boolean	clickable
protected MapRenderer	context
protected static double	DEFAULT_MAX_ALT
protected static double	DEFAULT_MIN_ALT
protected double	minMapGsd
protected int	renderPass
protected MapItem	subject
protected boolean	visible
protected double	zOrder

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractGLMapItem2(MapRenderer context, MapItem subject, int renderPass)

Method Summary

Modifier and Type	Method and Description
void	addBoundsListener(GLMapItem2.OnBoundsChangedListener l)
void	addVisibleListener(GLMapItem2.OnVisibleChangedListener l)
protected void	dispatchOnBoundsChanged()
protected void	dispatchOnVisibleChanged()
static void	forward(GLMapView ortho, java.nio.Buffer pBuf, java.nio.FloatBuffer vBuf, GeoBounds bounds)
static void	forward(GLMapView ortho, java.nio.Buffer pBuf, int srcSize, java.nio.FloatBuffer vBuf, int dstSize, GeoBounds bounds)
static void	forward(GLMapView ortho, GeoPoint gp, PointD point)
static void	forward(GLMapView ortho, GeoPoint gp, PointD point, double unwrap) Transforms the specified coordinate, applying any elevation adjustments (e.g.
static void	forward(GLMapView ortho, GeoPoint gp, PointD point, double unwrap, double terrain)
static void	forward(GLMapView ortho, GeoPoint gp, PointD point, double unwrap, double terrain, boolean clampSubAlt) Transforms the specified coordinate, applying any elevation adjustments (e.g.
static void	forward(GLMapView ortho, GeoPoint gp, android.graphics.PointF retval, double unwrap)
void	getBounds(MutableGeoBounds bnds)
boolean	getClampToGroundAtNadir()
protected boolean	getClickable() Determine whether or not this item is touchable By default this is tied to MapItem.getClickable()
double	getMinDrawResolution()
java.lang.Object	getOpaque() Returns the data previously set via the call to GLMapItem2.setOpaque(Object).
int	getRenderPass()
MapItem	getSubject()
double	getZOrder()
HitTestResult	hitTest(MapRenderer3 renderer, HitTestQueryParameters params) Hit test control implementation that checks touchability Sub-classes should override the hitTestImpl(MapRenderer3, HitTestQueryParameters) method
protected HitTestResult	hitTestImpl(MapRenderer3 renderer, HitTestQueryParameters params) Perform a hit test on this map item Sub-classes should override this method for hit-testing
boolean	isVisible()
protected void	markSurfaceDirty(boolean realtime)
void	onClickableChanged(MapItem item)
void	onVisibleChanged(MapItem item)
void	onZOrderChanged(MapItem item)
void	release()
void	removeBoundsListener(GLMapItem2.OnBoundsChangedListener l)
void	removeVisibleListener(GLMapItem2.OnVisibleChangedListener l)
protected void	runOnGLThread(java.lang.Runnable r) Run a method on the GL thread Unlike calling MapRenderer#queueEvent directly, this will run the method immediately if we're already on the GL thread
void	setClampToGroundAtNadir(boolean v) Rendering style modified by the ClampToGroundControl
void	setOpaque(java.lang.Object opaque) Sets opaque data that can be used by the renderer.
void	startObserving() Start observing the subject.
void	stopObserving() Stops observing the subject.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MIN_ALT

protected static final double DEFAULT_MIN_ALT

See Also:

Constant Field Values

DEFAULT_MAX_ALT

protected static final double DEFAULT_MAX_ALT

See Also:

Constant Field Values

context

protected final MapRenderer context

subject

protected final MapItem subject

renderPass

protected final int renderPass

visible

protected boolean visible

bounds

protected final MutableGeoBounds bounds

zOrder

protected double zOrder

clickable

protected boolean clickable

minMapGsd

protected double minMapGsd

Constructor Detail

AbstractGLMapItem2

protected AbstractGLMapItem2(MapRenderer context,
                             MapItem subject,
                             int renderPass)

Method Detail

getSubject

public final MapItem getSubject()

Specified by:

getSubject in interface GLMapItem2

setOpaque

public final void setOpaque(java.lang.Object opaque)

Description copied from interface: GLMapItem2

Sets opaque data that can be used by the renderer. Only the object that has taken ownership of rendering this GLMapItem should invoke this method.

This method serves as a convenience to allow the render to store application specific data with an item.

Specified by:

setOpaque in interface GLMapItem2

Parameters:

opaque - An object

getOpaque

public final java.lang.Object getOpaque()

Description copied from interface: GLMapItem2

Returns the data previously set via the call to GLMapItem2.setOpaque(Object). This method should really only be invoked by the object that set the opaque data.

This method serves as a convenience to allow the render to obtain the application specific data that has been previously associated with an item.

Specified by:

getOpaque in interface GLMapItem2

Returns:

The previously set data.

startObserving

public void startObserving()

Description copied from interface: GLMapItem2

Start observing the subject. This method should register callback listeners on any properties of the subject that would affect its rendered representation.

Invoking this method should generally refresh the state of the item.

This method may not be invoked on the GL context thread.

Specified by:

startObserving in interface GLMapItem2

stopObserving

public void stopObserving()

Stops observing the subject. This method should unwind any callback listeners registered via startObserving().

This method may not be invoked on the GL context thread.

Specified by:

stopObserving in interface GLMapItem2

getRenderPass

public final int getRenderPass()

release

public void release()

isVisible

public final boolean isVisible()

Specified by:

isVisible in interface GLMapItem2

getZOrder

public final double getZOrder()

Specified by:

getZOrder in interface GLMapItem2

getMinDrawResolution

public final double getMinDrawResolution()

Specified by:

getMinDrawResolution in interface GLMapItem2

setClampToGroundAtNadir

public void setClampToGroundAtNadir(boolean v)

Rendering style modified by the ClampToGroundControl

Parameters:

v - True if at NADIR the item is clamped to ground

getClampToGroundAtNadir

public boolean getClampToGroundAtNadir()

addBoundsListener

public final void addBoundsListener(GLMapItem2.OnBoundsChangedListener l)

Specified by:

addBoundsListener in interface GLMapItem2

removeBoundsListener

public final void removeBoundsListener(GLMapItem2.OnBoundsChangedListener l)

Specified by:

removeBoundsListener in interface GLMapItem2

dispatchOnBoundsChanged

protected final void dispatchOnBoundsChanged()

addVisibleListener

public final void addVisibleListener(GLMapItem2.OnVisibleChangedListener l)

Specified by:

addVisibleListener in interface GLMapItem2

removeVisibleListener

public final void removeVisibleListener(GLMapItem2.OnVisibleChangedListener l)

Specified by:

removeVisibleListener in interface GLMapItem2

dispatchOnVisibleChanged

protected final void dispatchOnVisibleChanged()

getBounds

public final void getBounds(MutableGeoBounds bnds)

Specified by:

getBounds in interface GLMapItem2

onVisibleChanged

public final void onVisibleChanged(MapItem item)

Specified by:

onVisibleChanged in interface MapItem.OnVisibleChangedListener

onZOrderChanged

public final void onZOrderChanged(MapItem item)

Specified by:

onZOrderChanged in interface MapItem.OnZOrderChangedListener

onClickableChanged

public void onClickableChanged(MapItem item)

Specified by:

onClickableChanged in interface MapItem.OnClickableChangedListener

hitTest

public final HitTestResult hitTest(MapRenderer3 renderer,
                                   HitTestQueryParameters params)

Hit test control implementation that checks touchability Sub-classes should override the hitTestImpl(MapRenderer3, HitTestQueryParameters) method

Parameters:

renderer - GL instance of the map view

params - Query parameters

getClickable

protected boolean getClickable()

Determine whether or not this item is touchable By default this is tied to MapItem.getClickable()

Returns:

True if touchable

hitTestImpl

protected HitTestResult hitTestImpl(MapRenderer3 renderer,
                                    HitTestQueryParameters params)

Perform a hit test on this map item Sub-classes should override this method for hit-testing

Parameters:

renderer - Map renderer

params - Query parameters

Returns:

Hit test result or null if not hit

runOnGLThread

protected void runOnGLThread(java.lang.Runnable r)

Run a method on the GL thread Unlike calling MapRenderer#queueEvent directly, this will run the method immediately if we're already on the GL thread

Parameters:

r - Runnable

markSurfaceDirty

protected final void markSurfaceDirty(boolean realtime)

forward

public static void forward(GLMapView ortho,
                           GeoPoint gp,
                           PointD point,
                           double unwrap)

Transforms the specified coordinate, applying any elevation adjustments (e.g. exaggeration/offset) that is used by the renderer. The value is returned via point.

If gp does not have a valid altitude, or its altitude is below the terrain surface, the terrain surface value will be used.

Parameters:

ortho - The view

gp - The LLA coordinate

point - Returns the x,y,z for the coordinate

unwrap - Longitudinal unwrap value (360, -360, or 0 to ignore)

forward

public static void forward(GLMapView ortho,
                           GeoPoint gp,
                           PointD point,
                           double unwrap,
                           double terrain,
                           boolean clampSubAlt)

Transforms the specified coordinate, applying any elevation adjustments (e.g. exaggeration/offset) that is used by the renderer. The value is returned via point.

If gp does not have a valid altitude, or its altitude is below the terrain surface, the terrain surface value will be used.

Parameters:

ortho - The view

gp - The LLA coordinate

point - Returns the x,y,z for the coordinate

unwrap - Longitudinal unwrap value (360, -360, or 0 to ignore)

terrain - The local terrain value at the location

clampSubAlt - True to clamp sub-terrain altitude to the ground

forward

public static void forward(GLMapView ortho,
                           GeoPoint gp,
                           PointD point,
                           double unwrap,
                           double terrain)

forward

public static void forward(GLMapView ortho,
                           GeoPoint gp,
                           PointD point)

forward

public static void forward(GLMapView ortho,
                           GeoPoint gp,
                           android.graphics.PointF retval,
                           double unwrap)

forward

public static void forward(GLMapView ortho,
                           java.nio.Buffer pBuf,
                           java.nio.FloatBuffer vBuf,
                           GeoBounds bounds)

forward

public static void forward(GLMapView ortho,
                           java.nio.Buffer pBuf,
                           int srcSize,
                           java.nio.FloatBuffer vBuf,
                           int dstSize,
                           GeoBounds bounds)