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.georeferencing.swing.view;

import java.awt.Color;

import java.awt.geom.Point2D;

import java.awt.geom.Rectangle2D;

import java.awt.image.BufferedImage;

import java.util.List;

/**

 * Zona de dibujado del raster

 * 21/12/2007

 * @author Nacho Brodin nachobrodin@gmail.com

 */

public interface GeorefCanvas  {

    /**

         * Asigna los par?metros de dibujado

         * @param img Buffer con un ?rea de datos

         * @param ext Rectangle2D del ?rea de datos dada 

         * @param pixelSize Tama?o de pixel

         * @param center Punto del ?rea de datos donde se quiere centrar el dibujado del buffer

         */

        public void setDrawParams(BufferedImage img, Rectangle2D ext, double pixelSize, Point2D center);

        /**

         * Asigna el listener de eventos de la vista

         * @param listener

         */

        public void setViewListener(ViewListener listener);

        /**

         * Asigna un nuevo centro de visualizaci?n

         * @param center

         */

        public void setCenter(Point2D center);

        public void repaint();

        /**

         * Conversi?n de un punto en coordenadas del canvas a reales

         * @param p

         * @return

         */

        public Point2D viewCoordsToWorld(Point2D p);

        /**

         * Conversi?n de un punto en coordenadas del canvas a reales

         * @param p

         * @return

         */

        public Point2D viewCoordsFromWorld(Point2D p);

        /**

         * Obtiene el extent del canvas en coordenadas del mundo real

         * @return Rectangle2D

         */

        public Rectangle2D getExtent();

        /**

         * Asigna un nuevo centro de visualizaci?n en coordenadas del

         * componente.

         * @param center

         */

        public void setViewCenter(Point2D c);

        /**

         * Asigna un nuevo centro de visualizaci?n en coordenadas pixel

         * del ?rea de dibujado (canvas). El nuevo centro ser? calculado en coordenadas

         * del mapa.

         * @param center

         */

        public void setPixelCenter(Point2D c);

        /**

         * Asigna un nuevo centro de visualizaci?n en coordenadas pixel. Esta llamada tiene

         * en cuenta solo p?xeles completos. No centra sobre porciones de pixel cuando el zoom es

         * mayor de 1:1. El nuevo centro es en coordenadas del mapa pero siempre centrar?

         * en la esquina inferior izquierda del pixel.

         * @param center

         */

        public void setPixelCenter(int x, int y);

        /**

         * Asigna una capa gr?fica

         * @param layer IGraphicLayer

         */

        public void setGraphicLayer(IGraphicLayer layer);

        /**

         * Obtiene la lista de capas gr?ficas

         * @return

         */

        public List<IGraphicLayer> getGraphicLayers();

        /**

         * Asigna la escala para el nuevo zoom

         * @param scale

         */

        public void setZoom(double scale);

        /**

         * Obtiene la escala aplicada en el dibujado

         * @return double

         */

        public double getZoom();

        /**

         * Obtiene el extent actual asignado al canvas

         * @return Rectangle2D

         */

        public Rectangle2D getCanvasExtent();

        /**

         * Asigna el extent del canvas

         * @param r

         */

        public void setCanvasExtent(Rectangle2D r);

        /**

         * Obtiene el tama?o de pixel

         * @return double

         */

        public double getPixelSize();

        /**

         * Obtiene el centro del canvas

         * @return Point2D

         */

        public Point2D getCenter();

        /**

         * Asigna la tool seleccionada

         * @param selectedTool

         */

        //public void setSelectedTool(BaseViewTool selectedTool);

        /**

         * Obtiene la herramienta seleccionada

         * @return BaseViewTool

         */

        //public BaseViewTool getSelectedTool();

        /**

         * Activa o desactiva el mostrado de informaci?n

         * @param showInfo

         */

        public void setShowInfo(boolean showInfo);

        /**

         * Asigna el valor para el flag minxMaxyUL. Este flag informa de que la esquina 

         * superior izquierda corresponde con el valor de m?nimo X y m?ximo Y. En caso 

         * de ser false esta esquina ser?a de m?nimo X y m?nimo Y.

         * @param v

         */

        public void setMinxMaxyUL(boolean v);

        /**

         * Obtiene el valor para el flag minxMaxyUL. Este flag informa de que la esquina 

         * superior izquierda corresponde con el valor de m?nimo X y m?ximo Y. En caso 

         * de ser false esta esquina ser?a de m?nimo X y m?nimo Y.

         * @param v

         */

        public boolean getMinxMaxyUL();

        /**

         * Asigna el color del texto

         * @param textColor

         */

        public void setTextColor(Color textColor);

        /**

         * Obtiene el color del texto

         * @return

         */

        public Color getTextColor();

        /**

         * Obtiene el color de fondo

         * @return

         */

        public Color getBackgroundColor();

        /**

         * Asigna el color de fondo

         * @param backgroundColor

         */

        public void setBackgroundColor(Color backgroundColor);

        /**

         * Normalmente no se hace una petici?n al dibujado del raster si el extent no ha variado. Si esta variable

     * est? a true fuerza que haya una petici?n de redibujado aunque el extent del raster no haya cambiado.

     * Esto solo se hace para una petici?n. La siguiente vuelve a estar a false.

         * @return

         */

        public boolean isForceRequest();

        /**

         * Normalmente no se hace una petici?n al dibujado del raster si el extent no ha variado. Si esta variable

     * est? a true fuerza que haya una petici?n de redibujado aunque el extent del raster no haya cambiado.

     * Esto solo se hace para una petici?n. La siguiente vuelve a estar a false.

         * @param forceRequest

         */

        public void setForceRequest(boolean forceRequest);

}