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.cache.tile;

import java.awt.geom.Point2D;

import java.awt.geom.Rectangle2D;

import org.gvsig.raster.cache.tile.provider.CacheStruct;

/**

 * This class is responsible of the management of the library's business logic.

 * It is the library's main entry point, and provides all the services to manage

 * {@link TileCacheService}s.

 * 

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

 * @version $Id$

 */

public interface TileCacheManager {

        /**

         * Builds a new entry point for a tile cache. The parameter is an identifier for a 

         * tile cache structured implemented inside of this library

         * @param baseDir

         * @return

         */

        public TileCache getTileCache(String baseDir);

        /**

         * Creates a new tile structure

         * @param level

         * @param col

         *        Tile column

         * @param row

         *        Tile row

         * @return

         */

        public Tile createTile(int level, int col, int row);

        /**

         * Creates a new tile structure

         * @param wPx

         *        Width in pixels

         * @param hPx

         *        Height in pixels

         * @param row

         *        Tile row

         * @param col

         *        Tile column

         * @param ul

         *        Upper left coordinate

         * @param lr

         *        Lower roght coordinate 

         * @return

         */

        public Tile createTile(int wPx, int hPx, int row, int col, Point2D ul, Point2D lr);

        /**

         * Builds a standard cache structure 

         * @param typeOfCoords Constant defined in CacheStruct interface

         * @param levels Number of levels

         * @param layerExtent Bounding box of the layer

         * @param pixelSize Pixel size of the layer

         * @param tilePxWidth Width in pixels of a tile

         * @param tilePxHeight Height in pixels of a tile

         * @param layerName Layer name or identifier

         * @param strategy Strategy to store tiles in disk

         * @param baseDir path to this layer

         * @param fileSuffix File suffix

         * @param epsg 

         * @return

         */

        public CacheStruct createCacheStructure(int typeOfCoords, 

                    int levels, 

                    Rectangle2D layerExtent, 

                    double pixelSize,

                    int tilePxWidth,

                    int tilePxHeight,

                    String layerName,

                    String strategy,

                    String baseDir,

                    String fileSuffix,

                    String epsg,

                    long fileSize);

}