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.fmap.dal.coverage.store.props;

/**

 * Interfaz que representa una interpretaci?n de color.

 * 

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

 */

public interface ColorInterpretation {

        // Identificadores de color interpretation

        public static final String RED_BAND            = "Red";

        public static final String GREEN_BAND          = "Green";

        public static final String BLUE_BAND           = "Blue";

        public static final String ALPHA_BAND          = "Alpha";

        public static final String GRAY_BAND           = "Gray";

        public static final String PAL_BAND            = "Palette";

        public static final String UNDEF_BAND          = "Undefined";

        /**

         * Asigna un valor para la interpretaci?n de color de una banda

         * @param band Banda 

         * @param value valor

         */

        public void setColorInterpValue(int band, String value);

        /**

         * Obtiene el n?mero de entradas de interpretaci?n de color por

         * banda en la lista.

         * @return

         */

        public int length();

        /**

         * Returns true if the color interpretation is BGR

         * @return

         */

        public boolean isBGR();

        /**

         * Returns true if the color interpretation is RGB

         * @return

         */

        public boolean isRGB();

        /**

         * Returns true if the color interpretation is ARGB

         * @return

         */

        public boolean isARGB();

        /**

         * Obtiene el valor de interpretaci?n de color de la entrada i. 

         * @param i N?mero de entrada

         * @return interpretaci?n de color para la entrada solicitada

         */

        public String get(int i);

        /**

         * Obtiene la posici?n de la banda que contiene el identificador pasado por par?metro 

         * o -1 si no tiene dicho identificador.

         * @return Posici?n de la banda que contiene el identificador o -1 si no lo tiene.

         */

        public int getBand(String id);

        /**

         * Consulta si la interpretaci?n de color est? por definir en la imagen.

         * @return true si no hay interpretaci?n de color definida y false si la hay

         */

        public boolean isUndefined();

        /**

         * Inicializa el vector de cadenas que contendr?n el nombre de la interpretaci?n 

         * de color asignada a cada banda. Este valor es el devuelto por la imagen.

         * @param values N?mero de valores

         */

        public void initColorInterpretation(int values);

        /**

         * Obtiene los valores de la interpretaci?n de color

         * @return String[]

         */

        public String[] getValues();

        /**

         * Returns true if one band has the "Alpha" label

         * @return

         */

        public boolean hasAlphaBand();

        /**

         * Returns the number of band with the label "Alpha"

         * @return

         */

        public int getAlphaBand();

        /**

         * A?ade un objeto DatasetColorInterpretation al actual. El resultado es la suma 

         * de ambos.

         * @param ci

         */

        public void addColorInterpretation(ColorInterpretation ci);

        /**

         * Clones this object

         * @return

         */

        public ColorInterpretation cloneColorInterpretation();

}