Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.

java.awt.color
Class ColorSpace

java.lang.Object
  java.awt.color.ColorSpace

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ICC_ColorSpace

public abstract class ColorSpace
extends Object
implements Serializable

Esta classe abstrata é usada para servir como um rótulo de espaço de cor para identificar um espaço de cor específico de um objeto Color ou, através de um objeto ColorModel, de uma imagem, de um BufferedImage, ou de um GraphicsDevice. Contem os métodos que transformam cores em um espaço de cor específico para/de sRGB para/de espaço de cores bem definidos de CIEXYZ.

Para os propósitos dos métodos nesta classe, as cores são representadas como arrays de componentes das cores, representadas como números de ponto flutuante em uma escala normalizada definida por cada ColorSpace. Para muitos ColorSpaces (por exemplo sRGB), esta escala é de 0.0 a 1.0. Entretanto, alguns ColorSpaces têm componentes com valores em uma escala diferente. Existem métodos fornecidos para requerer junto ao componente, os valores mínimo e máximo normalizados.

Diversas variáveis são definidas com a finalidade de referenciar os tipos de espaço de cor (por exemplo TYPE_RGB, TYPE_XYZ, etc.) e para referenciar aos espaços de cor específicos (por exemplo CS_sRGB e CS_CIEXYZ). O sRGB é um espaço de cor padrão proposto para RGB. Para mais informação, ver http://www.w3.org/pub/WWW/Graphics/Color/sRGB.html .

A finalidade dos métodos de transformação para/do espaço de cor bem definido de CIEXYZ é para suportar conversões entre dois espaços de cor em um grau razoavelmente elevado de precisão. Espera-se que execuções particulares das subclasses de ColorSpace (por exemplo ICC_ColorSpace) suportem a conversão com elevado desempenho baseada em sistemas de gerenciamento básico de cores da plataforma.

O espaço de CS_CIEXYZ usado pelos métodos de toCIEXYZ/fromCIEXYZ pode ser descrito como se segue:

      CIEXYZ
      luminosidade de visão(illuminance): 200 lux
      ponto branco de visão(viewing white point): CIE D50
      ponto branco da mídia(media white point): "isso para um difusor refletindo perfeitamente" -- D50 
      ponto preto da mídia(media black point): 0 de luz ou 0 de reflexão
      índice solar(flare): 1 porcento
      equilíbrio cromático(surround): 20 porcento de ponto branco da mídia
      descrição de mídia: impressão de reflexão (i.e., RLAB, buscar observação da mídia)
      nota: Para os desenvolvedores que criam um perfil ICC para este
            espaço de conversão, o seguinte é aplicável. Usar uma simples
            adaptação de ponto branco de Von Kries guardada numa matriz
            de parâmetros 3x3 e guardar os efeitos de índice solar (flare)
            e equilíbrio cromático (surround) em três tabelas de pesquisa
            unidimensionais (supondo um uso mínimo de modelos para monitores).

See Also:

ICC_ColorSpace, Serialized Form

Field Summary

static int	CS_CIEXYZ A converção do espaço de cor CIEXYZ é definido acima.
static int	CS_GRAY O espaço de cor interno de escala de cinzas.
static int	CS_LINEAR_RGB Um espaço de cor linear RGB internO.
static int	CS_PYCC A converção do espaço de cor Photo YCC.
static int	CS_sRGB O espaço de cor sRGB é definido em http://www.w3.org/pub/WWW/Graphics/Color/sRGB.html .
static int	TYPE_2CLR 2 componentes genéricos do espaço de cor.
static int	TYPE_3CLR 3 componentes genéricos do espaço de cor.
static int	TYPE_4CLR 4 componentes genéricos do espaço de cor.
static int	TYPE_5CLR 5 componentes genéricos do espaço de cor.
static int	TYPE_6CLR 6 componentes genéricos do espaço de cor.
static int	TYPE_7CLR 7 componentes genéricos do espaço de cor.
static int	TYPE_8CLR 8 componentes genéricos do espaço de cor.
static int	TYPE_9CLR 9 componentes genéricos do espaço de cor.
static int	TYPE_ACLR 10 componentes genéricos do espaço de cor.
static int	TYPE_BCLR 11 componentes genéricos do espaço de cor.
static int	TYPE_CCLR 12 componentes genéricos do espaço de cor.
static int	TYPE_CMY Qualquer espaço de cor da família CMY.
static int	TYPE_CMYK Qualquer espaço de cor da família CMYK.
static int	TYPE_DCLR 13 componentes genéricos do espaço de cor.
static int	TYPE_ECLR 14 componentes genéricos do espaço de cor.
static int	TYPE_FCLR 15 componentes genéricos do espaço de cor.
static int	TYPE_GRAY Qualquer espaço de cor da família GRAY.
static int	TYPE_HLS Qualquer espaço de cor da família HLS.
static int	TYPE_HSV Qualquer espaço de cor da família HSV.
static int	TYPE_Lab Qualquer espaço de cor da família Lab.
static int	TYPE_Luv Qualquer espaço de cor da família Luv.
static int	TYPE_RGB Qualquer espaço de cor da família RGB.
static int	TYPE_XYZ Qualquer espaço de cor da família XYZ.
static int	TYPE_YCbCr Qualquer espaço de cor da família YCbCr.
static int	TYPE_Yxy Qualquer espaço de cor da família Yxy.

Constructor Summary

protected

ColorSpace(int type, int numcomponents) Constrói um objeto ColorSpace dado um tipo de espaço de cor e o número de componentes.

Method Summary

abstract float[]	fromCIEXYZ(float[] colorvalue) Transforma um valor de cor adotado para estar no espaço de cor de conversão CS_CIEXYZ neste ColorSpace.
abstract float[]	fromRGB(float[] rgbvalue) Transforma um valor de cor adotado para estar no padrão do espaço de cor CS_sRGB em um valor deste ColorSpace.
static ColorSpace	getInstance(int colorspace) Retorna um ColorSpace que representa um dos espaços de cor específicos predefinidos.
float	getMaxValue(int component) Retorna o valor máximo normalizado do componente da cor para o componente especificado.
float	getMinValue(int component) Retorna o valor mínimo normalizado do componente da cor para o componente especificado.
String	getName(int idx) Retorna o nome do componente dado o índice de componente.
int	getNumComponents() Retorna o número de componentes para este ColorSpace
int	getType() Retorna o tipo de espaço de cor deste ColorSpace (por exemplo TYPE_RGB, TYPE_XYZ,…).
boolean	isCS_sRGB() Retorna verdadeiro se o ColorSpace é CS_sRGB.
abstract float[]	toCIEXYZ(float[] colorvalue) Transforma um valor de cor adotado para estar neste ColorSpace num valor de conversão do espaço de cor CS_CIEXYZ.
abstract float[]	toRGB(float[] colorvalue) Transforma um valor de cor adotado para estar neste ColorSpace em um valor padrão do espaço de cor CS_sRGB.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TYPE_XYZ

public static final int TYPE_XYZ

Qualquer espaço de cor da família XYZ.

See Also:

Constant Field Values

TYPE_Lab

public static final int TYPE_Lab

Qualquer espaço de cor da família Lab.

See Also:

Constant Field Values

TYPE_Luv

public static final int TYPE_Luv

Qualquer espaço de cor da família Luv.

See Also:

Constant Field Values

TYPE_YCbCr

public static final int TYPE_YCbCr

Qualquer espaço de cor da família YCbCr.

See Also:

Constant Field Values

TYPE_Yxy

public static final int TYPE_Yxy

Qualquer espaço de cor da família Yxy.

See Also:

Constant Field Values

TYPE_RGB

public static final int TYPE_RGB

Qualquer espaço de cor da família RGB.

See Also:

Constant Field Values

TYPE_GRAY

public static final int TYPE_GRAY

Qualquer espaço de cor da família GRAY.

See Also:

Constant Field Values

TYPE_HSV

public static final int TYPE_HSV

Qualquer espaço de cor da família HSV.

See Also:

Constant Field Values

TYPE_HLS

public static final int TYPE_HLS

Qualquer espaço de cor da família HLS.

See Also:

Constant Field Values

TYPE_CMYK

public static final int TYPE_CMYK

Qualquer espaço de cor da família CMYK.

See Also:

Constant Field Values

TYPE_CMY

public static final int TYPE_CMY

Qualquer espaço de cor da família CMY.

See Also:

Constant Field Values

TYPE_2CLR

public static final int TYPE_2CLR

2 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_3CLR

public static final int TYPE_3CLR

3 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_4CLR

public static final int TYPE_4CLR

4 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_5CLR

public static final int TYPE_5CLR

5 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_6CLR

public static final int TYPE_6CLR

6 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_7CLR

public static final int TYPE_7CLR

7 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_8CLR

public static final int TYPE_8CLR

8 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_9CLR

public static final int TYPE_9CLR

9 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_ACLR

public static final int TYPE_ACLR

10 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_BCLR

public static final int TYPE_BCLR

11 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_CCLR

public static final int TYPE_CCLR

12 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_DCLR

public static final int TYPE_DCLR

13 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_ECLR

public static final int TYPE_ECLR

14 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

TYPE_FCLR

public static final int TYPE_FCLR

15 componentes genéricos do espaço de cor.

See Also:

Constant Field Values

CS_sRGB

public static final int CS_sRGB

O espaço de cor sRGB é definido em http://www.w3.org/pub/WWW/Graphics/Color/sRGB.html .

See Also:

Constant Field Values

CS_LINEAR_RGB

public static final int CS_LINEAR_RGB

Um espaço de cor linear RGB internO. Este espaço é baseado nas mesmas cores primárias de RGB assim como CS_sRGB, mas têm uma curva de reprodução linear dos tons.

See Also:

Constant Field Values

CS_CIEXYZ

public static final int CS_CIEXYZ

A converção do espaço de cor CIEXYZ é definido acima.

See Also:

Constant Field Values

CS_PYCC

public static final int CS_PYCC

A converção do espaço de cor Photo YCC.

See Also:

Constant Field Values

CS_GRAY

public static final int CS_GRAY

O espaço de cor interno de escala de cinzas.

See Also:

Constant Field Values

Constructor Detail

ColorSpace

protected ColorSpace(int type,
                     int numcomponents)

Constrói um objeto ColorSpace dado um tipo de espaço de cor e o número de componentes.

Parameters:

type - um dos tipos de ColorSpace constantes

numcomponents - o número de componentes do espaço de cor

Method Detail

getInstance

public static ColorSpace getInstance(int colorspace)

Retorna um ColorSpace que representa um dos espaços de cor específicos predefinidos.

Parameters:

colorspace - um espaço de cor específico identificado pelas constantes de classe predefinidas (por exemplo CS_sRGB, CS_LINEAR_RGB, CS_CIEXYZ, CS_GRAY, ou CS_PYCC)

Returns:

retorna o objeto ColorSpace requisitado

isCS_sRGB

public boolean isCS_sRGB()

Retorna verdadeiro se o ColorSpace é CS_sRGB.

Returns:

true se este for um espaço de cor CS_sRGB, false se não for

toRGB

public abstract float[] toRGB(float[] colorvalue)

Transforma um valor de cor adotado para estar neste ColorSpace em um valor padrão do espaço de cor CS_sRGB.

Este método transforma valores de cor usando algoritmos projetados para produzir o melhor percentual entre a entrada e a saída das cores. A fim de realizar a conversão colorimétrica dos valores de cor, você deve usar o toCIEXYZ, método deste espaço de cor, para primeiro converter do espaço de cor de entrada para o espaço de cor CS_CIEXYZ, e então usar o método fromCIEXYZ do espaço de cor CS_sRGB para converter de CS_CIEXYZ ao espaço de cor de saída. See toCIEXYZ and fromCIEXYZ for further information.

Parameters:

colorvalue - um array de números de ponto flutuante, cujo comprimento é de pelo menos, o número dos componentes neste ColorSpace

Returns:

um array de números de ponto flutuantes de comprimento 3

Throws:

ArrayIndexOutOfBoundsException - se o comprimento do array não for de pelo menos o número dos componentes neste ColorSpace

fromRGB

public abstract float[] fromRGB(float[] rgbvalue)

Transforma um valor de cor adotado para estar no padrão do espaço de cor CS_sRGB em um valor deste ColorSpace.

Este método transforma valores de cor usando algoritmos projetados para produzir o melhor percentual entre a entrada e a saída das cores. A fim de realizar a conversão colorimétrica dos valores de cor, você deve usar o toCIEXYZ, método do espaço de cor CS_sRGB, para primeiro converter do espaço de cor de entrada para o espaço de cor CS_CIEXYZ, e então usar o método fromCIEXYZ do espaço de cor para converter de CS_CIEXYZ ao espaço de cor de saída. See toCIEXYZ and fromCIEXYZ for further information.

Parameters:

rgbvalue - um array de números de ponto flutuante com comprimento de pelo menos 3

Returns:

um array de números de ponto flutuante com o comprimento igual ao número dos componentes deste ColorSpace

Throws:

ArrayIndexOutOfBoundsException - se o comprimento do array não for de pelo menos 3

toCIEXYZ

public abstract float[] toCIEXYZ(float[] colorvalue)

Transforma um valor de cor adotado para estar neste ColorSpace num valor de conversão do espaço de cor CS_CIEXYZ.

Este método transforma valores de cor usando colorimetria relativa, como definido pelo padrão do International Color Consortium. Isto significa que os valores de XYZ retornados por este método são representações relativas ao ponto branco D50 do espaço de cor CS_CIEXYZ. Esta respresentação é útil nas duas etapas do processo de conversão em que as cores são transformadas de um espaço de cor da entrada CS_CIEXYZ e então para o espaço de cor da saída. Esta respresentação não é a mesma dos valores XYZ que seriam medidos com o valor de cor obtido por um colorímetro. Uma transformação adicional é necessária para computar os valores de XYZ que seriam medidos usando práticas atuais recomendadas pelo CIE. See the toCIEXYZ method of ICC_ColorSpace for further information.

Parameters:

colorvalue - um array de números de ponto flutuante com comprimento de pelo menos o número dos componentes neste ColorSpace

Returns:

um array de números de ponto flutuante com o comprimento 3

Throws:

ArrayIndexOutOfBoundsException - se o comprimento do array não for de pelo menos o número dos componentes neste ColorSpace.

fromCIEXYZ

public abstract float[] fromCIEXYZ(float[] colorvalue)

Transforma um valor de cor adotado para estar no espaço de cor de conversão CS_CIEXYZ neste ColorSpace.

Este método transforma valores de cor usando colorimetria relativa, como definido pelo padrão do International Color Consortium. Isto significa que os valores de XYZ retornados por este método são representações relativas ao ponto branco D50 do espaço de cor CS_CIEXYZ. Esta respresentação é útil nas duas etapas do processo de conversão em que as cores são transformadas de um espaço de cor da entrada CS_CIEXYZ e então para o espaço de cor da saída. Os valores de cor retornados por este método não são aqueles que produziriam os valores XYZ passados ao método quando medidos por um colorímetro. Se você tiver valores XYZ correspondentes às medidas feitas usando as práticas atuais recomendadas pelo CIE, elas devem ser convertidas aos valores relativos D50 antes de serem passadas a este método. See the fromCIEXYZ method of ICC_ColorSpace for further information.

Parameters:

colorvalue - um array de números de ponto flutuante com comprimento de pelo menos 3

Returns:

um array de números de ponto flutuante com o comprimento igual ao número dos componentes deste ColorSpace

Throws:

ArrayIndexOutOfBoundsException - se o comprimento do array não for de pelo menos 3

getType

public int getType()

Retorna o tipo de espaço de cor deste ColorSpace (por exemplo TYPE_RGB, TYPE_XYZ,…). O tipo define o número de componentes do espaço de cor e a interpretação, por exemplo TYPE_RGB identifica um espaço de cor com os três componentes - vermelhos, verdes, e o azul. Não define a característica particular do espaço de cor, por exemplo a cromaticidade das cores primárias.

Returns:

o tipo constante que representa o tipo deste ColorSpace

getNumComponents

public int getNumComponents()

Retorna o número de componentes para este ColorSpace

Returns:

O número de componentes para este ColorSpace.

getName

public String getName(int idx)

Retorna o nome do componente dado o índice de componente.

Parameters:

idx - o índice de componente

Returns:

o nome do componente no índice especificado

Throws:

IllegalArgumentException - se idx for menor que 0 ou maior que numComponents - 1

getMinValue

public float getMinValue(int component)

Retorna o valor mínimo normalizado do componente da cor para o componente especificado. A execução padrão desta classe abstrata retorna 0.0 para todos os componentes. As Subclasses devem sobrescrever este método se necessário.

Parameters:

component - o índice de componente

Returns:

o valor mínimo normalizado do componente

Throws:

IllegalArgumentException - se o componente for menor que 0 ou maior que numComponents - 1

Since:

1.4

getMaxValue

public float getMaxValue(int component)

Retorna o valor máximo normalizado do componente da cor para o componente especificado. A execução padrão desta classe abstrata retorna 1.0 para todos os componentes. As Subclasses devem sobrescrever este método se necessário.

Parameters:

component - o índice de componente

Returns:

o valor máximo normalizado do componente

Throws:

IllegalArgumentException - se o componente for menor que 0 ou maior que numComponents - 1

Since:

1.4