Package gov.nasa.worldwind.symbology.milstd2525.graphics.lines

Class HoldingLine

  • All Implemented Interfaces:
    AVList, Draggable, Movable, Highlightable, Renderable, MilStd2525TacticalGraphic, TacticalGraphic
    public class HoldingLine
extends AbstractMilStd2525TacticalGraphic
    This class implements the following graphics:
    • Holding Line (2.X.2.6.1.2)
    • Bridgehead (2.X.2.6.1.4)

    Note: These graphics require three control points. The first two points define the end points of the graphic, and the third point defines the top of an arc that connects the endpoints. The specification for Holding Line and Bridgehead (MIL-STD-2525C pgs 538 and 540) states that "Additional points can be defined to extend the line". However, the specification is unclear as to how additional control points should be interpreted. This implementation ignores additional control points.

    • Field Detail

      • DEFAULT_NUM_INTERVALS

        public static final int DEFAULT_NUM_INTERVALS
        Default number of intervals used to draw the arc.
        See Also:
        Constant Field Values

      • DEFAULT_CURVATURE

        public static final double DEFAULT_CURVATURE
        Scale factor that determines the curvature of the corners of the arc.
        See Also:
        Constant Field Values

      • path

        protected Path path
        Path used to render the line.

      • curvature

        protected double curvature
        Scale factor that determines the curvature of the corners of the arc. Valid values are zero to one, where zero produced square corners.

      • intervals

        protected int intervals
        Number of intervals used to draw the arc.

      • position1

        protected Position position1
        First control point, defines the start of the line.

      • position2

        protected Position position2
        Second control point, defines the end of the line.

      • position3

        protected Position position3
        Third control point, defines the top of the arc.

    • Constructor Detail

      • HoldingLine

        public HoldingLine​(java.lang.String sidc)
        Create a new Holding Line graphic.
        Parameters:
        sidc - Symbol code the identifies the graphic.

    • Method Detail

      • getSupportedGraphics

        public static java.util.List<java.lang.String> getSupportedGraphics()
        Indicates the graphics supported by this class.
        Returns:
        List of masked SIDC strings that identify graphics that this class supports.

      • setPositions

        public void setPositions​(java.lang.Iterable<? extends Position> positions)
        Specifies the positions of the control points that place and orient the graphic.
        Parameters:
        positions - Control points that orient the graphic. Must provide at least three points.

      • getPositions

        public java.lang.Iterable<? extends Position> getPositions()
        Indicates the positions of the control points that place and orient the graphic.
        Returns:
        positions that orient the graphic. How many positions are returned depends on the type of graphic. Some graphics require only a single position, others require many.

      • getReferencePosition

        public Position getReferencePosition()
        A position associated with the object that indicates its aggregate geographic position. The chosen position varies among implementers of this interface. For objects defined by a list of positions, the reference position is typically the first position in the list. For symmetric objects the reference position is often the center of the object. In many cases the object's reference position may be explicitly specified by the application.
        Returns:
        the object's reference position, or null if no reference position is available.

      • getCurvature

        public double getCurvature()
        Indicates a factor that controls the curvatures of the arcs in this graphic.
        Returns:
        Factor that determines arc curvature.
        See Also:
        setCurvature(double)

      • setCurvature

        public void setCurvature​(double curvature)
        Specifies a factor that determines the curvature of the arcs in this graphic. Valid values are zero to one, where zero creates square corners and one creates extremely rounded corners.
        Parameters:
        curvature - Factor that determines curvature of the arc.

      • getIntervals

        public int getIntervals()
        Indicates the number of intervals used to draw the arc in this graphic.
        Returns:
        Intervals used to draw arc.

      • setIntervals

        public void setIntervals​(int intervals)
        Specifies the number of intervals used to draw the arc in this graphic. More intervals will result in a smoother looking arc.
        Parameters:
        intervals - Number of intervals for drawing the arc.

      • onShapeChanged

        protected void onShapeChanged()

      • applyDelegateOwner

        protected void applyDelegateOwner​(java.lang.Object owner)
        Invoked each frame to apply to the current delegate owner to all renderable objects used to draw the graphic. This base class will apply the delegate owner to Label objects. Subclasses must implement this method to apply the delegate owner to any Renderables that they will draw in order to render the graphic.
        Specified by:
        applyDelegateOwner in class AbstractTacticalGraphic
        Parameters:
        owner - Current delegate owner.

      • createShape

        protected void createShape​(DrawContext dc)
        Create a Path to render the line.
        Parameters:
        dc - Current draw context.

      • computeRoundCorner

        protected void computeRoundCorner​(Globe globe,
                                  java.util.List<Position> positions,
                                  Vec4 ptLeg1,
                                  Vec4 ptVertex,
                                  Vec4 ptLeg2,
                                  double distance,
                                  int intervals)
        Compute positions to draw a rounded corner between three points.
        Parameters:
        globe - Current globe.
        positions - Positions will be added to this list.
        ptLeg1 - Point at the end of the one leg.
        ptVertex - Point at the vertex of the corner.
        ptLeg2 - Point at the end of the other let.
        distance - Distance from the vertex at which the arc should begin and end.
        intervals - Number of intervals to use to generate the arc.

      • computeArc

        protected void computeArc​(Globe globe,
                          java.util.List<Position> positions,
                          Position center,
                          Angle startAzimuth,
                          Angle endAzimuth,
                          double radius,
                          int intervals)
        Compute the positions required to draw an arc.
        Parameters:
        globe - Current globe.
        positions - Add arc positions to this list.
        center - Center point of the arc.
        startAzimuth - Starting azimuth.
        endAzimuth - Ending azimuth.
        radius - Radius of the arc, in meters.
        intervals - Number of intervals to generate.

      • getGraphicLabel

        protected java.lang.String getGraphicLabel()

      • createPath

        protected Path createPath()
        Create and configure the Path used to render this graphic.
        Returns:
        New path configured with defaults appropriate for this type of graphic.