Package edu.cnu.mdi.mapping.item

Class MapPolylineItem

java.lang.Object

edu.cnu.mdi.item.AItem

edu.cnu.mdi.mapping.item.AMapItem

edu.cnu.mdi.mapping.item.AMapMultiPointItem

edu.cnu.mdi.mapping.item.MapPolylineItem

All Implemented Interfaces:

IFeedbackProvider, IDrawable, EventListener

public class MapPolylineItem
extends AMapMultiPointItem

A map-native open polyline defined by an ordered array of geographic vertices, with each consecutive segment rendered as a great-circle arc.

Use cases

Flight routes, ship tracks, hiking trails, pipeline routes, or any sequence of waypoints that should follow the surface of the Earth rather than a straight line in projection space.

Geometry

Each edge between adjacent vertices is sampled as a great-circle arc by MapGraphics, which handles seam splitting automatically for global projections. The polyline is open: the last vertex is not connected back to the first. To create a closed shape use MapPolygonItem.

Interaction

• Drag — moves all vertices by the geographic delta of the mouse.
• Resize — moves the grabbed handle vertex to the cursor.
• Rotate — not supported (see AMapMultiPointItem class doc).

Creation

Typically created by MapToolHandler from a polyline rubberband gesture:

 Point2D.Double[] latLons = ...; // convert screen vertices to geographic
 MapPolylineItem item = new MapPolylineItem(layer, latLons);
 

Nested Class Summary

Nested classes/interfaces inherited from class edu.cnu.mdi.mapping.item.AMapMultiPointItem

AMapMultiPointItem.MultiPointStartState

Field Summary

Fields inherited from class edu.cnu.mdi.mapping.item.AMapMultiPointItem

_latLons, _projectedShape

Fields inherited from class edu.cnu.mdi.item.AItem

_connectable, _deletable, _dirty, _displayName, _doubleClickable, _draggable, _enabled, _focus, _FOCUSFILL, _lastDrawnPolygon, _layer, _line, _locked, _modification, _path, _popupMenu, _resizable, _resizePolicy, _rightClickable, _rotatable, _selectable, _selected, _style, _styleEditable, _visible, rotateIcon, RPSIZE, RPSIZE2, SPSIZE, SPSIZE2

Constructor Summary

Constructors

Constructor	Description
MapPolylineItem(Layer layer, Point2D.Double[] latLons)	Creates a map-native great-circle polyline.
MapPolylineItem(Layer layer, Point2D.Double[] latLons, Object... keyVals)	Creates a map-native great-circle polyline with optional property key/value pairs.

Method Summary

Modifier and Type	Method	Description
protected MapGraphics.ProjectedMapShape	buildShape(MapContainer mc)	Build the projected shape from the current vertices.
protected boolean	containsPoint(MapGraphics.ProjectedMapShape shape, Point screenPoint)	Tests whether a screen point hits the projected shape.
void	drawItem(Graphics2D g2, IContainer container)	Draws each edge as a seam-aware great-circle arc and caches the projected shape for subsequent hit-testing and bounds queries.

Methods inherited from class edu.cnu.mdi.mapping.item.AMapMultiPointItem

contains, copyVertices, ensureProjectedShape, getBounds, getFeedbackStrings, getLatLons, getSelectionPoints, getVertexCount, getWorldBounds, localToLatLon, modify, prepareForRemoval, projectLatLon, setDirty, setLatLons, shouldDraw, startModification, translateWorld, updateFocus

Methods inherited from class edu.cnu.mdi.mapping.item.AMapItem

getFocusPoint

Methods inherited from class edu.cnu.mdi.item.AItem

acceptModification, applyGeometryProperties, applyProperties, applyStyleProperties, createPopupMenu, doubleClicked, draw, drawSelections, enclosed, equals, focusFill, geometryChanged, getAzimuth, getContainer, getDisplayName, getFocus, getItemModification, getLastDrawnPolygon, getLayer, getLine, getPath, getPopupMenu, getResizePolicy, getRotatePoint, getStyle, getStyleSafe, getView, hashCode, inASelectRect, inRotatePoint, inSelectPoint, isConnectable, isDeletable, isDirty, isDoubleClickable, isDraggable, isEnabled, isLocked, isResizable, isRightClickable, isRotatable, isSelectable, isSelected, isStyleEditable, isTrackable, isVisible, modificationRejected, prepareForPopup, setAzimuth, setConnectable, setDeletable, setDisplayName, setDoubleClickable, setDraggable, setEnabled, setFillFocus, setFocus, setLocked, setModification, setResizable, setResizePolicy, setRightClickable, setRotatable, setSelectable, setSelected, setStyle, setStyleEditable, setVisible, stopModification, translateLocal

Methods inherited from class java.lang.Object

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

Methods inherited from interface edu.cnu.mdi.graphics.drawable.IDrawable

getName

Constructor Details

MapPolylineItem

public MapPolylineItem(Layer layer,
 Point2D.Double[] latLons)

Creates a map-native great-circle polyline.

Parameters:

layer - the layer this item lives on; must not be null

latLons - geographic vertices in radians (x = longitude, y = latitude); must not be null, length ≥ 2

MapPolylineItem

public MapPolylineItem(Layer layer,
 Point2D.Double[] latLons,
 Object... keyVals)

Creates a map-native great-circle polyline with optional property key/value pairs.

Parameters:

layer - the layer this item lives on; must not be null

latLons - geographic vertices in radians; must not be null, length ≥ 2

keyVals - optional PropertyUtils key/value pairs

Method Details

drawItem

public void drawItem(Graphics2D g2,
 IContainer container)

Draws each edge as a seam-aware great-circle arc and caches the projected shape for subsequent hit-testing and bounds queries.

Specified by:

drawItem in class AItem

Parameters:

g2 - the graphics context

container - the rendering container; must be a MapContainer

buildShape

protected MapGraphics.ProjectedMapShape buildShape(MapContainer mc)

Build the projected shape from the current vertices.

Use MapGraphics.buildProjectedPolyline(edu.cnu.mdi.mapping.container.MapContainer, java.awt.geom.Point2D.Double[]) for open items, MapGraphics.buildProjectedPolygon(edu.cnu.mdi.mapping.container.MapContainer, java.awt.geom.Point2D.Double[]) for closed items.

Builds an open (polyline) projected shape.

Specified by:

buildShape in class AMapMultiPointItem

Parameters:

mc - the owning map container

Returns:

projected shape; never null

containsPoint

protected boolean containsPoint(MapGraphics.ProjectedMapShape shape,
 Point screenPoint)

Description copied from class: AMapMultiPointItem

Tests whether a screen point hits the projected shape.

Default: 6-pixel proximity (correct for open polylines). MapPolygonItem overrides to also test interior containment.

Overrides:

containsPoint in class AMapMultiPointItem

Parameters:

shape - projected shape (may be null)

screenPoint - device-space test point

Returns:

true if the point hits the shape