< prev index next >

src/java.desktop/share/classes/java/awt/color/ColorSpace.java

Print this page

        

*** 266,276 **** /** * Constructs a ColorSpace object given a color space type * and the number of components. ! * @param type one of the <CODE>ColorSpace</CODE> type constants * @param numcomponents the number of components in the color space */ protected ColorSpace (int type, int numcomponents) { this.type = type; this.numComponents = numcomponents; --- 266,276 ---- /** * Constructs a ColorSpace object given a color space type * and the number of components. ! * @param type one of the {@code ColorSpace} type constants * @param numcomponents the number of components in the color space */ protected ColorSpace (int type, int numcomponents) { this.type = type; this.numComponents = numcomponents;
*** 281,291 **** * Returns a ColorSpace representing one of the specific * predefined color spaces. * @param colorspace a specific color space identified by one of * the predefined class constants (e.g. CS_sRGB, CS_LINEAR_RGB, * CS_CIEXYZ, CS_GRAY, or CS_PYCC) ! * @return the requested <CODE>ColorSpace</CODE> object */ // NOTE: This method may be called by privileged threads. // DO NOT INVOKE CLIENT CODE ON THIS THREAD! public static ColorSpace getInstance (int colorspace) { --- 281,291 ---- * Returns a ColorSpace representing one of the specific * predefined color spaces. * @param colorspace a specific color space identified by one of * the predefined class constants (e.g. CS_sRGB, CS_LINEAR_RGB, * CS_CIEXYZ, CS_GRAY, or CS_PYCC) ! * @return the requested {@code ColorSpace} object */ // NOTE: This method may be called by privileged threads. // DO NOT INVOKE CLIENT CODE ON THIS THREAD! public static ColorSpace getInstance (int colorspace) {
*** 364,375 **** } /** * Returns true if the ColorSpace is CS_sRGB. ! * @return <CODE>true</CODE> if this is a <CODE>CS_sRGB</CODE> color ! * space, <code>false</code> if it is not */ public boolean isCS_sRGB () { /* REMIND - make sure we know sRGBspace exists already */ return (this == sRGBspace); } --- 364,375 ---- } /** * Returns true if the ColorSpace is CS_sRGB. ! * @return {@code true} if this is a {@code CS_sRGB} color ! * space, {@code false} if it is not */ public boolean isCS_sRGB () { /* REMIND - make sure we know sRGBspace exists already */ return (this == sRGBspace); }
*** 379,392 **** * into a value in the default CS_sRGB color space. * <p> * This method transforms color values using algorithms designed * to produce the best perceptual match between input and output * colors. In order to do colorimetric conversion of color values, ! * you should use the <code>toCIEXYZ</code> * method of this color space to first convert from the input * color space to the CS_CIEXYZ color space, and then use the ! * <code>fromCIEXYZ</code> method of the CS_sRGB color space to * convert from CS_CIEXYZ to the output color space. * See {@link #toCIEXYZ(float[]) toCIEXYZ} and * {@link #fromCIEXYZ(float[]) fromCIEXYZ} for further information. * * @param colorvalue a float array with length of at least the number --- 379,392 ---- * into a value in the default CS_sRGB color space. * <p> * This method transforms color values using algorithms designed * to produce the best perceptual match between input and output * colors. In order to do colorimetric conversion of color values, ! * you should use the {@code toCIEXYZ} * method of this color space to first convert from the input * color space to the CS_CIEXYZ color space, and then use the ! * {@code fromCIEXYZ} method of the CS_sRGB color space to * convert from CS_CIEXYZ to the output color space. * See {@link #toCIEXYZ(float[]) toCIEXYZ} and * {@link #fromCIEXYZ(float[]) fromCIEXYZ} for further information. * * @param colorvalue a float array with length of at least the number
*** 403,416 **** * color space into this ColorSpace. * <p> * This method transforms color values using algorithms designed * to produce the best perceptual match between input and output * colors. In order to do colorimetric conversion of color values, ! * you should use the <code>toCIEXYZ</code> * method of the CS_sRGB color space to first convert from the input * color space to the CS_CIEXYZ color space, and then use the ! * <code>fromCIEXYZ</code> method of this color space to * convert from CS_CIEXYZ to the output color space. * See {@link #toCIEXYZ(float[]) toCIEXYZ} and * {@link #fromCIEXYZ(float[]) fromCIEXYZ} for further information. * * @param rgbvalue a float array with length of at least 3 --- 403,416 ---- * color space into this ColorSpace. * <p> * This method transforms color values using algorithms designed * to produce the best perceptual match between input and output * colors. In order to do colorimetric conversion of color values, ! * you should use the {@code toCIEXYZ} * method of the CS_sRGB color space to first convert from the input * color space to the CS_CIEXYZ color space, and then use the ! * {@code fromCIEXYZ} method of this color space to * convert from CS_CIEXYZ to the output color space. * See {@link #toCIEXYZ(float[]) toCIEXYZ} and * {@link #fromCIEXYZ(float[]) fromCIEXYZ} for further information. * * @param rgbvalue a float array with length of at least 3
*** 436,446 **** * representation is not the same as the XYZ values that would * be measured from the given color value by a colorimeter. * A further transformation is necessary to compute the XYZ values * that would be measured using current CIE recommended practices. * See the {@link ICC_ColorSpace#toCIEXYZ(float[]) toCIEXYZ} method of ! * <code>ICC_ColorSpace</code> for further information. * * @param colorvalue a float array with length of at least the number * of components in this ColorSpace * @return a float array of length 3 * @throws ArrayIndexOutOfBoundsException if array length is not --- 436,446 ---- * representation is not the same as the XYZ values that would * be measured from the given color value by a colorimeter. * A further transformation is necessary to compute the XYZ values * that would be measured using current CIE recommended practices. * See the {@link ICC_ColorSpace#toCIEXYZ(float[]) toCIEXYZ} method of ! * {@code ICC_ColorSpace} for further information. * * @param colorvalue a float array with length of at least the number * of components in this ColorSpace * @return a float array of length 3 * @throws ArrayIndexOutOfBoundsException if array length is not
*** 464,474 **** * the XYZ value passed to the method when measured by a colorimeter. * If you have XYZ values corresponding to measurements made using * current CIE recommended practices, they must be converted to D50 * relative values before being passed to this method. * See the {@link ICC_ColorSpace#fromCIEXYZ(float[]) fromCIEXYZ} method of ! * <code>ICC_ColorSpace</code> for further information. * * @param colorvalue a float array with length of at least 3 * @return a float array with length equal to the number of * components in this ColorSpace * @throws ArrayIndexOutOfBoundsException if array length is not --- 464,474 ---- * the XYZ value passed to the method when measured by a colorimeter. * If you have XYZ values corresponding to measurements made using * current CIE recommended practices, they must be converted to D50 * relative values before being passed to this method. * See the {@link ICC_ColorSpace#fromCIEXYZ(float[]) fromCIEXYZ} method of ! * {@code ICC_ColorSpace} for further information. * * @param colorvalue a float array with length of at least 3 * @return a float array with length equal to the number of * components in this ColorSpace * @throws ArrayIndexOutOfBoundsException if array length is not
*** 484,513 **** * green, and blue. It does not define the particular color * characteristics of the space, e.g. the chromaticities of the * primaries. * * @return the type constant that represents the type of this ! * <CODE>ColorSpace</CODE> */ public int getType() { return type; } /** * Returns the number of components of this ColorSpace. ! * @return The number of components in this <CODE>ColorSpace</CODE>. */ public int getNumComponents() { return numComponents; } /** * Returns the name of the component given the component index. * * @param idx the component index * @return the name of the component at the specified index ! * @throws IllegalArgumentException if <code>idx</code> is * less than 0 or greater than numComponents - 1 */ public String getName (int idx) { /* REMIND - handle common cases here */ if ((idx < 0) || (idx > numComponents - 1)) { --- 484,513 ---- * green, and blue. It does not define the particular color * characteristics of the space, e.g. the chromaticities of the * primaries. * * @return the type constant that represents the type of this ! * {@code ColorSpace} */ public int getType() { return type; } /** * Returns the number of components of this ColorSpace. ! * @return The number of components in this {@code ColorSpace}. */ public int getNumComponents() { return numComponents; } /** * Returns the name of the component given the component index. * * @param idx the component index * @return the name of the component at the specified index ! * @throws IllegalArgumentException if {@code idx} is * less than 0 or greater than numComponents - 1 */ public String getName (int idx) { /* REMIND - handle common cases here */ if ((idx < 0) || (idx > numComponents - 1)) {
< prev index next >