| gvSIG desktop 1

/* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

 *

 * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.

 *

 * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

 *

 * For more information, contact:

 *

 *  Generalitat Valenciana

 *   Conselleria d'Infraestructures i Transport

 *   Av. Blasco Ib??ez, 50

 *   46010 VALENCIA

 *   SPAIN

 *

 *      +34 963862235

 *   gvsig@gva.es

 *      www.gvsig.gva.es

 *

 *    or

 *

 *   IVER T.I. S.A

 *   Salamanca 50

 *   46005 Valencia

 *   Spain

 *

 *   +34 963163400

 *   dac@iver.es

 */

package com.iver.cit.gvsig.fmap.drivers;

import java.awt.Dimension;

import java.awt.Graphics2D;

import java.awt.Image;

import java.awt.geom.Rectangle2D;

import java.awt.image.BufferedImage;

import java.io.File;

import java.io.IOException;

import org.cresques.cts.ICoordTrans;

import com.hardcode.driverManager.Driver;

import com.iver.cit.gvsig.fmap.ViewPort;

public interface RasterDriver extends Driver {

    /**

     * Define los tipos de fichero que puede leer el driver. Si devuelve true,

     * el fichero est? aceptado (es de los que el driver puede leer), si

     * devuelve false es porque no lo puede leer.

     */

        public boolean fileAccepted(File fName);

        public void open(File f) throws IOException;

        public void initialize() throws IOException;

        public void close() throws IOException;

    /**

     * Obtiene la extensi?n en coordenadas del mundo real que ocupa este raster 

     */

        public Rectangle2D getFullExtent();

    /**

     * Obtiene el n?mero de bandas del raster 

     */

        public int getNumBands();

        public int getTransparency();

        public void setTransparency(int trans);

        /**

         * @see com.iver.cit.gvsig.fmap.layers.LayerOperations#draw(java.awt.image.BufferedImage, java.awt.Graphics2D, com.iver.cit.gvsig.fmap.ViewPort)

         */

        public void draw(BufferedImage image, Graphics2D g, ViewPort viewPort)

                        throws DriverIOException;

        /**

         * Obtiene el valor que el raster tiene en la posici?n x, y del bitmap

         * @see com.iver.cit.gvsig.fmap.layers.RasterComplexOperations#getValueByCoords(int, int, int)

         * /

        byte[] getPixel(int x, int y, byte[] dArray);

        / **

         * Obtiene el valor que el raster tiene en la posici?n x, y del bitmap

         * @see com.iver.cit.gvsig.fmap.layers.RasterComplexOperations#getValueByCoords(int, int, int)

         * /

        int[] getPixel(int x, int y, int[] dArray);

        /**

         * Obtiene el valor que el raster tiene en la posici?n x, y del bitmap

         * @see com.iver.cit.gvsig.fmap.layers.RasterComplexOperations#getValueByCoords(int, int, int)

         * /

        float[] getPixel(int x, int y, float[] dArray);

        /**

         * Obtiene el valor que el raster tiene en la posici?n x, y del mundo real para la banda que se pasa como par?metro

         * @see com.iver.cit.gvsig.fmap.layers.RasterComplexOperations#getValueByCoords(int, int, int)

         * /

        double[] getPixel(int x, int y, double[] dArray);

        */

        /**

         * Devuelve el tipo de datos del raster

         * @see java.awt.image.DataBuffer

         */

        public int getRasterDataType();

    /**

     * Obtiene una muestra del pixel que se pasa como par?metro en la banda que se pasa como par?metro 

     */

        public Object getData(int x, int y, int band);

    /**

     * Obtiene una muestra del pixel que se pasa como par?metro en la banda que se pasa como par?metro 

     */

        public int getDataAsInt(int x, int y, int band);

    /**

     * Obtiene una muestra del pixel que se pasa como par?metro en la banda que se pasa como par?metro 

     */

        public byte getDataAsByte(int x, int y, int band);

    /**

     * Obtiene una muestra del pixel que se pasa como par?metro en la banda que se pasa como par?metro 

     */

        public float getDataAsFloat(int x, int y, int band);

    /**

     * Obtiene una muestra el pixel que se pasa como par?metro en la banda que se pasa como par?metro 

     */

        public double getDataAsDouble(int x, int y, int band);

        /**

         * Obtiene una imagen de tama?o especificado, de la zona (en

         * coordenadas de usuario) que se le pide.

         * @param size        Tama?o (en p?xeles de im?gen).

         * @param userSize Zona especificada (en coordenadas de usuario).

         * @param rp Reproyecci?n.

         * @return La imagen.

         */

        public Image getImage(Dimension size, Rectangle2D userSize, ICoordTrans rp);

}