ColorAdjustLuma-Funktion (shlwapi.h)

Ändert die Leuchtdichte eines RGB-Werts. Farbton und Sättigung sind nicht betroffen.

Syntax

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

Parameter

clrRGB

Typ: COLORREF

Der ursprüngliche RGB-Wert.

n

Typ: int

Die Leuchtdichte in Einheiten von 0,1 Prozent des Gesamtbereichs. Ein Wert von n = 50 entspricht beispielsweise 5 Prozent der maximalen Leuchtdichte.

fScale

Typ: BOOL

Wenn fScale auf TRUE festgelegt ist, gibt n an, um wie viel die aktuelle Luminanz erhöht oder verringert werden soll. Wenn fScale auf FALSE festgelegt ist, gibt n die absolute Leuchtdichte an.

Rückgabewert

Typ: COLORREF

Gibt den geänderten RGB-Wert zurück.

Hinweise

Wenn fScale auf TRUE festgelegt ist, kann n zwischen -1000 und +1000 liegen.

Wenn fScale auf FALSE festgelegt ist, kann n zwischen 0 und 1000 liegen. Verfügbare Leuchtdichtewerte reichen von 0 bis maximal. Wenn der angeforderte Wert negativ ist oder den Höchstwert überschreitet, wird die Leuchtdichte entweder auf 0 (null) bzw. auf den Maximalwert festgelegt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 5.0 oder höher)