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

Go to download

Show more of this group Show more artifacts with this name
Show all versions of worldwindx Show documentation

World Wind is a collection of components that interactively display 3D geographic information within Java applications or applets.

There is a newer version: 2.0.0-986

Show newest version

/*
 * 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.Position;

/**
 * A {@link Balloon} attached to a position on the globe.
 *
 * @author pabercrombie
 * @version $Id: GlobeBalloon.java 1171 2013-02-11 21:45:02Z dcollins $
 */
public interface GlobeBalloon extends Balloon
{
    /**
     * Get the position of the balloon.
     *
     * @return The position of the balloon.
     */
    Position getPosition();

    /**
     * Set the balloon to a position on the globe.
     *
     * @param position New position for the balloon.
     */
    void setPosition(Position position);

    /**
     * Returns the balloon's altitude mode. See {@link #setAltitudeMode(int)} for a description of the modes.
     *
     * @return the balloon's altitude mode.
     */
    public int getAltitudeMode();

    /**
     * Specifies the balloon's altitude mode. Recognized modes are:  @link WorldWind#CLAMP_TO_GROUND} --
     * the balloon is placed on the terrain at the latitude and longitude of its position.
 @link
     * WorldWind#RELATIVE_TO_GROUND} -- the balloon is placed above the terrain at the latitude and longitude of its
     * position and the distance specified by its elevation.
 {@link gov.nasa.worldwind.WorldWind#ABSOLUTE}
     * -- the balloon is placed at its specified position. 
     *
     * @param altitudeMode the altitude mode
     */
    public void setAltitudeMode(int altitudeMode);
}