awt/java/awt/color/ColorSpace.java

/*
 *  Licensed to the Apache Software Foundation (ASF) under one or more
 *  contributor license agreements.  See the NOTICE file distributed with
 *  this work for additional information regarding copyright ownership.
 *  The ASF licenses this file to You under the Apache License, Version 2.0
 *  (the "License"); you may not use this file except in compliance with
 *  the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */
/**
 * @author Oleg V. Khaschansky
 * @version $Revision$
 */
package java.awt.color;

import java.io.Serializable;

import org.apache.harmony.awt.gl.color.LUTColorConverter;
import org.apache.harmony.awt.internal.nls.Messages;

/**
 * The ColorSpace class defines a color space type for a Color and provides
 * methods for arrays of color component operations.
 * 
 * @since Android 1.0
 */
public abstract class ColorSpace implements Serializable {

    /** The Constant serialVersionUID. */
    private static final long serialVersionUID = -409452704308689724L;

    /**
     * The Constant TYPE_XYZ indicates XYZ color space type.
     */
    public static final int TYPE_XYZ = 0;

    /**
     * The Constant TYPE_Lab indicates Lab color space type.
     */
    public static final int TYPE_Lab = 1;

    /**
     * The Constant TYPE_Luv indicates Luv color space type.
     */
    public static final int TYPE_Luv = 2;

    /**
     * The Constant TYPE_YCbCr indicates YCbCr color space type.
     */
    public static final int TYPE_YCbCr = 3;

    /**
     * The Constant TYPE_Yxy indicates Yxy color space type.
     */
    public static final int TYPE_Yxy = 4;

    /**
     * The Constant TYPE_RGB indicates RGB color space type.
     */
    public static final int TYPE_RGB = 5;

    /**
     * The Constant TYPE_GRAY indicates Gray color space type.
     */
    public static final int TYPE_GRAY = 6;

    /**
     * The Constant TYPE_HSV indicates HSV color space type.
     */
    public static final int TYPE_HSV = 7;

    /**
     * The Constant TYPE_HLS indicates HLS color space type.
     */
    public static final int TYPE_HLS = 8;

    /**
     * The Constant TYPE_CMYK indicates CMYK color space type.
     */
    public static final int TYPE_CMYK = 9;

    /**
     * The Constant TYPE_CMY indicates CMY color space type.
     */
    public static final int TYPE_CMY = 11;

    /**
     * The Constant TYPE_2CLR indicates color spaces with 2 components.
     */
    public static final int TYPE_2CLR = 12;

    /**
     * The Constant TYPE_3CLR indicates color spaces with 3 components.
     */
    public static final int TYPE_3CLR = 13;

    /**
     * The Constant TYPE_4CLR indicates color spaces with 4 components.
     */
    public static final int TYPE_4CLR = 14;

    /**
     * The Constant TYPE_5CLR indicates color spaces with 5 components.
     */
    public static final int TYPE_5CLR = 15;

    /**
     * The Constant TYPE_6CLR indicates color spaces with 6 components.
     */
    public static final int TYPE_6CLR = 16;

    /**
     * The Constant TYPE_7CLR indicates color spaces with 7 components.
     */
    public static final int TYPE_7CLR = 17;

    /**
     * The Constant TYPE_8CLR indicates color spaces with 8 components.
     */
    public static final int TYPE_8CLR = 18;

    /**
     * The Constant TYPE_9CLR indicates color spaces with 9 components.
     */
    public static final int TYPE_9CLR = 19;

    /**
     * The Constant TYPE_ACLR indicates color spaces with 10 components.
     */
    public static final int TYPE_ACLR = 20;

    /**
     * The Constant TYPE_BCLR indicates color spaces with 11 components.
     */
    public static final int TYPE_BCLR = 21;

    /**
     * The Constant TYPE_CCLR indicates color spaces with 12 components.
     */
    public static final int TYPE_CCLR = 22;

    /**
     * The Constant TYPE_DCLR indicates color spaces with 13 components.
     */
    public static final int TYPE_DCLR = 23;

    /**
     * The Constant TYPE_ECLR indicates color spaces with 14 components.
     */
    public static final int TYPE_ECLR = 24;

    /**
     * The Constant TYPE_FCLR indicates color spaces with 15 components.
     */
    public static final int TYPE_FCLR = 25;

    /**
     * The Constant CS_sRGB indicates standard RGB color space.
     */
    public static final int CS_sRGB = 1000;

    /**
     * The Constant CS_LINEAR_RGB indicates linear RGB color space.
     */
    public static final int CS_LINEAR_RGB = 1004;

    /**
     * The Constant CS_CIEXYZ indicates CIEXYZ conversion color space.
     */
    public static final int CS_CIEXYZ = 1001;

    /**
     * The Constant CS_PYCC indicates Photo YCC conversion color space.
     */
    public static final int CS_PYCC = 1002;

    /**
     * The Constant CS_GRAY indicates linear gray scale color space.
     */
    public static final int CS_GRAY = 1003;

    /**
     * The cs_ gray.
     */
    private static ColorSpace cs_Gray = null;
    
    /**
     * The cs_ pycc.
     */
    private static ColorSpace cs_PYCC = null;
    
    /**
     * The cs_ ciexyz.
     */
    private static ColorSpace cs_CIEXYZ = null;
    
    /**
     * The cs_ lrgb.
     */
    private static ColorSpace cs_LRGB = null;
    
    /**
     * The cs_s rgb.
     */
    private static ColorSpace cs_sRGB = null;

    /**
     * The type.
     */
    private int type;
    
    /**
     * The num components.
     */
    private int numComponents;

    /**
     * Instantiates a ColorSpace with the specified ColorSpace type and number
     * of components.
     * 
     * @param type
     *            the type of color space.
     * @param numcomponents
     *            the number of components.
     */
    protected ColorSpace(int type, int numcomponents) {
        this.numComponents = numcomponents;
        this.type = type;
    }

    /**
     * Gets the name of the component for the specified component index.
     * 
     * @param idx
     *            the index of the component.
     * @return the name of the component.
     */
    public String getName(int idx) {
        if (idx < 0 || idx > numComponents - 1) {
            // awt.16A=Invalid component index: {0}
            throw new IllegalArgumentException(Messages.getString("awt.16A", idx)); //$NON-NLS-1$
        }

      return "Unnamed color component #" + idx; //$NON-NLS-1$
    }

    /**
     * Performs the transformation of a color from this ColorSpace into the RGB
     * color space.
     * 
     * @param colorvalue
     *            the color value in this ColorSpace.
     * @return the float array with color components in the RGB color space.
     */
    public abstract float[] toRGB(float[] colorvalue);

    /**
     * Performs the transformation of a color from this ColorSpace into the
     * CS_CIEXYZ color space.
     * 
     * @param colorvalue
     *            the color value in this ColorSpace.
     * @return the float array with color components in the CS_CIEXYZ color
     *         space.
     */
    public abstract float[] toCIEXYZ(float[] colorvalue);

    /**
     * Performs the transformation of a color from the RGB color space into this
     * ColorSpace.
     * 
     * @param rgbvalue
     *            the float array representing a color in the RGB color space.
     * @return the float array with the transformed color components.
     */
    public abstract float[] fromRGB(float[] rgbvalue);

    /**
     * Performs the transformation of a color from the CS_CIEXYZ color space
     * into this ColorSpace.
     * 
     * @param colorvalue
     *            the float array representing a color in the CS_CIEXYZ color
     *            space.
     * @return the float array with the transformed color components.
     */
    public abstract float[] fromCIEXYZ(float[] colorvalue);

    /**
     * Gets the minimum normalized color component value for the specified
     * component.
     * 
     * @param component
     *            the component to determine the minimum value.
     * @return the minimum normalized value of the component.
     */
    public float getMinValue(int component) {
        if (component < 0 || component > numComponents - 1) {
            // awt.16A=Invalid component index: {0}
            throw new IllegalArgumentException(Messages.getString("awt.16A", component)); //$NON-NLS-1$
        }
        return 0;
    }

    /**
     * Gets the maximum normalized color component value for the specified
     * component.
     * 
     * @param component
     *            the component to determine the maximum value.
     * @return the maximum normalized value of the component.
     */
    public float getMaxValue(int component) {
        if (component < 0 || component > numComponents - 1) {
            // awt.16A=Invalid component index: {0}
            throw new IllegalArgumentException(Messages.getString("awt.16A", component)); //$NON-NLS-1$
        }
        return 1;
    }

    /**
     * Checks if this ColorSpace has CS_sRGB type or not.
     * 
     * @return true, if this ColorSpace has CS_sRGB type, false otherwise.
     */
    public boolean isCS_sRGB() {
        // If our color space is sRGB, then cs_sRGB
        // is already initialized
        return (this == cs_sRGB);
    }

    /**
     * Gets the type of the ColorSpace.
     * 
     * @return the type of the ColorSpace.
     */
    public int getType() {
        return type;
    }

    /**
     * Gets the number of components for this ColorSpace.
     * 
     * @return the number of components.
     */
    public int getNumComponents() {
        return numComponents;
    }


    /**
     * Gets the single instance of ColorSpace with the specified ColorSpace:
     * CS_sRGB, CS_LINEAR_RGB, CS_CIEXYZ, CS_GRAY, or CS_PYCC.
     * 
     * @param colorspace
     *            the identifier of the specified Colorspace.
     * @return the single instance of the desired ColorSpace.
     */
    public static ColorSpace getInstance(int colorspace) {
        switch (colorspace) {
            case CS_sRGB:
                if (cs_sRGB == null) {
                    cs_sRGB = new ICC_ColorSpace(
                            new ICC_ProfileStub(CS_sRGB));
                    LUTColorConverter.sRGB_CS = cs_sRGB;
                            //ICC_Profile.getInstance (CS_sRGB));
                }
                return cs_sRGB;
            case CS_CIEXYZ:
                if (cs_CIEXYZ == null) {
                    cs_CIEXYZ = new ICC_ColorSpace(
                            new ICC_ProfileStub(CS_CIEXYZ));
                            //ICC_Profile.getInstance (CS_CIEXYZ));
                }
                return cs_CIEXYZ;
            case CS_GRAY:
                if (cs_Gray == null) {
                    cs_Gray = new ICC_ColorSpace(
                            new ICC_ProfileStub(CS_GRAY));
                    LUTColorConverter.LINEAR_GRAY_CS = cs_Gray;
                            //ICC_Profile.getInstance (CS_GRAY));
                }
                return cs_Gray;
            case CS_PYCC:
                if (cs_PYCC == null) {
                    cs_PYCC = new ICC_ColorSpace(
                            new ICC_ProfileStub(CS_PYCC));
                            //ICC_Profile.getInstance (CS_PYCC));
                }
                return cs_PYCC;
            case CS_LINEAR_RGB:
                if (cs_LRGB == null) {
                    cs_LRGB = new ICC_ColorSpace(
                            new ICC_ProfileStub(CS_LINEAR_RGB));
                    LUTColorConverter.LINEAR_GRAY_CS = cs_Gray;
                            //ICC_Profile.getInstance (CS_LINEAR_RGB));
                }
                return cs_LRGB;
            default:
        }

        // Unknown argument passed
        // awt.16B=Not a predefined colorspace
        throw new IllegalArgumentException(Messages.getString("Not a predefined colorspace")); //$NON-NLS-1$
    }

}