All Downloads are FREE. Search and download functionalities are using the official Maven repository.

src.gov.nasa.worldwind.render.SurfaceEllipse Maven / Gradle / Ivy

/*
 * Copyright (C) 2012 United States Government as represented by the Administrator of the
 * National Aeronautics and Space Administration.
 * All Rights Reserved.
 */
package gov.nasa.worldwind.render;

import gov.nasa.worldwind.geom.*;
import gov.nasa.worldwind.globes.Globe;
import gov.nasa.worldwind.util.*;

import java.util.*;

/**
 * @author dcollins
 * @version $Id: SurfaceEllipse.java 1634 2013-09-27 18:40:01Z dcollins $
 */
public class SurfaceEllipse extends AbstractSurfaceShape
{
    protected static final int MIN_NUM_INTERVALS = 8;
    protected static final int DEFAULT_NUM_INTERVALS = 32;

    protected LatLon center = LatLon.ZERO;
    protected double majorRadius;
    protected double minorRadius;
    protected Angle heading = Angle.ZERO;
    private int intervals = DEFAULT_NUM_INTERVALS;

    /**
     * Constructs a new surface ellipse with the default attributes, default center location, default radii, and default
     * heading.
     */
    public SurfaceEllipse()
    {
    }

    /**
     * Constructs a new surface ellipse with the specified normal (as opposed to highlight) attributes, default center
     * location, default radii, and default heading. Modifying the attribute reference after calling this constructor
     * causes this shape's appearance to change accordingly.
     *
     * @param normalAttrs the normal attributes. May be null, in which case default attributes are used.
     */
    public SurfaceEllipse(ShapeAttributes normalAttrs)
    {
        super(normalAttrs);
    }

    /**
     * Constructs a new surface ellipse with the default attributes, the specified center location and radii (in
     * meters).
     *
     * @param center      the ellipse's center location.
     * @param majorRadius the ellipse's major radius, in meters.
     * @param minorRadius the ellipse's minor radius, in meters.
     *
     * @throws IllegalArgumentException if the center is null, or if either radii is negative.
     */
    public SurfaceEllipse(LatLon center, double majorRadius, double minorRadius)
    {
        if (center == null)
        {
            String message = Logging.getMessage("nullValue.CenterIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        if (majorRadius < 0)
        {
            String message = Logging.getMessage("Geom.RadiusIsNegative", majorRadius);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        if (minorRadius < 0)
        {
            String message = Logging.getMessage("Geom.RadiusIsNegative", majorRadius);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.center = center;
        this.majorRadius = majorRadius;
        this.minorRadius = minorRadius;
    }

    /**
     * Constructs a new surface ellipse with the default attributes, the specified center location, radii (in meters),
     * and heading clockwise from North.
     *
     * @param center      the ellipse's center location.
     * @param majorRadius the ellipse's major radius, in meters.
     * @param minorRadius the ellipse's minor radius, in meters.
     * @param heading     the ellipse's heading, clockwise from North.
     *
     * @throws IllegalArgumentException if the center or heading are null, or if either radii is negative.
     */
    public SurfaceEllipse(LatLon center, double majorRadius, double minorRadius, Angle heading)
    {
        this(center, majorRadius, minorRadius);

        if (heading == null)
        {
            String message = Logging.getMessage("nullValue.HeadingIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.heading = heading;
    }

    /**
     * Constructs a new surface ellipse with the default attributes, the specified center location, radii (in meters),
     * heading clockwise from North, and initial number of geometry intervals.
     *
     * @param center      the ellipse's center location.
     * @param majorRadius the ellipse's major radius, in meters.
     * @param minorRadius the ellipse's minor radius, in meters.
     * @param heading     the ellipse's heading, clockwise from North.
     * @param intervals   the initial number of intervals (or slices) defining the ellipse's geometry.
     *
     * @throws IllegalArgumentException if the center or heading are null, if either radii is negative, or if the number
     *                                  of intervals is less than 8.
     */
    public SurfaceEllipse(LatLon center, double majorRadius, double minorRadius, Angle heading, int intervals)
    {
        this(center, majorRadius, minorRadius, heading);

        if (intervals < MIN_NUM_INTERVALS)
        {
            String message = Logging.getMessage("generic.ArgumentOutOfRange", intervals);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.intervals = intervals;
    }

    /**
     * Constructs a new surface ellipse with the specified normal (as opposed to highlight) attributes, the specified
     * center location, and radii (in meters). Modifying the attribute reference after calling this constructor causes
     * this shape's appearance to change accordingly.
     *
     * @param normalAttrs the normal attributes. May be null, in which case default attributes are used.
     * @param center      the ellipse's center location.
     * @param majorRadius the ellipse's major radius, in meters.
     * @param minorRadius the ellipse's minor radius, in meters.
     *
     * @throws IllegalArgumentException if the center is null, or if either radii is negative.
     */
    public SurfaceEllipse(ShapeAttributes normalAttrs, LatLon center, double majorRadius, double minorRadius)
    {
        super(normalAttrs);

        if (center == null)
        {
            String message = Logging.getMessage("nullValue.CenterIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        if (majorRadius < 0)
        {
            String message = Logging.getMessage("Geom.RadiusIsNegative", majorRadius);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        if (minorRadius < 0)
        {
            String message = Logging.getMessage("Geom.RadiusIsNegative", majorRadius);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.center = center;
        this.majorRadius = majorRadius;
        this.minorRadius = minorRadius;
    }

    /**
     * Constructs a new surface ellipse with the specified normal (as opposed to highlight) attributes, the specified
     * center location, radii (in meters), and heading clockwise from North. Modifying the attribute reference after
     * calling this constructor causes this shape's appearance to change accordingly.
     *
     * @param normalAttrs the normal attributes. May be null, in which case default attributes are used.
     * @param center      the ellipse's center location.
     * @param majorRadius the ellipse's major radius, in meters.
     * @param minorRadius the ellipse's minor radius, in meters.
     * @param heading     the ellipse's heading, clockwise from North.
     *
     * @throws IllegalArgumentException if the center or heading are null, or if either radii is negative.
     */
    public SurfaceEllipse(ShapeAttributes normalAttrs, LatLon center, double majorRadius, double minorRadius,
        Angle heading)
    {
        this(normalAttrs, center, majorRadius, minorRadius);

        if (heading == null)
        {
            String message = Logging.getMessage("nullValue.HeadingIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.heading = heading;
    }

    /**
     * Constructs a new surface ellipse with the specified normal (as opposed to highlight) attributes, the specified
     * center location, radii (in meters), heading clockwise from North, and initial number of geometry intervals.
     * Modifying the attribute reference after calling this constructor causes this shape's appearance to change
     * accordingly.
     *
     * @param normalAttrs the normal attributes. May be null, in which case default attributes are used.
     * @param center      the ellipse's center location.
     * @param majorRadius the ellipse's major radius, in meters.
     * @param minorRadius the ellipse's minor radius, in meters.
     * @param heading     the ellipse's heading, clockwise from North.
     * @param intervals   the initial number of intervals (or slices) defining the ellipse's geometry.
     *
     * @throws IllegalArgumentException if the center or heading are null, if either radii is negative, or if the number
     *                                  of intervals is less than 8.
     */
    public SurfaceEllipse(ShapeAttributes normalAttrs, LatLon center, double majorRadius, double minorRadius,
        Angle heading, int intervals)
    {
        this(normalAttrs, center, majorRadius, minorRadius, heading);

        if (intervals < MIN_NUM_INTERVALS)
        {
            String message = Logging.getMessage("generic.ArgumentOutOfRange", intervals);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.intervals = intervals;
    }

    public LatLon getCenter()
    {
        return this.center;
    }

    public void setCenter(LatLon center)
    {
        if (center == null)
        {
            String message = Logging.getMessage("nullValue.CenterIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.center = center;
        this.onShapeChanged();
    }

    public double getMajorRadius()
    {
        return this.majorRadius;
    }

    public double getMinorRadius()
    {
        return this.minorRadius;
    }

    public void setMajorRadius(double radius)
    {
        if (radius < 0)
        {
            String message = Logging.getMessage("Geom.RadiusIsNegative", radius);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.majorRadius = radius;
        this.onShapeChanged();
    }

    public void setMinorRadius(double radius)
    {
        if (radius < 0)
        {
            String message = Logging.getMessage("Geom.RadiusIsNegative", radius);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.minorRadius = radius;
        this.onShapeChanged();
    }

    public void setRadii(double majorRadius, double minorRadius)
    {
        this.setMajorRadius(majorRadius);
        this.setMinorRadius(minorRadius);
    }

    public Angle getHeading()
    {
        return this.heading;
    }

    public void setHeading(Angle heading)
    {
        if (heading == null)
        {
            String message = Logging.getMessage("nullValue.HeadingIsNull");
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.heading = heading;
        this.onShapeChanged();
    }

    public int getIntervals()
    {
        return this.intervals;
    }

    public void setIntervals(int intervals)
    {
        if (intervals < MIN_NUM_INTERVALS)
        {
            String message = Logging.getMessage("generic.ArgumentOutOfRange", intervals);
            Logging.logger().severe(message);
            throw new IllegalArgumentException(message);
        }

        this.intervals = intervals;
        this.onShapeChanged();
    }

    /**
     * {@inheritDoc}
     * 

* Overridden to include the globe's state key in the returned state key. * * @see gov.nasa.worldwind.globes.Globe#getStateKey(DrawContext) */ @Override public Object getStateKey(DrawContext dc) { // Store a copy of the active attributes to insulate the key from changes made to the shape's active attributes. return new SurfaceShapeStateKey(this.getUniqueId(), this.lastModifiedTime, this.getActiveAttributes().copy(), dc.getGlobe().getStateKey(dc)); } public Iterable getLocations(Globe globe) { if (globe == null) { String message = Logging.getMessage("nullValue.GlobeIsNull"); Logging.logger().severe(message); throw new IllegalArgumentException(message); } return this.computeLocations(globe, this.intervals); } public Position getReferencePosition() { return new Position(this.center, 0); } protected void doMoveTo(Position oldReferencePosition, Position newReferencePosition) { Angle heading = LatLon.greatCircleAzimuth(oldReferencePosition, this.center); Angle pathLength = LatLon.greatCircleDistance(oldReferencePosition, this.center); this.setCenter(LatLon.greatCircleEndPosition(newReferencePosition, heading, pathLength)); } protected List computeLocations(Globe globe, int intervals) { if (globe == null) { String message = Logging.getMessage("nullValue.GlobeIsNull"); Logging.logger().severe(message); throw new IllegalArgumentException(message); } if (this.majorRadius == 0 && this.minorRadius == 0) return null; int numLocations = 1 + Math.max(MIN_NUM_INTERVALS, intervals); double da = (2 * Math.PI) / (numLocations - 1); double globeRadius = globe.getRadiusAt(this.center.getLatitude(), this.center.getLongitude()); LatLon[] locations = new LatLon[numLocations]; for (int i = 0; i < numLocations; i++) { double angle = (i != numLocations - 1) ? i * da : 0; double xLength = this.majorRadius * Math.cos(angle); double yLength = this.minorRadius * Math.sin(angle); double distance = Math.sqrt(xLength * xLength + yLength * yLength); // azimuth runs positive clockwise from north and through 360 degrees. double azimuth = (Math.PI / 2.0) - (Math.acos(xLength / distance) * Math.signum(yLength) - this.heading.radians); locations[i] = LatLon.greatCircleEndPosition(this.center, azimuth, distance / globeRadius); } return Arrays.asList(locations); } protected List> createGeometry(Globe globe, SurfaceTileDrawContext sdc) { if (globe == null) { String message = Logging.getMessage("nullValue.GlobeIsNull"); Logging.logger().severe(message); throw new IllegalArgumentException(message); } double edgeIntervalsPerDegree = this.computeEdgeIntervalsPerDegree(sdc); int intervals = this.computeNumIntervals(globe, edgeIntervalsPerDegree); List drawLocations = this.computeLocations(globe, intervals); if (drawLocations == null) return null; ArrayList> geom = new ArrayList>(); geom.add(drawLocations); return geom; } protected int computeNumIntervals(Globe globe, double edgeIntervalsPerDegree) { if (globe == null) { String message = Logging.getMessage("nullValue.GlobeIsNull"); Logging.logger().severe(message); throw new IllegalArgumentException(message); } int numEdgeIntervals = this.computeNumEdgeIntervals(globe, edgeIntervalsPerDegree); return numEdgeIntervals * this.intervals; } protected int computeNumEdgeIntervals(Globe globe, double edgeIntervalsPerDegree) { if (globe == null) { String message = Logging.getMessage("nullValue.GlobeIsNull"); Logging.logger().severe(message); throw new IllegalArgumentException(message); } int numPositions = 1 + Math.max(MIN_NUM_INTERVALS, intervals); double radius = Math.max(this.majorRadius, this.minorRadius); double da = (2 * Math.PI) / (numPositions - 1); Angle edgePathLength = Angle.fromRadians(da * radius / globe.getRadiusAt(this.center)); double edgeIntervals = WWMath.clamp(edgeIntervalsPerDegree * edgePathLength.degrees, this.minEdgeIntervals, this.maxEdgeIntervals); return (int) Math.ceil(edgeIntervals); } //**************************************************************// //******************** Restorable State ***********************// //**************************************************************// protected void doGetRestorableState(RestorableSupport rs, RestorableSupport.StateObject context) { super.doGetRestorableState(rs, context); rs.addStateValueAsLatLon(context, "center", this.getCenter()); rs.addStateValueAsDouble(context, "majorRadius", this.getMajorRadius()); rs.addStateValueAsDouble(context, "minorRadius", this.getMinorRadius()); rs.addStateValueAsDouble(context, "headingDegrees", this.getHeading().degrees); rs.addStateValueAsInteger(context, "intervals", this.getIntervals()); } protected void doRestoreState(RestorableSupport rs, RestorableSupport.StateObject context) { super.doRestoreState(rs, context); LatLon ll = rs.getStateValueAsLatLon(context, "center"); if (ll != null) this.setCenter(ll); Double d = rs.getStateValueAsDouble(context, "majorRadius"); if (d != null) this.setMajorRadius(d); d = rs.getStateValueAsDouble(context, "minorRadius"); if (d != null) this.setMinorRadius(d); d = rs.getStateValueAsDouble(context, "headingDegrees"); if (d != null) this.setHeading(Angle.fromDegrees(d)); Integer i = rs.getStateValueAsInteger(context, "intervals"); if (d != null) this.setIntervals(i); } protected void legacyRestoreState(RestorableSupport rs, RestorableSupport.StateObject context) { super.legacyRestoreState(rs, context); // These properties has not changed since the last version, but they're shown here for reference. //Double major = rs.getStateValueAsDouble(context, "majorRadius"); //Double minor = rs.getStateValueAsDouble(context, "minorRadius"); //if (major != null && minor != null) // this.setAxisLengths(major, minor); // This property has not changed since the last version, but it's shown here for reference. //LatLon center = rs.getStateValueAsLatLon(context, "center"); //if (center != null) // this.setCenter(center); // This property has not changed since the last version, but it's shown here for reference. //Integer intervals = rs.getStateValueAsInteger(context, "intervals"); //if (intervals != null) // this.setIntervals(intervals); Double od = rs.getStateValueAsDouble(context, "orientationDegrees"); if (od != null) this.setHeading(Angle.fromDegrees(od)); } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy