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.impl.layers;

import org.gvsig.fmap.dal.exception.DataException;

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

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

import org.gvsig.view3d.swing.impl.layers.raster.DefaultTiledImageLayer;

import gov.nasa.worldwind.globes.ElevationModel;

import gov.nasa.worldwind.layers.Layer;

/**

 * Factory to convert {@link FLayer} to {@link Layer} or {@link ElevationModel}.

 * 

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

 */

public interface LayerConverter {

    /**

     * Converts {@link FLayer} to {@link Layer}. The type of

     * <code>WW Layer</code> and WorldWind properties is defined by the 3D

     * properties of <code>FLayer</code>. If there are some parameters undefined

     * is set to default value.

     * 

     * @param mapControl

     *            context of <code>FLayer</code>.

     * @param layer

     *            <code>FLayer</code> to be converted.

     * @return An instance of {@link DefaultTiledImageLayer}.

     * @throws DataException

     *             if there are some problems getting some information of

     *             <code>FLayer</code>.

     */

    public Layer convertToLayer(MapControl3D mapControl, FLayer layer)

        throws DataException;

    /**

     * Converts {@link FLayer} to {@link ElevationModel}.

     * <code>ElevationModel</code> properties are definied by 3D properties of

     * The type of <code>WW ElevationModel</code> is defined by the 3D

     * properties of <code>FLayer</code>. If there are some parameters undefined

     * is set to default value.

     * 

     * @param mapControl

     *            context of <code>FLayer</code>.

     * @param layer

     *            <code>FLayer</code> to be converted.

     * @return An instance of {@link DefaultTiledImageLayer}.

     * @throws DataException

     *             if there are some problems getting some information of

     *             <code>FLayer</code>.

     */

    public ElevationModel convertToElevationModel(MapControl3D mapControl,

        FLayer layer);

}