Estructura LOGCOLORSPACEA (wingdi.h)

La estructura LOGCOLORSPACE contiene información que define un espacio de color lógico.

Sintaxis

typedef struct tagLOGCOLORSPACEA {
  DWORD         lcsSignature;
  DWORD         lcsVersion;
  DWORD         lcsSize;
  LCSCSTYPE     lcsCSType;
  LCSGAMUTMATCH lcsIntent;
  CIEXYZTRIPLE  lcsEndpoints;
  DWORD         lcsGammaRed;
  DWORD         lcsGammaGreen;
  DWORD         lcsGammaBlue;
  CHAR          lcsFilename[MAX_PATH];
} LOGCOLORSPACEA, *LPLOGCOLORSPACEA;

Miembros

lcsSignature

Firma de espacio de color. En la actualidad, este miembro siempre debe establecerse en LCS_SIGNATURE.

lcsVersion

Número de versión; debe ser 0x400.

lcsSize

Tamaño de esta estructura, en bytes.

lcsCSType

Tipo de espacio de color. El miembro puede ser uno de los siguientes valores.

Valor	Significado
LCS_CALIBRATED_RGB	Los valores de color son valores RGB calibrados. Los valores se traducen mediante los puntos de conexión especificados por el miembro lcsEndpoints antes de pasarse al dispositivo.
LCS_sRGB	Los valores de color son valores sRGB.
LCS_WINDOWS_COLOR_SPACE	Los valores de color son valores de color predeterminados de Windows.

 

Si no se especifica LCS_CALIBRATED_RGB, se omite el miembro lcsEndpoints .

lcsIntent

Método de asignación de gama. Este miembro puede ser uno de los siguientes valores.

Value	Intención	Nombre de ICC	Significado
LCS_GM_ABS_   COLORIMÉTRICO	Match	Colorimétrica absoluta	Mantenga el punto blanco. Coincide con los colores con su color más cercano en la gama de destino.
LCS_GM_   NEGOCIO	Graphic	Saturación	Mantener la saturación. Se usa para gráficos empresariales y otras situaciones en las que se requieren colores no unidos.
LCS_GM_   GRÁFICOS	Prueba	Colorimétrica relativa	Mantenga la coincidencia de colorimétrica. Se usa para diseños gráficos y colores con nombre.
LCS_GM_   IMÁGENES	Imagen	Perceptivo	Mantenga el contraste. Se utiliza para fotografías e imágenes naturales.

lcsEndpoints

Puntos de conexión rojos, verdes y azules.

lcsGammaRed

Escala de la coordenada roja.

lcsGammaGreen

Escala de la coordenada verde.

lcsGammaBlue

Escala de la coordenada azul.

lcsFilename[MAX_PATH]

Cadena terminada en null que asigna un nombre a un archivo de perfil de color. Este miembro se establece normalmente en cero, pero se puede usar para establecer el espacio de colores en exactamente como se especifica en el perfil de color. Esto es útil para los dispositivos que introducen valores de color para una impresora específica o cuando se usa un buscador de coincidencias de color de imagen instalable. Si se especifica un perfil de color, todos los demás miembros de esta estructura deben establecerse en valores razonables, incluso si los valores no son completamente precisos.

Comentarios

Al igual que las paletas, pero a diferencia de los lápices y pinceles, se debe pasar un puntero al crear un LogColorSpace.

Si el miembro lcsCSType se establece en LCS_sRGB o LCS_WINDOWS_COLOR_SPACE, se omiten los demás miembros de esta estructura y WCS usa el espacio de color sRGB. Los miembros lcsEndpoints,lcsGammaRed, lcsGammaGreen y lcsGammaBlue se usan para describir el espacio de color lógico. El miembro lcsEndpoints es un CIEXYZTRIPLE que contiene los valores x, y y z del punto de conexión RGB del espacio de colores.

El formato de bits DWORD necesario para lcsGammaRed, lcsGammaGreen y lcsGammaBlue es un entero de 8,8 puntos fijos desplazados a la izquierda por 8 bits. Esto significa que 8 bits enteros van seguidos de 8 bits de fracción. Teniendo en cuenta el cambio de bits, el formato necesario del DWORD de 32 bits es:

00000000nffff00000000000

Cada vez que el miembro lcsFilename contiene un nombre de archivo y el miembro lcsCSType se establece en LCS_CALIBRATED_RGB, WCS omite los demás miembros de esta estructura. Usa el espacio de color en el archivo como espacio de color al que hace referencia esta estructura LOGCOLORSPACE .

La relación entre los valores de tri-estímulo X,Y,Z y los valores de cromática x,y,z es la siguiente:

x = X/(X+Y+Z)

y = Y/(X+Y+Z)

z = Z/(X+Y+Z)

Si el miembro lcsCSType se establece en LCS_sRGB o LCS_WINDOWS_COLOR_SPACE, se omiten los demás miembros de esta estructura y ICM usa el espacio de colores sRGB. Las aplicaciones todavía deben inicializar el resto de la estructura, ya que CreateProfileFromLogColorSpace omite el miembro lcsCSType y usa lcsEndpoints, lcsGammaRed, lcsGammaGreen, lcsGammaBlue miembros para crear un perfil, que puede no inicializarse en caso de espacios de color LCS_sRGB o LCS_WINDOWS_COLOR_SPACE.

Nota

El encabezado wingdi.h define LOGCOLORSPACE como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	wingdi.h

Consulte también

BITMAPV4HEADER

BITMAPV5HEADER

CMYK

RGB