Application: gvSIG desktop

/* gvSIG. Desktop Geographic Information System.

 *

 * Copyright ? 2007-2016 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.fmap.dal.raster.spi;

import java.awt.Image;

import org.gvsig.fmap.dal.DataStoreParameters;

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

import org.gvsig.fmap.dal.raster.BandAttributeDescriptor;

import org.gvsig.fmap.dal.raster.BandDescriptor;

import org.gvsig.fmap.dal.raster.RasterQuery;

import org.gvsig.fmap.dal.spi.DataStoreProvider;

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

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

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

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

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

/**

 * Interface for all raster based data providers.

 * @author dmartinezizquierdo

 *

 */

public interface RasterStoreProvider extends DataStoreProvider{

//extends CoverageStoreProvider{

    /**

     * @param rasterQuery

     * @return Buffer

     * @throws BufferException

     */

    Buffer createBuffer(RasterQuery rasterQuery) throws BufferException;

    /**

     * Gets {@link BandDescriptor} of band received as parameter. If band does

     * not have {@link BandAttributeDescriptor}, this method will return an

     * empty {@link BandDescriptor}.

     *

     * @param band

     *            Band to get its {@link BandDescriptor}

     * @return BandDescriptor

     */

    public BandDescriptor getBandDescriptor(int band);

    /**

     * Gets bands of raster provider source

     *

     * @return Number of available bands from source

     */

    public int getBands();

    /**

     * Return the appropriate TileStruct for a tiled access to this provider, if can.

     *

     * @return

     */

    public TileStruct getTileStruct();

    /**

     * @return the image legend or null

     */

    public Image getImageLegend();

    /**

     * Return the parameters of this provider

     *

     * @return

     */

    public DataStoreParameters getParameters();

    /**

     * Return the buffer dimensions of the complete store.

     * @return

     * @throws InitializeException

     */

    public BufferDimensions getDimensions() throws InitializeException;

    /**

     * @return

     */

    public boolean isTiled();

}