Estructura LOGCOLORSPACEA (wingdi.h)

Artículo
11/20/2024

La estructura LOGCOLORSPACE contiene información que define un espacio de color de 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 lcsEndpoints miembro 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 la gama. Este miembro puede ser uno de los siguientes valores.

Valor	Intento	Nombre de ICC	Significado
LCS_GM_ABS_ COLORIMÉTRICO	Cerilla	Colorimétrica absoluta	Mantenga el punto blanco. Haga coincidir los colores con su color más cercano en la gama de destino.
LCS_GM_ NEGOCIO	Gráfico	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_ GRAFISMO	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 usa 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. Normalmente, este miembro se establece en cero, pero se puede usar para establecer el espacio de color como se especifica exactamente según lo especificado por 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 colores de imagen instalable. Si se especifica un perfil de color, todos los demás miembros de esta estructura deben establecerse en valores razonables, aunque los valores no sean completamente precisos.

Observaciones

Al igual que las paletas, pero a diferencia de los lápices y pinceles, se debe pasar un puntero al crear un Objeto 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 colores sRGB. Los lcsEndpoints,lcsGammaRed, lcsGammaGreen, y lcsGammaBlue miembros se usan para describir el espacio de color lógico. El miembro lcsEndpoints es un CIEXYZTRIPLE que contiene los valores x, y y y z del punto de conexión RGB del espacio de color.

El formato de bits DWORD necesario para el lcsGammaRed, lcsGammaGreen, y lcsGammaBlue es un entero de 8,8 enteros fijos desplazados 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 de DWORD de 32 bits es:

00000000nffff000000000000

Siempre 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 el 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	wingdi.h

Consulte también

BITMAPV4HEADER

BITMAPV5HEADER

CMYK

RGB

Compartir a través de