Application: gvSIG desktop » gvSIG 3D

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright ? 2007-2015 gvSIG Association

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.view3d.swing.api;

import gov.nasa.worldwind.awt.WorldWindowGLJPanel;

import gov.nasa.worldwind.layers.Layer;

import org.gvsig.fmap.mapcontext.MapContext;

import org.gvsig.fmap.mapcontext.ViewPort;

import org.gvsig.fmap.mapcontext.layers.FLayer;

import org.gvsig.tools.dispose.Disposable;

import org.gvsig.tools.observer.Observable;

import org.gvsig.tools.swing.api.Component;

import org.gvsig.tools.task.Cancellable;

import org.gvsig.view3d.swing.api.View3DSwingManager.TYPE;

/**

 * A component that includes a {@link MapContext} and a

 * {@link WorldWindowGLJPanel}.

 * 

 * <code>MapContext</code> is used to:

 * <ul>

 * <li>Get layers to convert them to {@link Layer}. When <code>MapContext</code>

 * layers are converted, they are added to WorldWindowGLJPanel to display it.</li>

 * <li>Get {@link ViewPort} to synchronize view ports.</li>

 * </ul>

 * 

 * <code>WorldWindowGLJPanel</code> is used to display WW Models (globe and

 * layers). It's a self-contained component intended to serve as an

 * application's WorldWindow.

 * 

 * This component offers methods to:

 * <ul>

 * <li>Get shared object to cancel draw request. See

 * {@link MapControl3D#getCancellable()}</li>

 * <li>Get and set associated <code>MapContext</code>. See

 * {@link MapControl3D#getMapContext()}</li>

 * <li>Get and set vertical exaggeration of WW Model. See

 * {@link MapControl3D#getVerticalExaggeration()} and

 * {@link MapControl3D#setVerticalExaggeration(double)}</li>

 * <li>Show and hide atmosphere layer. See {@link MapControl3D#showAtmosphere()}

 * and {@link MapControl3D#hideAtmosphere()}</li>

 * <li>Show and hide Minimap component layer. See

 * {@link MapControl3D#showMiniMap()} and {@link MapControl3D#hideMiniMap()}</li>

 * <li>Show and hide North indicator component layer. See

 * {@link MapControl3D#showNortIndicator()} and

 * {@link MapControl3D#hideNorthIndicator()}</li>

 * <li>Show and hide scale component layer. See {@link MapControl3D#showScale()}

 * and {@link MapControl3D#hideScale()}</li>

 * <li>Show and hide start background layer layer. See

 * {@link MapControl3D#showStarBackgroundLayer()} and

 * {@link MapControl3D#hideStarBackground()}</li>

 * <li>Synchronize view ports. See {@link MapControl3D#synchronizeViewPorts()}</li>

 * <li>Reload layers. There are two methos to reload layers. The first methos is

 * {@link MapControl3D#synchronizeLayers()} that only reload layers with chages.

 * The second methos is {@link MapControl3D#reloadLayers()} that reload all

 * layers of <code>MapContext</code></li>

 * </ul>

 * 

 * @author <a href="mailto:lmarques@disid.com">Lluis Marques</a>

 *

 */

@SuppressWarnings("deprecation")

public interface MapControl3D extends Component, Disposable, Observable {

    /**

     * Notification that notifies just before that this

     * <code>MapControl3D</code>is diposed.

     */

    static final String BEFORE_DISPOSE_MAPCONTEX3D_NOTIFICATION =

        "MapControl3D.beforeDisposePanel";

    /**

     * Notification that notifies just after that this <code>MapControl3D</code>

     * is

     * diposed.

     */

    static final String AFTER_DISPOSE_MAPCONTEX3D_NOTIFICATION =

        "MapControl3D.afterDisposePanel";

    /**

     * Gets shared object to cancel draw of loaded layers. To cancel draw use

     * set

     * canceled <code>true</code> with {@link Cancellable#setCanceled(boolean)}

     * 

     * Note: {@link Cancellable} is deprecated but we have to use it because

     * {@link FLayer#draw(java.awt.image.BufferedImage, java.awt.Graphics2D, org.gvsig.fmap.mapcontext.ViewPort, Cancellable, double)}

     * use it.

     * 

     * @see Cancellable

     */

    public Cancellable getCancellable();

    /**

     * Gets the <code>MapContext</code> associated.

     * 

     * @see MapContext

     */

    public MapContext getMapContext();

    /**

     * Gets {@link TYPE} of this <code>MapControl3D</code>.

     * 

     */

    public TYPE getType();

    /**

     * Gets vertical exaggeration model of this <code>MapControl3D</code>.

     * 

     * @see MapControl3D#setVerticalExaggeration(double)

     */

    public double getVerticalExaggeration();

    /**

     * Hides Atmosphere component.

     * 

     * @see MapControl3D#showAtmosphere()

     */

    public void hideAtmosphere();

    /**

     * Hides MiniMap component.

     * 

     * @see MapControl3D#showMiniMap()

     */

    public void hideMiniMap();

    /**

     * Hides North Indicator component.

     * 

     * @see MapControl3D#showNortIndicator()

     */

    public void hideNorthIndicator();

    /**

     * Hides Scale component.

     * 

     * @see MapControl3D#showScale()

     */

    public void hideScale();

    /**

     * Hides Star background layer.

     * 

     * @see MapControl3D#showStarBackgroundLayer()

     */

    public void hideStarBackground();

    /**

     * Forces reload all layers of <code>MapContext</code> associted.

     * 

     * @see {@link MapControl3D#synchronizeLayers()}

     */

    public void reloadLayers();

    /**

     * Sets MapContext and loads new MapContext layers.

     * 

     * @see MapControl3D#getMapContext()

     */

    public void setMapContext(MapContext theMapContext);

    /**

     * Sets vertical exaggeration.

     * 

     * @see MapControl3D#getVerticalExaggeration()

     */

    public void setVerticalExaggeration(double verticalExaggeration);

    /**

     * Shows Atmosphere layer.

     * 

     * @see MapControl3D#hideAtmosphere()

     */

    public void showAtmosphere();

    /**

     * Shows Minimap component.

     * 

     * @see MapControl3D#hideMiniMap()

     */

    public void showMiniMap();

    /**

     * Shows North indicartor component.

     * 

     * @see MapControl3D#hideNorthIndicator()

     */

    public void showNortIndicator();

    /**

     * Shows Scale component.

     * 

     * @see MapControl3D#hideScale()

     */

    public void showScale();

    /**

     * Shows Star background layer.

     * 

     * @see MapControl3D#hideStarBackground()

     */

    public void showStarBackgroundLayer();

    /**

     * Synchronize view of <code>MapControl3D</code> with view port of

     * <code>MapContext</code> associated.

     */

    public void synchronizeViewPorts();

    /**

     * Synchronize with <code>MapContext</code> associted only layers with

     * changes. To force synchronize all layers use

     * {@link MapControl3D#reloadLayers()}.

     * 

     */

    public void synchronizeLayers();

}