ShapeEditor (NASA WorldWind)

java.lang.Object
- gov.nasa.worldwind.util.ShapeEditor

All Implemented Interfaces:

SelectListener, java.beans.PropertyChangeListener, java.util.EventListener

Direct Known Subclasses:

ShapeEditingExtension.ShapeEditorExtension
```
public class ShapeEditor
extends java.lang.Object
implements SelectListener, java.beans.PropertyChangeListener
```
Provides a user interface for editing a shape and performs editing. Depending on the shape type, the shape is shown with control points for vertex locations and size. All shapes are shown with a handle that provides rotation.
Left-drag on the shape's body moves the whole shape. Left-drag on a control point performs the action associated with that control point. The editor provides vertex insertion and removal for airspace Polygon, Curtain, Route and Track shapes, and SurfacePolygon and SurfacePolyline. Shift-left-click when the cursor is over the shape inserts a control point at the cursor's position. Alt-left-click when the cursor is over a control point removes that control point. Control points are added to the ends of airspace Polygon, Curtain, Route and Track, and SurfacePolyline by shift-left-click on the first or last control point of the shape.
This editor supports airspaces other than Cake and all surface shapes except SurfaceMultiPolygon and SurfaceImage.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected static class ShapeEditor.ControlPointMarker
Represents editor control points.

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`ShapeEditor.ControlPointMarker` Represents editor control points.

Field Summary

Fields
Modifier and Type	Field and Description
`protected RenderableLayer`	`accessoryLayer` The layer holding the rotation line and perhaps other affordances.
`protected boolean`	`active` Indicates whether the editor is in the midst of an editing operation.
`protected int`	`activeOperation` Indicates the current editing operation, one of NONE, MOVING or SIZING.
`protected MarkerAttributes`	`angleControlPointAttributes` Attributes used to represent shape rotation and other angular features.
`protected EditorAnnotation`	`annotation` The control point annotation.
`protected static java.lang.String`	`ANNOTATION` Indicates that a control point is associated with annotation.
`protected RenderableLayer`	`annotationLayer` The layer holding the control point's annotation.
`protected boolean`	`armed` Indicates whether the editor is ready for editing.
`protected MarkerLayer`	`controlPointLayer` The layer holding the editor's control points.
`protected SelectEvent`	`currentEvent` The event most recently recieved by the selection method.
`protected Angle`	`currentHeading` For shapes without an inherent heading, the current heading established by the editor for the shape.
`protected ShapeEditor.ControlPointMarker`	`currentSizingMarker` The control point associated with the current sizing operation.
`protected boolean`	`extensionEnabled` Indicates whether shapes with sub-segments such as Route and Track may be edited to add and remove legs.
`protected static java.lang.String`	`HEIGHT` Indicates that a control point is associated with height change.
`protected static java.lang.String`	`INNER_MAJOR_RADIUS` Indicates that a control point is associated with the inner major radius of a shape.
`protected static java.lang.String`	`INNER_MINOR_RADIUS` Indicates that a control point is associated with the inner minor radius of a shape.
`protected static java.lang.String`	`INNER_RADIUS` Indicates that a control point is associated with the inner radius of a shape.
`protected static java.lang.String`	`LEFT_AZIMUTH` Indicates that a control point is associated with the left azimuth of a shape.
`protected static java.lang.String`	`LEFT_WIDTH` Indicates that a control point is associated with the left width of a shape.
`protected static java.lang.String`	`LOCATION` Indicates a control point is associated with a location.
`protected MarkerAttributes`	`locationControlPointAttributes` Attributes used to represent shape vertices.
`protected static int`	`MOVING` Editor state indicating that the shape is being moved.
`protected static int`	`NONE` Editor state indicating that the shape is not being resized or moved.
`protected ShapeAttributes`	`originalAttributes` The attributes associated with the shape when the editor is constructed.
`protected ShapeAttributes`	`originalHighlightAttributes` The highlight attributes associated with the shape when the editor is constructed.
`protected static java.lang.String`	`OUTER_MAJOR_RADIUS` Indicates that a control point is associated with the outer major radius of a shape.
`protected static java.lang.String`	`OUTER_MINOR_RADIUS` Indicates that a control point is associated with the outer minor radius of a shape.
`protected static java.lang.String`	`OUTER_RADIUS` Indicates that a control point is associated with the outer radius of a shape.
`protected Position`	`previousPosition` The terrain position associated with the cursor during the just previous drag event.
`protected static java.lang.String`	`RIGHT_AZIMUTH` Indicates that a control point is associated with the right azimuth of a shape.
`protected static java.lang.String`	`RIGHT_WIDTH` Indicates that a control point is associated with the right width of a shape.
`protected static java.lang.String`	`ROTATION` Indicates that a control point is associated with whole-shape rotation.
`protected RenderableLayer`	`shadowLayer` The layer holding a shadow copy of the shape while the shape is being moved or sized.
`protected Renderable`	`shape` The shape associated with the editor.
`protected MarkerAttributes`	`sizeControlPointAttributes` Attributes used to represent shape size.
`protected static int`	`SIZING` Editor state indicating that the shape is being sized or otherwise respecified.
`protected java.util.List<Box>`	`trackAdjacencyList` Indicates track legs that are adjacent to their previous leg in the track.
`protected UnitsFormat`	`unitsFormat` The units formatter to use when creating control point annotations.
`protected static java.lang.String`	`WIDTH` Indicates that a control point is associated with width change.
`protected WorldWindow`	`wwd` The `WorldWindow` associated with the shape.

Constructor Summary

Constructors
Constructor and Description

ShapeEditor(WorldWindow wwd, Renderable originalShape)
Constructs an editor for a specified shape.

Constructors
Constructor and Description
`ShapeEditor(WorldWindow wwd, Renderable originalShape)` Constructs an editor for a specified shape.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected int`	`addNearestLocation(Position terrainPosition, double altitude, java.util.List<LatLon> locations)` Inserts the location nearest to a specified position on an edge of a specified list of locations into the appropriate place in that list.
`protected void`	`adjustShape()` Performs shape-specific minor modifications to shapes after editing operation are performed.
`protected void`	`adjustTrackShape()` Restores adjacency of `TrackAirspace` shapes.
`protected void`	`appendLocation(ShapeEditor.ControlPointMarker controlPoint, java.util.List<LatLon> locations)` Adds a location to either the beginning or the end of a specified list of locations.
`protected Vec4`	`computeControlPointDelta(LatLon previousLocation, LatLon currentLocation)` Computes the Cartesian difference between two control points.
`protected Position`	`computeEdgeLocation(LatLon center, LatLon location, double length)` Computes a control point location at the edge of a shape.
`protected Position`	`computeRectangularEdgeLocation(LatLon begin, LatLon end, double width)` Computes a control point location at the edge of a rectangular shape.
`protected void`	`determineTrackAdjacency()` Determines and stores internally the adjacency of successive track legs.
`protected void`	`disable()` Called by `setArmed(boolean)` to remove resources no longer needed after editing.
`protected double`	`doGetControlPointAltitude(LatLon location, Renderable shape)`
`protected Renderable`	`doMakeShadowShape()` Creates and returns the stationary shape displayed during editing operations.
`protected void`	`doReshapeShape(ShapeEditor.ControlPointMarker controlPoint, Position terrainPosition)` Called by `reshapeShape(ShapeEditor.ControlPointMarker)` to perform the actual shape modification.
`protected void`	`dragWholeShape(DragSelectEvent dragEvent)` Moves the entire shape according to a specified drag event.
`protected void`	`enable()` Called by `setArmed(boolean)` to initialize this editor.
`RenderableLayer`	`getAccessoryLayer()` Indicates the accessory layer used by this editor.
`int`	`getActiveOperation()` Indicates the current operation being performed, either SIZING, MOVING or NONE.
`MarkerAttributes`	`getAngleControlPointAttributes()` Indicates the attributes associated with angle control points.
`EditorAnnotation`	`getAnnotation()` Indicates the annotation used to show locations and measurements.
`RenderableLayer`	`getAnnotationLayer()` Indicates the annotation layer used by this editor.
`protected double`	`getControlPointAltitude(LatLon location)` Computes the appropriate absolute altitude at which to place a control point at a specified location.
`MarkerLayer`	`getControlPointLayer()` Indicates the control point layer used by this editor.
`SelectEvent`	`getCurrentEvent()` Indicates the event most recently passed to the select handler.
`Angle`	`getCurrentHeading()` Indicates the current rotation heading.
`ShapeEditor.ControlPointMarker`	`getCurrentSizingMarker()` Indicates the control point currently used in the operation underway.
`MarkerAttributes`	`getLocationControlPointAttributes()` Indicates the attributes associated with location control points.
`ShapeAttributes`	`getOriginalAttributes()` Indicates the attributes associated with the shape when the editor was created.
`ShapeAttributes`	`getOriginalHighlightAttributes()` Indicates the highlight attributes associated with the shape prior to their being changed to achieve shape transparency.
`Position`	`getPreviousPosition()` Returns the geographic position associated with the previous select event.
`RenderableLayer`	`getShadowLayer()` Indicates the shadow layer used by this editor.
`Renderable`	`getShape()` Indicates the shape associated with this editor.
`protected int`	`getShapeAltitudeMode()` Indicates the current shape's altitude mode if the shape has one.
`protected LatLon`	`getShapeCenter()` Returns the shape's center location, or null if it has no designated center.
`MarkerAttributes`	`getSizeControlPointAttributes()` Indicates the attributes associated with size control points.
`UnitsFormat`	`getUnitsFormat()` Indicates the units formatter associated with this editor.
`WorldWindow`	`getWwd()` Indicates the WorldWindow associated with this editor.
`boolean`	`isActive()` Indicates whether an editing operation is currently underway.
`boolean`	`isArmed()` Indicates whether this editor is armed.
`boolean`	`isExtensionEnabled()` Indicates whether multi-segment shapes such as Route and Track may be edited to add or remove segments.
`protected static boolean`	`isRadiiValid(double innerRadius, double outerRadius)`
`protected ShapeEditor.ControlPointMarker`	`makeControlPoint(Position position, MarkerAttributes attributes, int id, int leg, java.lang.String purpose)` Creates a control point.
`protected ShapeEditor.ControlPointMarker`	`makeControlPoint(Position position, MarkerAttributes attributes, int id, java.lang.String purpose)` Creates a control point.
`protected void`	`makeControlPointAttributes()`
`protected void`	`makeShadowShape()` Creates the shape that will remain at the same location and is the same size as the shape to be edited.
`protected void`	`moveLocation(ShapeEditor.ControlPointMarker controlPoint, Position terrainPosition, java.util.List<LatLon> locations)` Moves a control point location.
`protected Vec4`	`nearestPointOnSegment(Vec4 p1, Vec4 p2, Vec4 point)` Computes the point on a specified line segment that is nearest a specified point.
`protected Angle`	`normalizedHeading(Angle originalHeading, Angle deltaHeading)` Add a specified increment to an angle and normalize the result to be between 0 and 360 degrees.
`void`	`propertyChange(java.beans.PropertyChangeEvent event)` The property change listener, the method called when a property of the Scene Controller changes (vertical exaggeration, etc.).
`protected void`	`removeShadowShape()` Remove the shadow shape.
`protected void`	`reshapeCappedCylinder(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)` Performs an edit for `CappedCylinder` shapes.
`protected void`	`reshapeCappedEllipticalCylinder(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)` Performs an edit for `CappedCylinder` shapes.
`protected void`	`reshapeOrbit(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)` Performs an edit for `Orbit` shapes.
`protected void`	`reshapePolygonAirspace(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)` Performs an edit for `Polygon` shapes.
`protected void`	`reshapeRoute(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)` Performs an edit for `Route` shapes.
`protected void`	`reshapeShape(ShapeEditor.ControlPointMarker controlPoint)` Modifies the shape's locations, size or rotation.
`protected void`	`reshapeSphere(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)` Performs an edit for `SphereAirspace` shapes.
`protected void`	`reshapeSurfaceCircle(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)`
`protected void`	`reshapeSurfaceEllipse(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)`
`protected void`	`reshapeSurfacePolygon(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)`
`protected void`	`reshapeSurfaceQuad(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)`
`protected void`	`reshapeSurfaceSquare(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)`
`protected void`	`reshapeTrack(Position terrainPosition, ShapeEditor.ControlPointMarker controlPoint)` Performs an edit for `TrackAirspace` shapes.
`protected void`	`rotateLocations(Position terrainPosition, java.util.List<LatLon> locations)` Rotates a shape's locations.
`void`	`selected(SelectEvent event)` The select handler, the method called when the user selects (rolls over, left clicks, etc.) the shape or a control point.
`void`	`setArmed(boolean armed)` Arms or disarms the editor.
`void`	`setExtensionEnabled(boolean extensionEnabled)` Specifies whether multi-segment shapes such as Route and Track may be edited to add or remove segments.
`void`	`setUnitsFormat(UnitsFormat unitsFormat)` Specifies the units formatter to use when creating editor annotations.
`protected void`	`updateAnnotation(ShapeEditor.ControlPointMarker controlPoint)` Updates the annotation associated with a specified control point.
`protected void`	`updateCappedCylinderControlPoints()` Updates the control points and affordances for `CappedCylinder` shapes.
`protected void`	`updateCappedEllipticalCylinderControlPoints()` Updates the control points and affordances for `CappedCylinder` shapes.
`protected void`	`updateControlPoints()` Updates the control points to the locations of the currently edited shape.
`protected void`	`updateOrbitControlPoints()` Updates the control points and affordances for `Orbit` shapes.
`protected void`	`updateOrientationLine(Position centerPosition, Position controlPoint)` Updates the line designating the shape's central axis.
`protected void`	`updatePartialCappedCylinderControlPoints()` Updates the control points and affordances for `PartialCappedCylinder` shapes.
`protected void`	`updatePolygonAirspaceControlPoints()` Updates the control points and affordances for `Polygon` shapes.
`protected void`	`updateRouteControlPoints()` Updates the control points and affordances for `Route` shapes.
`protected void`	`updateShapeAnnotation()` Updates the annotation indicating the edited shape's center.
`protected void`	`updateSphereControlPoints()` Updates the control points and affordances for `SphereAirspace` shapes.
`protected void`	`updateSurfaceCircleControlPoints()`
`protected void`	`updateSurfaceEllipseControlPoints()`
`protected void`	`updateSurfacePolygonControlPoints()`
`protected void`	`updateSurfaceQuadControlPoints()`
`protected void`	`updateSurfaceSquareControlPoints()`
`protected void`	`updateTrackControlPoints()` Updates the control points and affordances for `TrackAirspace` shapes.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - accessoryLayer
```
protected RenderableLayer accessoryLayer
```
    The layer holding the rotation line and perhaps other affordances.
  - active
```
protected boolean active
```
    Indicates whether the editor is in the midst of an editing operation.
  - activeOperation
```
protected int activeOperation
```
    Indicates the current editing operation, one of NONE, MOVING or SIZING.
  - angleControlPointAttributes
```
protected MarkerAttributes angleControlPointAttributes
```
    Attributes used to represent shape rotation and other angular features.
  - annotation
```
protected EditorAnnotation annotation
```
    The control point annotation.
  - ANNOTATION
```
protected static java.lang.String ANNOTATION
```
    Indicates that a control point is associated with annotation.
  - annotationLayer
```
protected RenderableLayer annotationLayer
```
    The layer holding the control point's annotation.
  - armed
```
protected boolean armed
```
    Indicates whether the editor is ready for editing.
  - controlPointLayer
```
protected MarkerLayer controlPointLayer
```
    The layer holding the editor's control points.
  - currentEvent
```
protected SelectEvent currentEvent
```
    The event most recently recieved by the selection method.
  - currentHeading
```
protected Angle currentHeading
```
    For shapes without an inherent heading, the current heading established by the editor for the shape.
  - currentSizingMarker
```
protected ShapeEditor.ControlPointMarker currentSizingMarker
```
    The control point associated with the current sizing operation.
  - extensionEnabled
```
protected boolean extensionEnabled
```
    Indicates whether shapes with sub-segments such as Route and Track may be edited to add and remove legs.
  - HEIGHT
```
protected static java.lang.String HEIGHT
```
    Indicates that a control point is associated with height change.
  - INNER_MAJOR_RADIUS
```
protected static java.lang.String INNER_MAJOR_RADIUS
```
    Indicates that a control point is associated with the inner major radius of a shape.
  - INNER_MINOR_RADIUS
```
protected static java.lang.String INNER_MINOR_RADIUS
```
    Indicates that a control point is associated with the inner minor radius of a shape.
  - INNER_RADIUS
```
protected static java.lang.String INNER_RADIUS
```
    Indicates that a control point is associated with the inner radius of a shape.
  - LEFT_AZIMUTH
```
protected static java.lang.String LEFT_AZIMUTH
```
    Indicates that a control point is associated with the left azimuth of a shape.
  - LEFT_WIDTH
```
protected static java.lang.String LEFT_WIDTH
```
    Indicates that a control point is associated with the left width of a shape.
  - LOCATION
```
protected static java.lang.String LOCATION
```
    Indicates a control point is associated with a location.
  - locationControlPointAttributes
```
protected MarkerAttributes locationControlPointAttributes
```
    Attributes used to represent shape vertices.
  - MOVING
```
protected static final int MOVING
```
    Editor state indicating that the shape is being moved.
    
    See Also:
    
    Constant Field Values
  - NONE
```
protected static final int NONE
```
    Editor state indicating that the shape is not being resized or moved.
    
    See Also:
    
    Constant Field Values
  - originalAttributes
```
protected ShapeAttributes originalAttributes
```
    The attributes associated with the shape when the editor is constructed. These are swapped out during editing operations in order to make the shape semi-transparent.
  - originalHighlightAttributes
```
protected ShapeAttributes originalHighlightAttributes
```
    The highlight attributes associated with the shape when the editor is constructed. These are swapped out during editing operations in order to make the shape semi-transparent.
  - OUTER_MAJOR_RADIUS
```
protected static java.lang.String OUTER_MAJOR_RADIUS
```
    Indicates that a control point is associated with the outer major radius of a shape.
  - OUTER_MINOR_RADIUS
```
protected static java.lang.String OUTER_MINOR_RADIUS
```
    Indicates that a control point is associated with the outer minor radius of a shape.
  - OUTER_RADIUS
```
protected static java.lang.String OUTER_RADIUS
```
    Indicates that a control point is associated with the outer radius of a shape.
  - previousPosition
```
protected Position previousPosition
```
    The terrain position associated with the cursor during the just previous drag event.
  - RIGHT_AZIMUTH
```
protected static java.lang.String RIGHT_AZIMUTH
```
    Indicates that a control point is associated with the right azimuth of a shape.
  - RIGHT_WIDTH
```
protected static java.lang.String RIGHT_WIDTH
```
    Indicates that a control point is associated with the right width of a shape.
  - ROTATION
```
protected static java.lang.String ROTATION
```
    Indicates that a control point is associated with whole-shape rotation.
  - shadowLayer
```
protected RenderableLayer shadowLayer
```
    The layer holding a shadow copy of the shape while the shape is being moved or sized.
  - shape
```
protected Renderable shape
```
    The shape associated with the editor. Specified at construction and not subsequently modifiable.
  - sizeControlPointAttributes
```
protected MarkerAttributes sizeControlPointAttributes
```
    Attributes used to represent shape size.
  - SIZING
```
protected static final int SIZING
```
    Editor state indicating that the shape is being sized or otherwise respecified.
    
    See Also:
    
    Constant Field Values
  - trackAdjacencyList
```
protected java.util.List<Box> trackAdjacencyList
```
    Indicates track legs that are adjacent to their previous leg in the track.
  - unitsFormat
```
protected UnitsFormat unitsFormat
```
    The units formatter to use when creating control point annotations.
  - WIDTH
```
protected static java.lang.String WIDTH
```
    Indicates that a control point is associated with width change.
  - wwd
```
protected final WorldWindow wwd
```
    The WorldWindow associated with the shape.
- Constructor Detail
  - ShapeEditor
```
public ShapeEditor(WorldWindow wwd,
                   Renderable originalShape)
```
    Constructs an editor for a specified shape. Once constructed, the editor must be armed to operate. See setArmed(boolean).
    
    Parameters:
    
    wwd - the WorldWindow associated with the specified shape.
    
    originalShape - the shape to edit.
    
    Throws:
    
    java.lang.IllegalArgumentException - if either the specified WorldWindow or shape is null.
- Method Detail
  - addNearestLocation
```
protected int addNearestLocation(Position terrainPosition,
                                 double altitude,
                                 java.util.List<LatLon> locations)
```
    Inserts the location nearest to a specified position on an edge of a specified list of locations into the appropriate place in that list.
    
    Parameters:
    
    terrainPosition - the position to find a nearest point for.
    
    altitude - the altitude to use when determining the nearest point. Can be approximate and is not necessarily the altitude of the terrain position.
    
    locations - the list of locations. This list is modified by this method to contain the new location on an edge nearest the specified terrain position.
    
    Returns:
    
    the index at which the new location was inserted into the list.
  - adjustShape
```
protected void adjustShape()
```
    Performs shape-specific minor modifications to shapes after editing operation are performed. Some editing operations cause positions that are originally identical to become slightly different and thereby disrupt the original connectivity of the shape. This is the case for track-airspace legs, for instance. This method is called just after editing operations are performed in order to give the editor a chance to reform connectivity or otherwise modify the shape to retain its original properties. Subclasses should override this method if they are aware of shapes other than those recognized by default and those shapes need such adjustment during editing.
  - adjustTrackShape
```
protected void adjustTrackShape()
```
    Restores adjacency of TrackAirspace shapes. Called by adjustShape().
  - appendLocation
```
protected void appendLocation(ShapeEditor.ControlPointMarker controlPoint,
                              java.util.List<LatLon> locations)
```
    Adds a location to either the beginning or the end of a specified list of locations. Which end to add to is determined by a specified control point.
    
    Parameters:
    
    controlPoint - the control point of the shape's end. If the control point's ID is 0 the new location is inserted to the beginning of the list. If the control point ID corresponds to the last location in the list then the new location is appended to the list. Otherwise no operation occurs.
    
    locations - the shape's locations. This list is modified upon return to include the new location.
  - computeControlPointDelta
```
protected Vec4 computeControlPointDelta(LatLon previousLocation,
                                        LatLon currentLocation)
```
    Computes the Cartesian difference between two control points.
    
    Parameters:
    
    previousLocation - the location nof the previous control point.
    
    currentLocation - the location of the current control point.
    
    Returns:
    
    the Cartesian difference between the two control points.
  - computeEdgeLocation
```
protected Position computeEdgeLocation(LatLon center,
                                       LatLon location,
                                       double length)
```
    Computes a control point location at the edge of a shape.
    
    Parameters:
    
    center - the shape's center.
    
    location - a location that forms a line from the shape's center along the shape's axis. The returned location is on the edge indicated by the cross product of a vector normal to the surface at the specified center and a vector from the center to this location.
    
    length - the distance of the edge from the shape's center.
    
    Returns:
    
    a location at the shape's edge at the same location along the shape's axis as the specified center location.
  - computeRectangularEdgeLocation
```
protected Position computeRectangularEdgeLocation(LatLon begin,
                                                  LatLon end,
                                                  double width)
```
    Computes a control point location at the edge of a rectangular shape.
    
    Parameters:
    
    begin - the beginning of the shape's center.
    
    end - the end of the shape's center.
    
    width - the distance of the edge from the great circle arc between begin and end.
    
    Returns:
    
    a location centered along the edge parallel to the great circle arc between begin and end.
  - determineTrackAdjacency
```
protected void determineTrackAdjacency()
```
    Determines and stores internally the adjacency of successive track legs. Called during editor arming.
  - disable
```
protected void disable()
```
    Called by setArmed(boolean) to remove resources no longer needed after editing.
  - doGetControlPointAltitude
```
protected double doGetControlPointAltitude(LatLon location,
                                           Renderable shape)
```
  - doMakeShadowShape
```
protected Renderable doMakeShadowShape()
```
    Creates and returns the stationary shape displayed during editing operations. Subclasses should override this method to create shadow shapes appropriate to the editor's shape.
    
    Returns:
    
    the new shadow shape created, or null if the shape type is not recognized.
  - doReshapeShape
```
protected void doReshapeShape(ShapeEditor.ControlPointMarker controlPoint,
                              Position terrainPosition)
```
    Called by reshapeShape(ShapeEditor.ControlPointMarker) to perform the actual shape modification. Subclasses should override this method if they provide editing for shapes other than those supported by the basic editor.
    
    Parameters:
    
    controlPoint - the control point selected.
    
    terrainPosition - the terrain position under the cursor.
  - dragWholeShape
```
protected void dragWholeShape(DragSelectEvent dragEvent)
```
    Moves the entire shape according to a specified drag event.
    
    Parameters:
    
    dragEvent - the event initiating the move.
  - enable
```
protected void enable()
```
    Called by setArmed(boolean) to initialize this editor.
  - getAccessoryLayer
```
public RenderableLayer getAccessoryLayer()
```
    Indicates the accessory layer used by this editor.
    
    Returns:
    
    the accessory layer used by this editor.
  - getActiveOperation
```
public int getActiveOperation()
```
    Indicates the current operation being performed, either SIZING, MOVING or NONE.
    
    Returns:
    
    the current operation underway.
  - getAngleControlPointAttributes
```
public MarkerAttributes getAngleControlPointAttributes()
```
    Indicates the attributes associated with angle control points.
    
    Returns:
    
    the attributes associated with angle control points.
  - getAnnotation
```
public EditorAnnotation getAnnotation()
```
    Indicates the annotation used to show locations and measurements.
    
    Returns:
    
    the annotation used to show shape locations and measurements.
  - getAnnotationLayer
```
public RenderableLayer getAnnotationLayer()
```
    Indicates the annotation layer used by this editor.
    
    Returns:
    
    the annotation layer used by this editor.
  - getControlPointAltitude
```
protected double getControlPointAltitude(LatLon location)
```
    Computes the appropriate absolute altitude at which to place a control point at a specified location.
    
    Parameters:
    
    location - the location of the control point.
    
    Returns:
    
    the appropriate altitude at which to place the control point.
  - getControlPointLayer
```
public MarkerLayer getControlPointLayer()
```
    Indicates the control point layer used by this editor.
    
    Returns:
    
    the control point layer used by this editor.
  - getCurrentEvent
```
public SelectEvent getCurrentEvent()
```
    Indicates the event most recently passed to the select handler.
    
    Returns:
    
    the event most recently passed to the select handler.
  - getCurrentHeading
```
public Angle getCurrentHeading()
```
    Indicates the current rotation heading. This is updated as shapes are rotated.
    
    Returns:
    
    the current rotation heading.
  - getCurrentSizingMarker
```
public ShapeEditor.ControlPointMarker getCurrentSizingMarker()
```
    Indicates the control point currently used in the operation underway.
    
    Returns:
    
    the control point used in the operation currently underway.
  - getLocationControlPointAttributes
```
public MarkerAttributes getLocationControlPointAttributes()
```
    Indicates the attributes associated with location control points.
    
    Returns:
    
    the attributes associated with location control points.
  - getOriginalAttributes
```
public ShapeAttributes getOriginalAttributes()
```
    Indicates the attributes associated with the shape when the editor was created.
    
    Returns:
    
    the attributes associated with the shape when the editor was created.
  - getOriginalHighlightAttributes
```
public ShapeAttributes getOriginalHighlightAttributes()
```
    Indicates the highlight attributes associated with the shape prior to their being changed to achieve shape transparency.
    
    Returns:
    
    the original highlight attributes.
  - getPreviousPosition
```
public Position getPreviousPosition()
```
    Returns the geographic position associated with the previous select event.
    
    Returns:
    
    the geographic position associated with the previous select event.
  - getShadowLayer
```
public RenderableLayer getShadowLayer()
```
    Indicates the shadow layer used by this editor.
    
    Returns:
    
    the shadow layer used by this editor.
  - getShape
```
public Renderable getShape()
```
    Indicates the shape associated with this editor.
    
    Returns:
    
    the shape associated with this editor.
  - getShapeAltitudeMode
```
protected int getShapeAltitudeMode()
```
    Indicates the current shape's altitude mode if the shape has one.
    
    Returns:
    
    the shape's altitude mode if it has one, otherwise WorldWind.ABSOLUTE.
  - getShapeCenter
```
protected LatLon getShapeCenter()
```
    Returns the shape's center location, or null if it has no designated center.
    
    Returns:
    
    the shape's center location, or null if the shape has no designated center.
  - getSizeControlPointAttributes
```
public MarkerAttributes getSizeControlPointAttributes()
```
    Indicates the attributes associated with size control points.
    
    Returns:
    
    the attributes associated with size control points.
  - getUnitsFormat
```
public UnitsFormat getUnitsFormat()
```
    Indicates the units formatter associated with this editor.
    
    Returns:
    
    the units formatter associated with this editor.
  - getWwd
```
public WorldWindow getWwd()
```
    Indicates the WorldWindow associated with this editor.
    
    Returns:
    
    the WorldWindow associated with this editor.
  - isActive
```
public boolean isActive()
```
    Indicates whether an editing operation is currently underway. Operations are SIZING and MOVING.
    
    Returns:
    
    true if an operation is underway, otherwise false.
  - isArmed
```
public boolean isArmed()
```
    Indicates whether this editor is armed.
    
    Returns:
    
    true if the editor is armed, otherwise false.
  - isExtensionEnabled
```
public boolean isExtensionEnabled()
```
    Indicates whether multi-segment shapes such as Route and Track may be edited to add or remove segments.
    
    Returns:
    
    true if segment addition and deletion are enabled, otherwise false. The default is true.
  - isRadiiValid
```
protected static boolean isRadiiValid(double innerRadius,
                                      double outerRadius)
```
  - makeControlPoint
```
protected ShapeEditor.ControlPointMarker makeControlPoint(Position position,
                                                          MarkerAttributes attributes,
                                                          int id,
                                                          int leg,
                                                          java.lang.String purpose)
```
    Creates a control point.
    
    Parameters:
    
    position - the control point position.
    
    attributes - the control point attributes.
    
    id - the control point ID.
    
    leg - the control point leg.
    
    purpose - the control point purpose.
    
    Returns:
    
    the new control point.
  - makeControlPoint
```
protected ShapeEditor.ControlPointMarker makeControlPoint(Position position,
                                                          MarkerAttributes attributes,
                                                          int id,
                                                          java.lang.String purpose)
```
    Creates a control point.
    
    Parameters:
    
    position - the control point position.
    
    attributes - the control point attributes.
    
    id - the control point ID.
    
    purpose - the control point purpose.
    
    Returns:
    
    the new control point.
  - makeControlPointAttributes
```
protected void makeControlPointAttributes()
```
  - makeShadowShape
```
protected void makeShadowShape()
```
    Creates the shape that will remain at the same location and is the same size as the shape to be edited.
  - moveLocation
```
protected void moveLocation(ShapeEditor.ControlPointMarker controlPoint,
                            Position terrainPosition,
                            java.util.List<LatLon> locations)
```
    Moves a control point location.
    
    Parameters:
    
    controlPoint - the control point being moved.
    
    terrainPosition - the position selected by the user.
    
    locations - the list of locations for the shape.
  - nearestPointOnSegment
```
protected Vec4 nearestPointOnSegment(Vec4 p1,
                                     Vec4 p2,
                                     Vec4 point)
```
    Computes the point on a specified line segment that is nearest a specified point.
    
    Parameters:
    
    p1 - the line's first point.
    
    p2 - the line's second point.
    
    point - the point for which to determine a nearest point on the line segment.
    
    Returns:
    
    the nearest point on the line segment.
  - normalizedHeading
```
protected Angle normalizedHeading(Angle originalHeading,
                                  Angle deltaHeading)
```
    Add a specified increment to an angle and normalize the result to be between 0 and 360 degrees.
    
    Parameters:
    
    originalHeading - the base angle.
    
    deltaHeading - the increment to add prior to normalizing.
    
    Returns:
    
    the normalized angle.
  - propertyChange
```
public void propertyChange(java.beans.PropertyChangeEvent event)
```
    The property change listener, the method called when a property of the Scene Controller changes (vertical exaggeration, etc.). Does not necessarily indicate a property associated with this editor.
    
    Specified by:
    
    propertyChange in interface java.beans.PropertyChangeListener
    
    Parameters:
    
    event - the property change event indicating the property name and its associated value.
  - removeShadowShape
```
protected void removeShadowShape()
```
    Remove the shadow shape.
  - reshapeCappedCylinder
```
protected void reshapeCappedCylinder(Position terrainPosition,
                                     ShapeEditor.ControlPointMarker controlPoint)
```
    Performs an edit for CappedCylinder shapes.
    
    Parameters:
    
    controlPoint - the control point selected.
    
    terrainPosition - the terrain position under the cursor.
  - reshapeCappedEllipticalCylinder
```
protected void reshapeCappedEllipticalCylinder(Position terrainPosition,
                                               ShapeEditor.ControlPointMarker controlPoint)
```
    Performs an edit for CappedCylinder shapes.
    
    Parameters:
    
    controlPoint - the control point selected.
    
    terrainPosition - the terrain position under the cursor.
  - reshapeOrbit
```
protected void reshapeOrbit(Position terrainPosition,
                            ShapeEditor.ControlPointMarker controlPoint)
```
    Performs an edit for Orbit shapes.
    
    Parameters:
    
    controlPoint - the control point selected.
    
    terrainPosition - the terrain position under the cursor.
  - reshapePolygonAirspace
```
protected void reshapePolygonAirspace(Position terrainPosition,
                                      ShapeEditor.ControlPointMarker controlPoint)
```
    Performs an edit for Polygon shapes.
    
    Parameters:
    
    controlPoint - the control point selected.
    
    terrainPosition - the terrain position under the cursor.
  - reshapeRoute
```
protected void reshapeRoute(Position terrainPosition,
                            ShapeEditor.ControlPointMarker controlPoint)
```
    Performs an edit for Route shapes.
    
    Parameters:
    
    controlPoint - the control point selected.
    
    terrainPosition - the terrain position under the cursor.
  - reshapeShape
```
protected void reshapeShape(ShapeEditor.ControlPointMarker controlPoint)
```
    Modifies the shape's locations, size or rotation. This method is called when a control point is dragged.
    
    Parameters:
    
    controlPoint - the control point selected.
  - reshapeSphere
```
protected void reshapeSphere(Position terrainPosition,
                             ShapeEditor.ControlPointMarker controlPoint)
```
    Performs an edit for SphereAirspace shapes.
    
    Parameters:
    
    controlPoint - the control point selected.
    
    terrainPosition - the terrain position under the cursor.
  - reshapeSurfaceCircle
```
protected void reshapeSurfaceCircle(Position terrainPosition,
                                    ShapeEditor.ControlPointMarker controlPoint)
```
  - reshapeSurfaceEllipse
```
protected void reshapeSurfaceEllipse(Position terrainPosition,
                                     ShapeEditor.ControlPointMarker controlPoint)
```
  - reshapeSurfacePolygon
```
protected void reshapeSurfacePolygon(Position terrainPosition,
                                     ShapeEditor.ControlPointMarker controlPoint)
```
  - reshapeSurfaceQuad
```
protected void reshapeSurfaceQuad(Position terrainPosition,
                                  ShapeEditor.ControlPointMarker controlPoint)
```
  - reshapeSurfaceSquare
```
protected void reshapeSurfaceSquare(Position terrainPosition,
                                    ShapeEditor.ControlPointMarker controlPoint)
```
  - reshapeTrack
```
protected void reshapeTrack(Position terrainPosition,
                            ShapeEditor.ControlPointMarker controlPoint)
```
    Performs an edit for TrackAirspace shapes.
    
    Parameters:
    
    controlPoint - the control point selected.
    
    terrainPosition - the terrain position under the cursor.
  - rotateLocations
```
protected void rotateLocations(Position terrainPosition,
                               java.util.List<LatLon> locations)
```
    Rotates a shape's locations.
    
    Parameters:
    
    terrainPosition - the position selected by the user.
    
    locations - the list of locations for the shape.
  - selected
```
public void selected(SelectEvent event)
```
    The select handler, the method called when the user selects (rolls over, left clicks, etc.) the shape or a control point. Does not necessarily indicate the shape associated with this editor.
    
    Specified by:
    
    selected in interface SelectListener
    
    Parameters:
    
    event - the select event indicating what was selected and the geographic location under the cursor.
  - setArmed
```
public void setArmed(boolean armed)
```
    Arms or disarms the editor. When armed, the editor's shape is displayed with control points and other affordances that indicate possible editing operations.
    
    Parameters:
    
    armed - true to arm the editor, false to disarm it and remove the control points and other affordances. This method must be called when the editor is no longer needed so that the editor may remove the resources it created when it was armed.
  - setExtensionEnabled
```
public void setExtensionEnabled(boolean extensionEnabled)
```
    Specifies whether multi-segment shapes such as Route and Track may be edited to add or remove segments.
    
    Parameters:
    
    extensionEnabled - true to allow segment addition and removal, otherwise false.
  - setUnitsFormat
```
public void setUnitsFormat(UnitsFormat unitsFormat)
```
    Specifies the units formatter to use when creating editor annotations.
    
    Parameters:
    
    unitsFormat - the units formatter to use. A default is created if null is specified.
  - updateAnnotation
```
protected void updateAnnotation(ShapeEditor.ControlPointMarker controlPoint)
```
    Updates the annotation associated with a specified control point.
    
    Parameters:
    
    controlPoint - the control point.
  - updateCappedCylinderControlPoints
```
protected void updateCappedCylinderControlPoints()
```
    Updates the control points and affordances for CappedCylinder shapes.
  - updateCappedEllipticalCylinderControlPoints
```
protected void updateCappedEllipticalCylinderControlPoints()
```
    Updates the control points and affordances for CappedCylinder shapes.
  - updateControlPoints
```
protected void updateControlPoints()
```
    Updates the control points to the locations of the currently edited shape. Called each time a modification to the shape is made. Subclasses should override this method to handle shape types not supported by the basic editor.
  - updateOrbitControlPoints
```
protected void updateOrbitControlPoints()
```
    Updates the control points and affordances for Orbit shapes.
  - updateOrientationLine
```
protected void updateOrientationLine(Position centerPosition,
                                     Position controlPoint)
```
    Updates the line designating the shape's central axis.
    
    Parameters:
    
    centerPosition - the shape's center location and altitude at which to place one of the line's end points.
    
    controlPoint - the shape orientation control point.
  - updatePartialCappedCylinderControlPoints
```
protected void updatePartialCappedCylinderControlPoints()
```
    Updates the control points and affordances for PartialCappedCylinder shapes.
  - updatePolygonAirspaceControlPoints
```
protected void updatePolygonAirspaceControlPoints()
```
    Updates the control points and affordances for Polygon shapes.
  - updateRouteControlPoints
```
protected void updateRouteControlPoints()
```
    Updates the control points and affordances for Route shapes.
  - updateShapeAnnotation
```
protected void updateShapeAnnotation()
```
    Updates the annotation indicating the edited shape's center. If the shape has no designated center, this method prevents the annotation from displaying.
  - updateSphereControlPoints
```
protected void updateSphereControlPoints()
```
    Updates the control points and affordances for SphereAirspace shapes.
  - updateSurfaceCircleControlPoints
```
protected void updateSurfaceCircleControlPoints()
```
  - updateSurfaceEllipseControlPoints
```
protected void updateSurfaceEllipseControlPoints()
```
  - updateSurfacePolygonControlPoints
```
protected void updateSurfacePolygonControlPoints()
```
  - updateSurfaceQuadControlPoints
```
protected void updateSurfaceQuadControlPoints()
```
  - updateSurfaceSquareControlPoints
```
protected void updateSurfaceSquareControlPoints()
```
  - updateTrackControlPoints
```
protected void updateTrackControlPoints()
```
    Updates the control points and affordances for TrackAirspace shapes.

Class ShapeEditor

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

accessoryLayer

active

activeOperation

angleControlPointAttributes

annotation

ANNOTATION

annotationLayer

armed

controlPointLayer

currentEvent

currentHeading

currentSizingMarker

extensionEnabled

HEIGHT

INNER_MAJOR_RADIUS

INNER_MINOR_RADIUS

INNER_RADIUS

LEFT_AZIMUTH

LEFT_WIDTH

LOCATION

locationControlPointAttributes

MOVING

NONE

originalAttributes

originalHighlightAttributes

OUTER_MAJOR_RADIUS

OUTER_MINOR_RADIUS

OUTER_RADIUS

previousPosition

RIGHT_AZIMUTH

RIGHT_WIDTH

ROTATION

shadowLayer

shape

sizeControlPointAttributes

SIZING

trackAdjacencyList

unitsFormat

WIDTH

wwd

Constructor Detail

ShapeEditor

Method Detail

addNearestLocation

adjustShape

adjustTrackShape

appendLocation

computeControlPointDelta

computeEdgeLocation

computeRectangularEdgeLocation

determineTrackAdjacency

disable

doGetControlPointAltitude

doMakeShadowShape

doReshapeShape

dragWholeShape

enable

getAccessoryLayer

getActiveOperation

getAngleControlPointAttributes

getAnnotation

getAnnotationLayer

getControlPointAltitude

getControlPointLayer

getCurrentEvent

getCurrentHeading

getCurrentSizingMarker

getLocationControlPointAttributes

getOriginalAttributes

getOriginalHighlightAttributes

getPreviousPosition

getShadowLayer

getShape