Application: gvSIG desktop » gvSIG raster

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

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

 *

 */

package org.gvsig.raster.impl.provider;

import java.awt.geom.Point2D;

import org.gvsig.fmap.dal.coverage.datastruct.Extent;

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

import org.gvsig.raster.cache.tile.Tile;

import org.gvsig.raster.cache.tile.exception.TileGettingException;

import org.gvsig.raster.impl.buffer.DefaultRasterQuery;

/**

 * Interface that should be implemented by tiled providers 

 * @author Nacho Brodin (nachobrodin@gmail.com)

 *

 */

public interface TiledRasterProvider {

        /**

         * Calculates the extent of a zoom level using other extent as a reference. The new extent is 

         * calculated with the same coordinate at the center. 

         * @param level

         * @param extent

         * @param w

         * @param h

         * @return

         */

        public Extent getCoordsInTheNearestLevel(Extent extent, int w, int h);

        /**

         * Calculates the extent of a zoom level using a center. 

         * @param viewCenter

         * @param level

         * @param w

         * @param h

         * @return

         */

        public Extent getCoordsInLevel(Point2D viewCenter, int level, int w, int h);

        /**

         * Gets the number of zoom levels

         * @return

         */

        public int getZoomLevels();

        /**

         * Gets the nearest level to the selected pixel size

         * @param pixelSize

         * @return

         */

        public int getNearestLevel(double pixelSize);

        /**

         * Gets a tile

         * @param level

         *        Resolution level

         * @param tileCol

         *        Tile column in the resolution level

         * @param tileRow

         *        Tile row in the resolution level

         * @param bbox

         *        Bounding box of the tile

         * @return

         * @throws TileGettingException

         */

        public Tile getTile(DefaultRasterQuery q) throws TileGettingException;

        /**

         * Gets a tile

         * @param level

         *        Resolution level

         * @param tileCol

         *        Tile column in the resolution level

         * @param tileRow

         *        Tile row in the resolution level

         * @param bbox

         *        Bounding box of the tile

         * @return

         * @throws TileGettingException

         */

        //public Tile getTile(int level, int tileCol, int tileRow, Extent ex, CacheStruct cacheStruct) throws TileGettingException;

        /**

         * Sets the tile cache data server. This is the server assigned by the client. 

         * It will force to build a second level cache if the CacheStruct is not the same

         * as the owner. 

         * @param tileServer

         */

        public void setTileServer(Class<?> tileServer) throws InitializeException;

        /**

         * Returns the tile size in pixels if this providers have tiles

         * @return

         */

        public int[] getTileSize(int level);

        /**

         * Gets the internal provider used to feed the TileProvider

         * @return

         */

        public RasterProvider getInternalProvider();

}