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 org.gvsig.fmap.mapcontext.MapContext;

/**

 * 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 a <code>View3DPanel</code> with a {@link MapControl3D}.

     * 

     * @param theMapContext

     *            associated <code>MapContext</code> of

     *            <code>MapControl3D</code>

     * @param type

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

     * @see View3DSwingManager#createMapControl3D(MapContext, TYPE)

     * @return

     */

    public View3DPanel createView3DPanel(MapContext theMapContext, TYPE type);

    /**

     * 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}.

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

     */

    public MapControl3D createMapControl3D(MapContext theMapContext, TYPE type);

    /**

     * Gets the {@link MapControl3D} registered with {@link MapContext} and

     * {@link TYPE} received as paremeter.

     * Returns <code>null</code> if there is no intance registered with that

     * <code>MapContext</code> and <code>TYPE</code>.

     * 

     * @param theMapContext

     *            associated <code>MapContext</code> of

     *            <code>MapControl3D</code>

     * @param type

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

     * @return Intance registered with <code>MapContext</code> and

     *         <code>TYPE</code>, if there is no intance registered

     *         <code> null </code>

     */

    public MapControl3D getMapControl3D(MapContext theMapContext, TYPE type);

    // TODO: Add methods to get properties panels.

}