Application: gvSIG desktop » gvSIG raster

package org.gvsig.raster.tilecache.provider;

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

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

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

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

import org.gvsig.fmap.geom.exception.CreateEnvelopeException;

import org.gvsig.fmap.geom.primitive.Envelope;

import org.gvsig.raster.lib.buffer.api.Band;

import org.gvsig.raster.lib.buffer.api.TileStruct;

import org.gvsig.raster.lib.buffer.api.exceptions.BufferException;

import org.gvsig.tools.dynobject.exception.DynMethodException;

public interface TileStructImage {

    /**

     * @param pixelSize

     * @return The appropiate zoom level for the pizelSize

     */

    public abstract int getZoomLvlForPixelSize(double pixelSize);

    /**

     * @param buffer

     * @param bandNumber

     * @param zoomLevel

     * @param tileRow

     * @param tileCol

     * @return Band

     * @throws CreateEnvelopeException

     * @throws CloneNotSupportedException

     * @throws ValidateDataParametersException

     */

    public abstract Band fetchTile(int bandNumber, int zoomLevel, int structRow, int structCol)

        throws CreateEnvelopeException, ValidateDataParametersException, CloneNotSupportedException;

    /**

     * @return the band number

     * @throws CloneNotSupportedException

     * @throws ValidateDataParametersException

     * @throws DataException

     * @throws BufferException

     * @throws CreateEnvelopeException

     * @throws DynMethodException

     */

    public abstract int getBandNumber() throws ValidateDataParametersException, CreateEnvelopeException,

        BufferException, DataException, CloneNotSupportedException;

    /**

     * @return the data types

     * @throws CloneNotSupportedException

     * @throws ValidateDataParametersException

     * @throws DataException

     * @throws BufferException

     * @throws CreateEnvelopeException

     * @throws DynMethodException

     */

    public abstract int[] getDataTypes() throws ValidateDataParametersException, CreateEnvelopeException,

        BufferException, DataException, CloneNotSupportedException;

    /**

     * @param zoomLevel

     * @return rows per zoom level

     */

    public abstract int getRows(int zoomLevel);

    /**

     * @param zoomLevel

     * @return columns per zoom level

     */

    public abstract int getColumns(int zoomLevel);

    /**

     * @return envelope per zoom level

     */

    public abstract Envelope getEnvelope();

    /**

     * @return the rows number per tile

     */

    public abstract int getRowsPerTile();

    /**

     * @return the columns number per tile

     */

    public abstract int getColumnsPerTile();

    /**

     * @return the provider name

     */

    public abstract String getProviderName();

    /**

     * @return the color interpretation

     * @throws DynMethodException

     * @throws CloneNotSupportedException

     * @throws ValidateDataParametersException

     * @throws DataException

     * @throws BufferException

     * @throws CreateEnvelopeException

     */

    public abstract Object getColorInterpretation() throws DynMethodException, ValidateDataParametersException,

        CreateEnvelopeException, BufferException, DataException, CloneNotSupportedException;

    /**

     * @return the color table

     * @throws ValidateDataParametersException

     * @throws DynMethodException

     * @throws CloneNotSupportedException

     * @throws DataException

     * @throws BufferException

     * @throws CreateEnvelopeException

     * @throws InitializeException

     * @throws ProviderNotRegisteredException

     */

    public abstract Object getColorTable() throws DynMethodException, ValidateDataParametersException,

        CreateEnvelopeException, BufferException, DataException, CloneNotSupportedException;

    /**

     * @return the legend

     * @throws ValidateDataParametersException

     * @throws DynMethodException

     * @throws CloneNotSupportedException

     * @throws DataException

     * @throws BufferException

     * @throws CreateEnvelopeException

     * @throws InitializeException

     * @throws ProviderNotRegisteredException

     */

    public abstract Object getLegend() throws DynMethodException, ValidateDataParametersException,

        CreateEnvelopeException, BufferException, DataException, CloneNotSupportedException;

    public abstract TileStruct getTileStruct();

}