Application: gvSIG desktop » gvSIG 3D

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

	<modelVersion>4.0.0</modelVersion>

	<parent>

		<groupId>org.gvsig</groupId>

		<artifactId>org.gvsig.view3d.swing</artifactId>

		<version>1.0.9</version>

	</parent>

	<artifactId>org.gvsig.view3d.swing.api</artifactId>

	<name>org.gvsig.view3d.swing.api</name>

	<dependencies>

		<dependency>

			<groupId>org.gvsig</groupId>

			<artifactId>org.gvsig.tools.lib</artifactId>

		</dependency>

		<dependency>

			<groupId>org.gvsig</groupId>

			<artifactId>org.gvsig.fmap.mapcontext.api</artifactId>

		</dependency>

		<dependency>

			<groupId>gov.nasa</groupId>

			<artifactId>worldwind</artifactId>

		</dependency>

		<dependency>

			<groupId>gov.nasa</groupId>

			<artifactId>worldwindx</artifactId>

			<version>2.0.0</version>

		</dependency>

		<dependency>

			<groupId>org.jogamp.gluegen</groupId>

			<artifactId>gluegen-rt</artifactId>

		</dependency>

		<dependency>

			<groupId>org.jogamp.jogl</groupId>

			<artifactId>jogl-all</artifactId>

		</dependency>

		<dependency>

			<groupId>org.gvsig</groupId>

			<artifactId>org.gvsig.tools.swing.api</artifactId>

		</dependency>

		<dependency>

		  <groupId>org.gvsig</groupId>

		  <artifactId>org.gvsig.view3d.lib.api</artifactId>

		</dependency>

	</dependencies>

</project>

org.gvsig.view3d.swing.api.View3DSwingLibrary

/**

 * 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 org.gvsig.tools.swing.api.Component;

/**

 * Component to show a {@link MapControl3D} component and register window

 * listeners if it is necessary.

 * 

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

 *

 */

public interface View3DPanel extends Component {

    /**

     * Sets full screen mode.

     * 

     */

    public void fullScreen();

    /**

     * Gets <code>MapControl3D</code> of this <code>ViewPanel</code>

     */

    public MapControl3D getMapControl3D();

    /**

     * Shows panel like a window. 

     */

    public void show();

}

/**

 * 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 java.util.List;

import org.gvsig.fmap.mapcontext.MapContext;

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

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

import org.gvsig.view3d.swing.api.properties.GeneralProperties3D;

import org.gvsig.view3d.swing.api.properties.GeneralProperties3DPanel;

import org.gvsig.view3d.swing.api.properties.LayerProperties3DPanel;

import org.gvsig.view3d.swing.api.properties.MapControlProperties3D;

import org.gvsig.view3d.swing.api.properties.ViewProperties3DPanel;

/**

 * This class is responsible of the management of the library's swing user

 * interface. It is the swing library's main entry point, and provides all the

 * services to manage library swing components.

 * 

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

 *

 */

public interface View3DSwingManager {

    public enum TYPE {

        SPHERE, FLAT

    }

    /**

     * Creates the general 3D properties panel. General 3D properties is used to

     * show and change General 3D properties in a graphical way. See

     * {@link GeneralProperties3D}.

     * 

     * @param properties

     *            Model of general 3D properties panel.

     * @return general 3D properties panel.

     */

    public GeneralProperties3DPanel createGeneralProperties3DPanel(

        GeneralProperties3D properties);

    /**

     * Creates the layer 3D properties panel. Layer 3D properties panel is used

     * to show and change layer 3D properties in a graphical way. See

     * {@link LayerProperties3D}.

     * 

     * @param layer

     *            Layer to get model of layer 3D properties panel.

     * @return layer 3D properties panel.

     */

    public LayerProperties3DPanel createLayerProperties3DPanel(FLayer layer);

    /**

     * Registers and creatres a <code>MapControl3D</code> as from

     * {@link MapContext} {@link TYPE}. When an {@link MapControl3D} is created,

     * it automatically adds all available and visible layers of

     * <code>MapControl</code>.

     * 

     * @param theMapContext

     *            associated <code>MapContext</code> of

     *            <code>MapControl3D</code>

     * @param type

     *            Type of <code>MapControl3D</code>. See {@link TYPE}.

     * @param viewProperties

     *            View properties to register this <code>MapControl3D</code>

     * @see View3DSwingManager#createView3DPanel(MapControl3D, String)

     * @see View3DSwingManager#createViewProperties3DPanel(MapControlProperties3D)

     * @return an instance of <code>MapControl3D</code> ready to be shown.

     */

    public MapControl3D createMapControl3D(MapContext theMapContext, TYPE type,

        ExtendedPropertiesSupport viewProperties);

    /**

     * Creates a <code>View3DPanel</code> with a {@link MapControl3D}.

     * 

     * @param theMapContext

     *            associated <code>MapContext</code> of

     *            <code>MapControl3D</code>

     * @param title

     *            Title of window

     * @param type

     *            Type of <code>MapControl3D</code>. See {@link TYPE}.

     * @param viewProperties

     *            View properties to register this <code>MapControl3D</code>

     * @see View3DSwingManager#createMapControl3D(MapContext, TYPE)

     * @see View3DSwingManager#createView3DPanel(MapControl3D, String)

     * @return

     */

    public View3DPanel createView3DPanel(MapContext theMapContext,

        String title, TYPE type, ExtendedPropertiesSupport viewProperties);

    /**

     * Creates a <code>View3DPanel</code> with a {@link MapControl3D}.

     * 

     * @param mapControl3D

     *            Model of the <code>View3DPanel</code>.

     * @param title

     *            Title of panel.

     * @see View3DSwingManager#createView3DPanel(MapContext, String, TYPE,

     *      ExtendedPropertiesSupport)

     * @see View3DSwingManager#createMapControl3D(MapContext, TYPE,

     *      ExtendedPropertiesSupport)

     * @return The <code>View3DPanel</code>.

     */

    public View3DPanel createView3DPanel(MapControl3D mapControl3D, String title);

    /**

     * Creates the view 3D properties panel. View 3D properties panel is used to

     * show and change MapControl 3D properties in a graphical way. See

     * {@link MapControlProperties3D}.

     * 

     * @param properties

     *            Model of view 3D properties panel.

     * @return view 3D properites panel.

     */

    public ViewProperties3DPanel createViewProperties3DPanel(

        MapControlProperties3D properties);

    /**

     * Gets <code>GeneralProperties3D<code> of 3D library.

     * 

     * @see View3DSwingManager#setGeneral3DProperties(GeneralProperties3D)

     * @return

     */

    public GeneralProperties3D getGeneral3DProperties();

    /**

     * Gets the {@link MapControl3D} associated with view properties

     * {@link ExtendedPropertiesSupport}. If there are not indicated type of

     * <code>MapControl3D</code> associated with view properties, it will return

     * an empty list.

     * 

     * @param viewProperties

     * @see View3DSwingManager#getMapControl3D(ExtendedPropertiesSupport, TYPE)

     * @return List of <code>MapControl3D</code> associated with the view

     *         propoerties.

     */

    public List<MapControl3D> getMapControl3D(

        ExtendedPropertiesSupport viewProperties);

    /**

     * Gets the {@link MapControl3D} associated with view properties

     * {@link ExtendedPropertiesSupport}. Returns <code>null</code>, if there

     * are

     * not indicated type of <code>MapControl3D</code> registered at view

     * properties.

     * 

     * @param viewProperties

     * @param type

     *            Type of <code>MapControl3D</code>

     * @see View3DSwingManager#getMapControl3D(ExtendedPropertiesSupport)

     * @return

     */

    public MapControl3D getMapControl3D(

        ExtendedPropertiesSupport viewProperties, TYPE type);

    /**

     * Gets <code>MapControlProperties3D</code> linked with the view properties.

     * 

     * @param viewProperties

     *            View properties to get the <code>MapControlProperties3D</code>

     *            associated.

     * @see View3DSwingManager#setMapControlProperties3D(ExtendedPropertiesSupport,

     *      MapControlProperties3D)

     * @return

     */

    public MapControlProperties3D getMapControl3DProperties(

        ExtendedPropertiesSupport viewProperties);

    /**

     * Sets <code>GeneralProperties3D</code> to 3D library.

     * 

     * @param properties

     *            General 3D properties.

     * @see View3DSwingManager#getGeneral3DProperties()

     */

    public void setGeneral3DProperties(GeneralProperties3D properties);

    /**

     * Sets <code>MapControlProperties3D</code> to view properties.

     * 

     * @param viewProperties

     *            View properties to link the

     *            <code>MapControlProperties3D</code>.

     * @param mapControl3DProperties

     *            The {@link MapControlProperties3D} to be linked.

     * @see View3DSwingManager#getMapControl3DProperties(ExtendedPropertiesSupport)

     */

    public void setMapControlProperties3D(

        ExtendedPropertiesSupport viewProperties,

        MapControlProperties3D mapControl3DProperties);

}

/**

 * 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;

import org.gvsig.view3d.swing.api.properties.MapControlProperties3D;

/**

 * 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>Get and set atmosphere layer. See {@link MapControl3D#getAtmosphereVisibility()}

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

 * <li>Get and set Minimap component layer. See

 * {@link MapControl3D#getMinimapVisibility()} and {@link MapControl3D#setMiniMapVisibility(boolean)}</li>

 * <li>Get and set North indicator component layer. See

 * {@link MapControl3D#getNorthIndicatorVisibility()} and

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

 * <li>Get and set scale component layer. See {@link MapControl3D#getScaleVisibility()}

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

 * <li>Get and set star background layer. See

 * {@link MapControl3D#getStarBackgroundVisibility()} and

 * {@link MapControl3D#setStarsBackgroundVisibility(boolean)}</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.

     * 

     */

    public MapContext getMapContext();

    /**

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

     * 

     */

    public TYPE getType();

    /**

     * Gets 3D MapControl properties of this MapControl3D. 

     * 

     * @return

     */

    public MapControlProperties3D getProperties();

    /**

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

     * 

     * @see MapControl3D#setVerticalExaggeration(double)

     */

    public double getVerticalExaggeration();

    /**

     * Sets Atmosphere visibility.

     * 

     * @see MapControl3D#getAtmosphereVisibility()

     */

    public void setAtmosphereVisibility(boolean visibility);

    /**

     * Sets MiniMap visibility.

     * 

     * @see MapControl3D#getMinimapVisibility()

     */

    public void setMiniMapVisibility(boolean visibility);

    /**

     * Sets North Indicator visibility.

     * 

     * @see MapControl3D#getNorthIndicatorVisibility()

     */

    public void setNorthIndicatorVisibility(boolean visibility);

    /**

     * Sets Scale visibility.

     * 

     * @see MapControl3D#getScaleVisibility()

     */

    public void setScaleVisibility(boolean visibility);

    /**

     * Sets Star background visibility.

     * 

     * @see MapControl3D#getStarBackgroundVisibility()

     */

    public void setStarsBackgroundVisibility(boolean visibility);

    /**

     * Gets Atmosphere visibility.

     * 

     * @see MapControl3D#getAtmosphereVisibility()

     */

    public boolean getAtmosphereVisibility();

    /**

     * Gets Minimap visibility.

     * 

     * @see MapControl3D#getMinimapVisibility()

     */

    public boolean getMinimapVisibility();

    /**

     * Gets North indicator visibility.

     * 

     * @see MapControl3D#getNorthIndicatorVisibility()

     */

    public boolean getNorthIndicatorVisibility();

    /**

     * Gets Star background visibility.

     * 

     * @see MapControl3D#getStarBackgroundVisibility()

     */

    public boolean getStarBackgroundVisibility();

    /**

     * Gets Scale visibility.

     * 

     * @see MapControl3D#getScaleVisibility()

     */

    public boolean getScaleVisibility();

    /**

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

     * 

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

     */

    public void reloadLayers();

    /**

     * 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();

}

package org.gvsig.view3d.swing.api.properties;

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

/**

 * This class represents the available API to get the indicated values at panel.

 * 

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

 *

 */

public interface ViewProperties3DPanel extends Component {

    /**

     * Gets auto layer synchronize.

     * 

     * @return

     */

    public boolean getAutoLayerSynchronize();

    /**

     * Gets auto view port synchronize.

     * 

     * @return

     */

    public boolean getAutoViewPortSynchronize();

    /**

     * Gets if Blue Marble is showing.

     * 

     * @return

     */

    public boolean getShowBlueMarble();

    /**

     * Gets if default elevation is showing.

     * 

     * @return

     */

    public boolean getShowDefaultElevation();

    /**

     * Gets if Nasa Landsat is showing.

     * 

     * @return

     */

    public boolean getShowNasaLandsat();

    /**

     * Gets vertical exaggertion of flat 3D view.

     * 

     * @return

     */

    public double getFlatVerticalExaggeration();

    /**

     * Gets vertical exaggeration of sphere 3D view.

     * 

     * @return

     */

    public double getSphereVerticalExaggeration();

}

package org.gvsig.view3d.swing.api.properties;

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

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

/**

 * This class represents the available API to get the indicated values at panel.

 * 

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

 *

 */

public interface LayerProperties3DPanel extends Component {

    /**

     * Gets elevation field that has elevation values.

     * 

     * @return

     */

    public String getElevationField();

    /**

     * Gets elevation units of elevation values.

     * 

     * @return

     */

    public String getElevationUnits();

    /**

     * Gets layer of model panel.

     * 

     * @see LayerProperties3DPanel#setLayer(FLayer)

     * @return

     */

    public FLayer getLayer();

    /**

     * Gets the load mode of layer.  

     * 

     * @return

     */

    public String getLoadMode();

    /**

     * Gets maximum level of detail showed.

     * 

     * @return

     */

    public int getMaxLevel();

    /**

     * Gets minimum level of detail showed.

     * 

     * @return

     */

    public int getMinLevel();

    /**

     * Gets NoData value

     * 

     * @return

     */

    public double getNoDataValue();

    /**

     * Gets resolution multiplier at zero level.

     * 

     * @return

     */

    public double getResolutionMultiplier();

    /**

     * Gets tile heigth

     * 

     * @return

     */

    public int getTileHeight();

    /**

     * Get tile width

     * 

     * @return

     */

    public int getTileWidth();

    /**

     * Sets layer of model.

     * 

     * @param layer

     * @see LayerProperties3DPanel#getLayer()

     */

    public void setLayer(FLayer layer);

}

package org.gvsig.view3d.swing.api.properties;

import java.beans.PropertyChangeListener;

import java.io.File;

/**

 * This class represents the general properties of 3D library.

 * 

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

 *

 */

public interface GeneralProperties3D {

    public final static String DEFAULT_VIEW_HEIGHT_PROPERTY_NAME =

        "defaultViewHeight";

    public final static String DEFAULT_VIEW_WIDTH_PROPERTY_NAME =

        "defaultViewWidth";

    public final static String ATMOSPHERE_VISIBILITY_PROPERTY_NAME =

        "atmosphereVisibility";

    public final static String MINIMAP_VISIBILITY_PROPERTY_NAME =

        "minimapVisibility";

    public final static String NORTH_INDICATOR_VISIBILITY_PROPERTY_NAME =

        "northIndicatorVisibility";

    public final static String STARS_BACKGROUND_VISIBILITY_PROPERTY_NAME =

        "starsBackgroundVisibility";

    public final static String SCALE_VISIBILITY_PROPERTY_NAME =

        "scaleVisibility";

    public final static String VIEWPORT_ANIMATION_PROPERTY_NAME =

        "viewPortAnimation";

    public final static String CACHE_PATH_PROPERTY_NAME = "cachePath";

    /**

     * Adds {@link PropertyChangeListener} that will listen properties changes.

     * 

     * @param listener

     * @see GeneralProperties3D#removePropertyChangeListener(PropertyChangeListener)

     */

    public void addPropertyChangeListener(PropertyChangeListener listener);

    /**

     * Gets the atmosphere visibility.

     * 

     * @see GeneralProperties3D#setAtmosphereVisibility(boolean)

     * @return visibility of atmosphere component.

     */

    public boolean getAtmosphereVisibility();

    /**

     * Gets path of tile cache.

     * 

     * @see GeneralProperties3D#setCachePath(File)

     * @return

     */

    public File getCachePath();

    /**

     * Gets the default view heigth of 3D views.

     * 

     * @see GeneralProperties3D#setDefaultViewHeight(int)

     * @return Default height of 3D views.

     */

    public int getDefaultViewHeight();

    /**

     * Gets the default view width of 3D views.

     * 

     * @see GeneralProperties3D#setDefaultViewWidth(int)

     * @return Default width of 3D views.

     */

    public int getDefaultViewWidth();

    /**

     * Gets minimap visibility.

     * 

     * @see GeneralProperties3D#setMinimapVisibility(boolean)

     * @return Visibility of minimap.

     */

    public boolean getMinimapVisibility();

    /**

     * Gets north indicator visibility.

     * 

     * @see GeneralProperties3D#setNorthIndicatorVisibility(boolean)

     * @return Visibility of north indicator component.

     */

    public boolean getNorthIndicatorVisibility();

    /**

     * Get visibility of scale component.

     * 

     * @see GeneralProperties3D#setScaleVisibility(boolean)

     * @return Visibility of scale component.

     */

    public boolean getScaleVisibility();

    /**

     * Get starts background visibility.

     * 

     * @see GeneralProperties3D#setStarsBackgroundVisibility(boolean)

     * @return Visibility of starts background component.

     */

    public boolean getStarsBackgroundVisibility();

    /**

     * Gets if the view port synchronize is animated

     * 

     * @see GeneralProperties3D#setViewPortAnimation(boolean)

     * @return True if view port synchronize is animated, false if it is not

     *         animated.

     */

    public boolean getViewPortAnimation();

    /**

     * Removes {@link PropertyChangeListener}.

     * 

     * @param listener

     * @see GeneralProperties3D#addPropertyChangeListener(PropertyChangeListener)

     */

    public void removePropertyChangeListener(PropertyChangeListener listener);

    /**

     * Sets visibility of atmosphere component.

     * 

     * @param visibility

     * @see GeneralProperties3D#getAtmosphereVisibility()

     */

    public void setAtmosphereVisibility(boolean visibility);

    /**

     * Sets path of tile cache.

     * 

     * @param path

     * @see GeneralProperties3D#getCachePath()

     */

    public void setCachePath(File path);

    /**

     * Sets default view height.

     * 

     * @param height

     * @see GeneralProperties3D#getDefaultViewHeight()

     */

    public void setDefaultViewHeight(int height);

    /**

     * Sets default view width.

     * 

     * @param width

     * @see GeneralProperties3D#getDefaultViewWidth()

     */

    public void setDefaultViewWidth(int width);

    /**

     * Sets visibility of miniMap component.

     * 

     * @param visibility

     * @see GeneralProperties3D#getMinimapVisibility()

     */

    public void setMinimapVisibility(boolean visibility);

    /**

     * Sets visibility of north indicator component.

     * 

     * @param visibility

     * @see GeneralProperties3D#getNorthIndicatorVisibility()

     */

    public void setNorthIndicatorVisibility(boolean visibility);

    /**

     * Sets visibility of scale component.

     * 

     * @param visibility

     * @see GeneralProperties3D#getScaleVisibility()

     */

    public void setScaleVisibility(boolean visibility);

    /**

     * Sets visibility of starts background component.

     * 

     * @param visibility

     * @see GeneralProperties3D#getStarsBackgroundVisibility()

     */

    public void setStarsBackgroundVisibility(boolean visibility);

    /**

     * Sets if the view port synchronize is animated or not.

     * 

     * @param flag

     * @see GeneralProperties3D#getViewPortAnimation()

     */

    public void setViewPortAnimation(boolean flag);

}

package org.gvsig.view3d.swing.api.properties;

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

/**

 * This class represents the available API to get the indicated values at panel.

 * 

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

 *

 */

public interface GeneralProperties3DPanel extends Component {

    /**

     * Gets atmospehere visibility.

     * 

     * @return

     */

    public boolean getAtmosphereVisibility();

    /**

     * Gets cache path indicated.

     * 

     * @return

     */

    public String getCachePath();

    /**

     * Gets default height.

     * 

     * @return

     */

    public int getDefaultHeight();

    /**

     * Gets default width.

     * 

     * @return

     */

    public int getDefaultWidth();

    /**

     * Get minimap visibility.

     * 

     * @return

     */

    public boolean getMinimapVisibility();

    /**

     * Gets north indicator visibility.

     * 

     * @return

     */

    public boolean getNorthIndicatorVisibility();

    /**

     * Gets scale visibility.

     * 

     * @return

     */

    public boolean getScaleVisiblity();

    /**

     * Gets starts background visibility

     * 

     * @return

     */

    public boolean getStarsBackgroundVisiblity();

    /**

     * Get view port animation.

     * 

     * @return

     */

    public boolean getViewPortAnimation();

}

package org.gvsig.view3d.swing.api.properties;

import java.beans.PropertyChangeListener;

import org.gvsig.tools.persistence.Persistent;

import org.gvsig.view3d.swing.api.MapControl3D;

/**

 * This class represents the properties of {@link MapControl3D}.

 * 

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

 *

 */

public interface MapControlProperties3D extends Persistent{

    public static final String PERSISTENCE_NAME = "MapControl3DProperties";

    public final String SPHERE_VERTICAL_EXAGGERATION_PROPERTY_NAME =

        "sphereVerticalExaggeration";

    public final String FLAT_VERTICAL_EXAGGERATION_PROPERTY_NAME =

        "flatVerticalExaggeration";

    public final String AUTO_LAYER_SYNCHRONIZE_PROPERTY_NAME =

        "autoLayerSynchronize";

    public final String AUTO_VIEWPORT_SYNCHRONIZE_PROPERTY_NAME =

        "autoViewPortSynchronize";

    public final String BLUE_MARBEL_VISIBILITY_PROPERTY_NAME =

        "blueMarbelLayerVisibility";

    public final String NASA_LANDSAT_VISIBILITY_PROPERTY_NAME =

        "nasaLandsatLayerVisibility";

    public final String DEFAULT_ELEVATION_VISIBILITY_PROPERTY_NAME =

        "defaultElevationVisibility";

    /**

     * Adds {@link PropertyChangeListener} that will listen properties changes.

     * 

     * @param listener

     */

    public void addPropertyChangeListener(PropertyChangeListener listener);

    /**

     * Gets if auto layer synchronize is active or not.

     * 

     * @see MapControlProperties3D#setAutoLayerSynchronize(boolean)

     * @return

     */

    public boolean getAutoLayerSynchronize();

    /**

     * Gets if auto view synchronize is active or not

     * 

     * @see MapControlProperties3D#setAutoViewPortSynchronize(boolean)

     * @return

     */

    public boolean getAutoViewPortSynchronize();

    /**

     * Gets visibility of Blue Marble layer. 

     * 

     * @see MapControlProperties3D#setBlueMarbleLayerVisibility(boolean)

     * @return

     */

    public boolean getBlueMarbleLayerVisibility();

    /**

     * Gets visiblity of default elevation.

     * 

     * @see MapControlProperties3D#setDefaultElevationVisibility(boolean)

     * @return

     */

    public boolean getDefaultElevationVisibility();

    /**

     * Get vertical exaggeration of flat view

     * 

     * @see MapControlProperties3D#setFlatVerticalExaggeration(double)

     * @return

     */

    public double getFlatVerticalExaggeration();

    /**

     * Gets visibility of Nasa Landsat Layer

     * 

     * @see MapControlProperties3D#setNasaLandsatVisibility(boolean)

     * @return

     */

    public boolean getNasaLandsatLayerVisibility();

    /**

     * Gets vertical exaggeration of sphere view

     * 

     * @see MapControlProperties3D#setSphereVerticalExaggeration(double)

     * @return

     */

    public double getSphereVerticalExaggeration();

    /**

     * Removes {@link PropertyChangeListener}.

     * 

     * @see MapControlProperties3D#addPropertyChangeListener(PropertyChangeListener)

     * @param listener

     */

    public void removePropertyChangeListener(PropertyChangeListener listener);

    /**

     * Set auto layer synchronize.

     * 

     * @param flag True to active auto layer synchronize, false to disable it.

     * @see MapControlProperties3D#getAutoLayerSynchronize()

     */

    public void setAutoLayerSynchronize(boolean flag);

    /**

     * Set auto viesport synchronize.

     * 

     * @param flag True to active auto viewport synchronize, false to disable it.

     * @see MapControlProperties3D#getAutoViewSynchronize()

     */

    public void setAutoViewPortSynchronize(boolean flag);

    /**

     * Sets visibility of BlueMarble layer.

     * 

     * @param visibility

     * @see MapControlProperties3D#getBlueMarbleLayerVisibility()

     */

    public void setBlueMarbleLayerVisibility(boolean visibility);

    /**

     * Sets visibility of deafult elevation.

     * 

     * @param visibility

     * @see MapControlProperties3D#getDefaultElevationVisibility()

     */

    public void setDefaultElevationVisibility(boolean visibility);

    /**

     * Sets flat vertical exaggeration.

     * 

     * @param value

     * @see MapControlProperties3D#getFlatVerticalExaggeration()

     */

    public void setFlatVerticalExaggeration(double value);

    /**

     * Sets Nasa Landsat visibility.

     * 

     * @param visibility

     * @see MapControlProperties3D#getNasaLandsatLayerVisibility()

     */

    public void setNasaLandsatVisibility(boolean visibility);

    /**

     * Sets sphere vertical exaggeration.

     * 

     * @param value

     * @see MapControlProperties3D#getSphereVerticalExaggeration()

     */

    public void setSphereVerticalExaggeration(double value);

}

/**

 * 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 org.gvsig.tools.locator.BaseLocator;

import org.gvsig.tools.locator.LocatorException;

/**

 * This locator is the entry point for the View 3D swing library, providing

 * access to View3D swing services through the {@link View3DSwingManager} .

 *

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

 */

public class View3DSwingLocator extends BaseLocator {

    private static final String LOCATOR_NAME = "View3DSwingLocator";

    public static final String MANAGER_NAME = "View3D.SwingManager";

    private static final String MANAGER_DESCRIPTION = "View 3D Swing Manager";

    private static final View3DSwingLocator instance = new View3DSwingLocator();

    /**

     * Return the singleton instance.

     * 

     * @return the singleton instance

     */

    public static View3DSwingLocator getInstance() {

        return instance;

    }

    public String getLocatorName() {

        return LOCATOR_NAME;

    }

    /**

     * Return a reference to View3DSwingManager.

     * 

     * @return a reference to View3DSwingManager

     * @throws LocatorException

     *             if there is no access to the class or the class

     *             cannot be instantiated

     * @see Locator#get(String)View3DSwingManager

     */

    public static View3DSwingManager getManager() throws LocatorException {

        return (View3DSwingManager) getInstance().get(MANAGER_NAME);

    }

    /**

     * Registers the Class implementing the View3DSwingLocator interface.

     * 

     * @param clazz

     *            implementing the View3DSwingManager interface

     */

    public static void registerManager(Class clazz) {

        getInstance().register(MANAGER_NAME, MANAGER_DESCRIPTION, clazz);

    }

    public static void registerDefaultManager(Class clazz) {

        getInstance().registerDefault(MANAGER_NAME, MANAGER_DESCRIPTION, clazz);

    }

}

/**

 * 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 org.gvsig.fmap.dal.DALLibrary;

import org.gvsig.tools.library.AbstractLibrary;

import org.gvsig.tools.library.LibraryException;

import org.gvsig.tools.locator.ReferenceNotRegisteredException;

/**

 * Library for API initialization and configuration.

 *

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

 */

public class View3DSwingLibrary extends AbstractLibrary {

    @Override

    public void doRegistration() {

        registerAsAPI(View3DSwingLibrary.class);

        require(DALLibrary.class);

    }

    @Override

    protected void doInitialize() throws LibraryException {

    }

    @Override

    protected void doPostInitialize() throws LibraryException {

        View3DSwingManager manager = View3DSwingLocator.getManager();

        if (manager == null) {

            throw new ReferenceNotRegisteredException(

                View3DSwingLocator.MANAGER_NAME, View3DSwingLocator.getInstance());

        }

    }

}

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

  <modelVersion>4.0.0</modelVersion>

  <parent>

    <groupId>org.gvsig</groupId>

    <artifactId>org.gvsig.view3d</artifactId>

    <version>1.0.9</version>

  </parent>

  <artifactId>org.gvsig.view3d.swing</artifactId>

  <packaging>pom</packaging>

  <name>org.gvsig.view3d.swing</name>

  <modules>

  	<module>org.gvsig.view3d.swing.api</module>

  	<module>org.gvsig.view3d.swing.impl</module>

  </modules>

</project>

<?xml version="1.0" encoding="UTF-8"?>

<!--

  ~ Copyright (C) 2012 United States Government as represented by the Administrator of the

  ~ National Aeronautics and Space Administration.

  ~ All Rights Reserved.

  -->

<!--$Id: LandsatI3WMSLayer2.xml 1962 2014-04-26 00:30:00Z tgaskins $-->

<Layer version="1" layerType="TiledImageLayer">

    <DisplayName>i-cubed Landsat</DisplayName>

    <Service serviceName="OGC:WMS" version="1.3">

        <GetCapabilitiesURL>http://worldwind25.arc.nasa.gov/wms</GetCapabilitiesURL>

        <GetMapURL>http://worldwind25.arc.nasa.gov/wms</GetMapURL>

        <LayerNames>esat</LayerNames>

    </Service>

    <RetrievePropertiesFromService>true</RetrievePropertiesFromService>

    <!-- day month year hours:minutes:seconds timezone -->

    <DataCacheName>Earth/NASA LandSat I3 WMS 2</DataCacheName>

    <ImageFormat>image/png</ImageFormat>

    <AvailableImageFormats>

        <ImageFormat>image/png</ImageFormat>

        <ImageFormat>image/jpeg</ImageFormat>

    </AvailableImageFormats>

    <FormatSuffix>.dds</FormatSuffix>

    <NumLevels count="10" numEmpty="4"/>

    <TileOrigin>

        <LatLon units="degrees" latitude="-90" longitude="-180"/>

    </TileOrigin>

    <LevelZeroTileDelta>

        <LatLon units="degrees" latitude="36" longitude="36"/>

    </LevelZeroTileDelta>

    <TileSize>

        <Dimension width="512" height="512"/>

    </TileSize>

    <Sector>

        <SouthWest>

            <LatLon units="degrees" latitude="-90" longitude="-180"/>

        </SouthWest>

        <NorthEast>

            <LatLon units="degrees" latitude="90" longitude="180"/>

        </NorthEast>

    </Sector>

    <UseTransparentTextures>true</UseTransparentTextures>

    <!--<ScreenCredit creditType="ScreenImage">-->

    <!--<FileName>images/32x32-icon-nasa.png</FileName>-->

    <!--<Link>http://worldwind.arc.nasa.gov/java</Link>-->

    <!--</ScreenCredit>-->

    <RetrievalTimeouts>

        <ReadTimeout>

            <Time units="milliseconds" value="20000"/>

        </ReadTimeout>

    </RetrievalTimeouts>

</Layer>

<?xml version="1.0" encoding="UTF-8"?>

<!--

  ~ Copyright (C) 2012 United States Government as represented by the Administrator of the

  ~ National Aeronautics and Space Administration.

  ~ All Rights Reserved.

  -->

<!--Blue Marble Next generation 2004 + Bathymetry imagery, using the default month (May).-->

<!--$Id: BMNGWMSLayer2.xml 1382 2013-05-31 00:37:46Z tgaskins $-->

<Layer version="1" layerType="TiledImageLayer">

    <DisplayName>Blue Marble May 2004</DisplayName>

    <Service serviceName="OGC:WMS" version="1.3">

        <GetCapabilitiesURL>http://worldwind25.arc.nasa.gov/wms</GetCapabilitiesURL>

        <GetMapURL>http://worldwind25.arc.nasa.gov/wms</GetMapURL>

        <LayerNames>BlueMarble-200405</LayerNames>

    </Service>

    <RetrievePropertiesFromService>true</RetrievePropertiesFromService>

    <!-- day month year hours:minutes:seconds timezone -->

    <DataCacheName>Earth/BMNGWMS2/BMNG(Shaded + Bathymetry) Tiled - Version 1.1 - 5.2004</DataCacheName>

    <ImageFormat>image/jpeg</ImageFormat>

    <AvailableImageFormats>

        <ImageFormat>image/jpeg</ImageFormat>

        <ImageFormat>image/png</ImageFormat>

    </AvailableImageFormats>

    <FormatSuffix>.dds</FormatSuffix>

    <NumLevels count="5" numEmpty="0"/>

    <TileOrigin>

        <LatLon units="degrees" latitude="-90" longitude="-180"/>

    </TileOrigin>

    <LevelZeroTileDelta>

        <LatLon units="degrees" latitude="36" longitude="36"/>

    </LevelZeroTileDelta>

    <TileSize>

        <Dimension width="512" height="512"/>

    </TileSize>

    <Sector>

        <SouthWest>

            <LatLon units="degrees" latitude="-90" longitude="-180"/>

        </SouthWest>

        <NorthEast>

            <LatLon units="degrees" latitude="90" longitude="180"/>

        </NorthEast>

    </Sector>

    <ForceLevelZeroLoads>true</ForceLevelZeroLoads>

    <RetainLevelZeroTiles>true</RetainLevelZeroTiles>

    <UseTransparentTextures>false</UseTransparentTextures>

    <RetrievalTimeouts>

        <ReadTimeout>

            <Time units="milliseconds" value="30000"/>

        </ReadTimeout>

    </RetrievalTimeouts>

    <!-- The following lines are included just to show how to set the values to other than their defaults -->

    <MaxAbsentTileAttempts>2</MaxAbsentTileAttempts>

    <MinAbsentTileCheckInterval>1000</MinAbsentTileCheckInterval>

</Layer>

org.gvsig.view3d.swing.impl.DefaultView3DSwingLibrary

<?xml version="1.0" encoding="UTF-8"?>

<!--

  ~ Copyright (C) 2012 United States Government as represented by the Administrator of the

  ~ National Aeronautics and Space Administration.

  ~ All Rights Reserved.

  -->

<!--$Id: worldwind.layers.xml 1382 2013-05-31 00:37:46Z tgaskins $-->

<!--This document specifies the initial layers to load in World Wind-->

<!--This list can be overridden by specifying an alternate list in worldwind.xml, or by specifying an-->

<!--alternate configuration document-->

<!--See the javadoc for the Configuration class for details-->

<LayerList>