Application: gvSIG desktop

package org.gvsig.raster.lib.legend.impl;

/**

 * Coversi?n de de colores y valores de pixel aplicando distintos m?todos.

 *

 * 31/10/2007

 * @author Nacho Brodin nachobrodin@gmail.com

 */

public interface ColorManager {

    /**

     * Conversi?n de RGB a HSL (Hue, Saturation, Lightness)

     * @param rojo Banda del rojo del pixel de entrada

     * @param verde Banda del verde del pixel de entrada

     * @param azul Banda del azul del pixel de entrada

     * @return array de 3 valores con los datos HSL correspondiente al pixel de entrada.

     */

    public double[] RGBtoHSL(int rojo, int verde, int azul);

    /**

     * Conversi?n de RGB a HSV (Hue, Saturation, Value). El valor de H es el mismo que en

     * HSL pero difiere en el calculo de la S y la V.

     * @param rojo Banda del rojo del pixel de entrada

     * @param verde Banda del verde del pixel de entrada

     * @param azul Banda del azul del pixel de entrada

     * @return array de 3 valores con los datos HSL correspondiente al pixel de entrada.

     */

    public double[] RGBtoHSV(int rojo, int verde, int azul);

    /**

     * Conversi?n de HSL a RGB

     * @param h Banda de matiz del pixel de entrada

     * @param s Banda de saturaci?n del pixel de entrada

     * @param l Banda de brillo del pixel de entrada

     * @return array de 3 valores con los datos RGB correspondiente al pixel de entrada.

     */

    public int[] HSLtoRGB(int h, int s, int l);

    /**

     * Conversi?n de HSL a RGB

     * @param h Banda de matiz del pixel de entrada. Valor entre 0 y 1.

     * @param s Banda de saturaci?n del pixel de entrada. Valor entre 0 y 1.

     * @param l Banda de brillo del pixel de entrada. Valor entre 0 y 1.

     * @return array de 3 valores con los datos RGB correspondiente al pixel de entrada.

     */

    public int[] HSLtoRGB(double h, double s, double l);

    /**

     * Conversi?n de RGB a CMYK (Cyan, Magenta, Yellow, Key).

     * @param red Banda del rojo del pixel de entrada

     * @param green Banda del verde del pixel de entrada

     * @param blue Banda del azul del pixel de entrada

     * @param kScale valor entre 0 y 1

     * @return array de 4 valores con los datos CMYK correspondiente al pixel de entrada.

     */

    public double[] RGBtoCMYK(int red, int green, int blue, double kScale);

    /**

     * Conversi?n de CMYK (Cyan, Magenta, Yellow, Key) a RGB (red, green, blue).

     * @param red Banda del rojo del pixel de entrada

     * @param green Banda del verde del pixel de entrada

     * @param blue Banda del azul del pixel de entrada

     * @param kScale valor entre 0 y 1

     * @return array de 4 valores con los datos CMYK correspondiente al pixel de entrada.

     */

    public double[] CMYKtoRGB(double cyan, double magenta, double yellow, double key);

    /**

     * Obtiene la luminosidad del RGB pasado por par?metro

     * @param red Banda del rojo del pixel de entrada

     * @param green Banda del verde del pixel de entrada

     * @param blue Banda del azul del pixel de entrada

     * @return double que representa la luminosidad. Para tenerlo en un rango de 255 hay que aplicar (lum * 255. + 0.5);

     */

    public double getLuminosity(int red, int green, int blue);

    /**

     * Descompone un entero que representa un ARGB en sus 4 valores byte Obtiene

     * un array de 4 elementos donde el elemento 0 es el Rojo, el 1 es el verde,

     * el 2 el azul y el 3 el alpha.

     * @param rgb Entero con el valor ARGB a descomponer;

     * @return Array de cuatro elementos

     */

    public byte[] getARGBFromIntToByteArray(int rgb);

    /**

     * Descompone un entero que representa un ARGB en sus 4 valores byte Obtiene

     * un array de 4 elementos donde el elemento 0 es el Rojo, el 1 es el verde,

     * el 2 el azul y el 3 el alpha.

     * @param rgb Entero con el valor ARGB a descomponer;

     * @return

     */

    public int[] getARGBFromIntToIntArray(int rgb);

    /**

     * Obtiene un entero con los valores ARGB pasados por par?metro

     * @param a Valor de alpha

     * @param r Valor del rojo

     * @param g Valor del verde

     * @param b Valor del azul

     * @return entero con la mezcla de valores

     */

    public int getIntFromARGB(int a, int r, int g, int b);

}