com.bbn.openmap.omGraphics
Interface OMGraphicHandler

All Known Implementing Classes:

AmpLinkLayer, AOILayer, AreaShapeLayer, ASRPLayer, BasicLayer, BoundsTestLayer, BufferedLayer, BufferedLinkLayer, BufferedShapeLayer, CSVTiledImagePlugIn, DateLayer, DayNightLayer, DemoLayer, DrawingToolLayer, DrawLinkLayer, DTEDCoverageLayer, DTEDFrameCacheLayer, DTEDLayer, E00Layer, EarthquakeLayer, EditorLayer, EsriLayer, ETOPOJarLayer, ETOPOLayer, EventLayer, FilterSupport, GeoCrossDemoLayer, GeoIntersectionLayer, GeoTestLayer, GraphicLoaderPlugIn, GraticuleLayer, ImageTileLayer, InteractionLayer, LabelLayer, LinkLayer, LocationLayer, MapTileLayer, MapTileUtilLayer, MIFLayer, MultiRoadLayer, MultiShapeLayer, MysqlGeometryLayer, NexradLayer, OMGraphicHandlerLayer, OMGraphicHandlerPlugIn, PlotLayer, PlugInLayer, ProjectionResponseLayer, RpfLayer, ScaleDisplayLayer, ShapeLayer, SimpleAnimationLayer, TerrainLayer, TestLayer, TimelineLayer, TimerLocationLayer, TimeSliderLayer, UTMGridPlugIn, VPFFeatureLayer, VPFLayer, VPFRoadLayer

public interface OMGraphicHandler

This interface describes an object that manages OMGraphics. It provides a mechanism to filter what OMGraphics are displayed based on some criteria, and can also return graphics based on those criteria. It's assumed that when a filter is applied to an OMGraphicHandler, that it stays in place until resetFiltering() is called. Calling multiple filters sets a chain.

Method Summary

boolean	canSetList() Indicates if the OMGraphicHandler can have its OMGraphicList set.
boolean	doAction(OMGraphic graphic, OMAction action) Allows the OMGraphicHandler to receive graphics or take some action on one.
OMGraphicList	filter(java.awt.Shape withinThisShape) Filters the OMGraphicHandler graphic list so that graphics within the given shape will be visible.
OMGraphicList	filter(java.awt.Shape shapeBoundary, boolean getInsideBoundary) Filters the OMGraphicHandler graphic list so that graphics inside or outside the given shape will be visible.
OMGraphicList	filter(java.lang.String SQLQuery) Filters the OMGraphicHandler graphic list so that graphics meeting the SQL query statement will be visible.
OMGraphicList	getList() Return the graphic list currently being used by the OMGraphicHandler.
void	resetFiltering() Remove all filters, and reset all graphics to be visible.
void	setList(OMGraphicList omgl) Set the OMGraphicList within this OMGraphicHandler.
boolean	supportsSQL() Returns true if the OMGraphicHandler can handle SQL statements for filtering.

Method Detail

filter

OMGraphicList filter(java.awt.Shape withinThisShape)

Filters the OMGraphicHandler graphic list so that graphics within the given shape will be visible. Returns an OMGeometryList with those visible shapes. The returned list should not be assumed to be the same OMGraphicList object that is maintained inside the OMGraphicHandler. Same as calling filter(withinThisShape, true).

Parameters:

withinThisShape - java.awt.Shape object defining a boundary.

Returns:

OMGraphicList containing OMGraphics that are within the Shape.

filter

OMGraphicList filter(java.awt.Shape shapeBoundary,
                     boolean getInsideBoundary)

Filters the OMGraphicHandler graphic list so that graphics inside or outside the given shape will be visible. Returns an OMGraphicList with those visible shapes. The returned list should not be assumed to be the same OMGraphicList object that is maintained inside the OMGraphicHandler.

Parameters:

shapeBoundary - java.awt.Shape object defining a boundary.

getInsideBoundary - if true, the filter will look for shapes inside and contacting the boundary. If false, the filter will look for shapes outside the boundary.

Returns:

OMGraphicList containing OMGraphics that are within the Shape.

supportsSQL

boolean supportsSQL()

Returns true if the OMGraphicHandler can handle SQL statements for filtering.

filter

OMGraphicList filter(java.lang.String SQLQuery)

Filters the OMGraphicHandler graphic list so that graphics meeting the SQL query statement will be visible. Returns an OMGraphicList with those visible shapes. The returned list should not be assumed to be the same OMGraphicList object that is maintained inside the OMGraphicHandler.

Parameters:

SQLQuery - a SELECT SQL statement

Returns:

OMGraphicList containing OMGraphics that meet the SELECT statement criteria.

doAction

boolean doAction(OMGraphic graphic,
                 OMAction action)

Allows the OMGraphicHandler to receive graphics or take some action on one.

Parameters:

graphic - the OMGraphic to do the action on.

action - the OMAction describing what to do to the graphic.

Returns:

true if the action was able to be carried out.

getList

OMGraphicList getList()

Return the graphic list currently being used by the OMGraphicHandler. If filters have been applied, then the OMGraphics that have made it through the filter are visible.

See Also:

OMGeometry.isVisible()

canSetList

boolean canSetList()

Indicates if the OMGraphicHandler can have its OMGraphicList set.

setList

void setList(OMGraphicList omgl)

Set the OMGraphicList within this OMGraphicHandler. Works if canSetGraphicList == true.

resetFiltering

void resetFiltering()

Remove all filters, and reset all graphics to be visible.