Compartir a través de

Función ColorAdjustLuma (shlwapi.h)

  • Artículo

Cambia la luminancia de un valor RGB. El matiz y la saturación no se ven afectados.

Sintaxis

COLORREF ColorAdjustLuma(
  COLORREF clrRGB,
  int      n,
  BOOL     fScale
);

Parámetros

clrRGB

Tipo: COLORREF

Valor RGB inicial.

n

Tipo: int

La luminancia en unidades del 0,1 por ciento del intervalo total. Por ejemplo, un valor de n = 50 corresponde al 5 por ciento de la luminancia máxima.

fScale

Tipo: BOOL

Si fScale se establece en TRUE, n especifica cuánto incrementar o disminuir la luminancia actual. Si fScale se establece en FALSE, n especifica la luminancia absoluta.

Valor devuelto

Tipo: COLORREF

Devuelve el valor RGB modificado.

Comentarios

Si fScale se establece en TRUE, n puede oscilar entre -1000 y +1000.

Si fScale se establece en FALSE, n puede oscilar entre 0 y 1000. Los valores de luminancia disponibles oscilan entre 0 y un máximo. Si el valor solicitado es negativo o supera el máximo, la luminancia se establecerá en cero o en el valor máximo, respectivamente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 5.0 o posterior)