ImageAttributes-Funktionen

Windows GDI+ macht eine flache API verfügbar, die aus ca. 600 Funktionen besteht, die in Gdiplus.dll implementiert und in Gdiplusflat.h deklariert werden. Die Funktionen in der GDI+-API werden von einer Sammlung von ca. 40 C++-Klassen umschlossen. Es wird empfohlen, die Funktionen in der flachen API nicht direkt auf aufruft. Wenn Sie Aufrufe von GDI+, sollten Sie dazu die Methoden und Funktionen aufrufen, die von den C++-Wrappern bereitgestellt werden. Der Microsoft-Produktsupport bietet keine Unterstützung für Code, der die flache API direkt aufruft. Weitere Informationen zur Verwendung dieser Wrappermethoden finden Sie unter GDI+ Flat-API.

Die folgenden flachen API-Funktionen werden von der C++-Klasse ImageAttributes umschlossen.

ImageAttributes-Funktionen und entsprechende Wrappermethoden

Flat-Funktion Wrappermethode Hinweise
GpStatus WINGDIPAPI GdipCreateImageAttributes(GpImageAttributes * * imageattr)
ImageAttributes::ImageAttributes() Erstellt ein ImageAttributes-Objekt.
GpStatus WINGDIPAPI GdipCloneImageAttributes(GDIPCONST GpImageAttributes * imageattr, GpImageAttributes * * cloneImageattr)
ImageAttributes * ImageAttributes::Clone() const Erstellt eine Kopie dieses ImageAttributes-Objekts.
GpStatus WINGDIPAPI GdipDisposeImageAttributes(GpImageAttributes * imageattr)
ImageAttributes::~ImageAttributes() Gibt vom ImageAttributes-Objekt verwendete Ressourcen frei.
GpStatus WINGDIPAPI GdipSetImageAttributesToIdentity(GpImageAttributes * imageattr, ColorAdjustType type)
Status ImageAttributes::SetToIdentity( IN ColorAdjustType type = ColorAdjustTypeDefault ) Legt die Farbanpassungsmatrix einer angegebenen Kategorie auf identitätsmatrix fest.
GpStatus WINGDIPAPI GdipResetImageAttributes(GpImageAttributes * imageattr, ColorAdjustType type)
Status ImageAttributes::Reset( IN ColorAdjustType type = ColorAdjustTypeDefault ) Legt die Farbanpassungsmatrix einer angegebenen Kategorie auf identitätsmatrix fest.
GpStatus WINGDIPAPI GdipSetImageAttributesColorMatrix(GpImageAttributes * imageattr, ColorAdjustType type, BOOL enableFlag, GDIPCONST ColorMatrix * colorMatrix, GDIPCONST * ColorMatrix grayMatrix, ColorMatrixFlags flags)
Status ImageAttributes::SetColorMatrix( IN const ColorMatrix * colorMatrix, IN ColorMatrixFlags mode = ColorMatrixFlagsDefault, IN ColorAdjustType type = ColorAdjustTypeDefault )Status ImageAttributes::ClearColorMatrix(IN ColorAdjustType type = ColorAdjustTypeDefault) Legt die Farbanpassungsmatrix für eine angegebene Kategorie fest. Der enableFlag-Parameter in der flachen Funktion ist ein boolescher Wert, der angibt, ob eine separate Farbanpassung für die vom Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetColorMatrix legt enableFlag auf TRUE fest, und ImageAttributes::ClearColorMatrix legt enableFlag auf FALSE fest.
Löscht die Farbanpassungsmatrix für eine angegebene Kategorie. Der grayMatrix-Parameter gibt eine Matrix an, die zum Anpassen von Graustufen verwendet werden soll, wenn der Wert des flags-Parameters "ColorMatrixFlagsAltGray" ist.
GpStatus WINGDIPAPI GdipSetImageAttributesThreshold(GpImageAttributes * imageattr, ColorAdjustType type, BOOL enableFlag, REAL threshold)
Status ImageAttributes::SetThreshold( IN REAL threshold, IN ColorAdjustType type = ColorAdjustTypeDefault )
Status ImageAttributes::ClearThreshold(IN ColorAdjustType type = ColorAdjustTypeDefault)
Legt den Schwellenwert (Transparenzbereich) für eine angegebene Kategorie fest.
Der enableFlag-Parameter in der flachen Funktion ist ein boolescher Wert, der angibt, ob ein separater Schwellenwert für die vom Typparameter angegebene Kategorie aktiviert wird. ImageAttributes::SetThreshold legt enableFlag auf TRUE fest, und ImageAttributes::ClearThreshold legt enableFlag auf FALSE fest. Löschen des Schwellenwerts für eine angegebene Kategorie.
GpStatus WINGDIPAPI GdipSetImageAttributesGamma(GpImageAttributes * imageattr, ColorAdjustType type, BOOL enableFlag, REAL gamma)
Status ImageAttributes::SetGamma(IN REAL gamma, IN ColorAdjustType type = ColorAdjustTypeDefault)
Status ImageAttributes::ClearGamma(IN ColorAdjustType type = ColorAdjustTypeDefault)
Legt den Gammawert für eine angegebene Kategorie fest. Der enableFlag-Parameter in der flachen Funktion ist ein boolescher Wert, der angibt, ob ein separates Gamma für die vom Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetGamma legt enableFlag auf TRUE fest, und ImageAttributes::ClearGamma legt enableFlag auf FALSE fest.
Deaktiviert die Gammakorrektur für eine angegebene Kategorie.
GpStatus WINGDIPAPI GdipSetImageAttributesNoOp(GpImageAttributes * imageattr, ColorAdjustType type, BOOL enableFlag)
Status ImageAttributes::SetNoOp( IN ColorAdjustType type = ColorAdjustTypeDefault )
Status ImageAttributes::ClearNoOp(IN ColorAdjustType type = ColorAdjustTypeDefault)
Deaktiviert die Farbanpassung für eine angegebene Kategorie. Sie können die ImageAttributes::ClearNoOp-Methode aufrufen, um die Farbanpassungseinstellungen erneut zu aktivieren, die vor dem Aufruf der ImageAttributes::SetNoOp-Methode eingerichtet wurden. Der enableFlag-Parameter in der flachen Funktion ist ein boolescher Wert, der angibt, ob eine Farbanpassung für die vom Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetNoOp legt enableFlag auf TRUE fest, und ImageAttributes::ClearNoOp legt enableFlag auf FALSE fest.
Löschen der NoOp-Einstellung für eine angegebene Kategorie.
GpStatus WINGDIPAPI GdipSetImageAttributesColorKeys(GpImageAttributes * imageattr, ColorAdjustType type, BOOL enableFlag, ARGB colorLow, ARGB colorHigh)
Status ImageAttributes::SetColorKey( IN const Color& colorLow, IN const Color& colorHigh, IN ColorAdjustType type = ColorAdjustTypeDefault )
Status ImageAttributes::ClearColorKey(IN ColorAdjustType type = ColorAdjustTypeDefault)
Legt den Colorkey (Transparenzbereich) für eine angegebene Kategorie fest. Der enableFlag-Parameter in der flat-Funktion ist ein boolescher Wert, der angibt, ob ein separater Transparenzbereich für die vom Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetColorKey legt enableFlag auf TRUE fest, und ImageAttributes::ClearColorKey legt enableFlag auf FALSE fest.
Löscht den Colorkey (Transparenzbereich) für eine angegebene Kategorie.
GpStatus WINGDIPAPI GdipSetImageAttributesOutputChannel(GpImageAttributes * imageattr, ColorAdjustType type, BOOL enableFlag, ColorChannelFlags channelFlags)
Status ImageAttributes::SetOutputChannel( IN ColorChannelFlags channelFlags, IN ColorAdjustType type = ColorAdjustTypeDefault )
Status ImageAttributes::ClearOutputChannel(IN ColorAdjustType type = ColorAdjustTypeDefault)
Legt den cyan-magenta-yellow-black (CGENUTZT)-Ausgabekanal für eine angegebene Kategorie fest. Der enableFlag-Parameter in der flat-Funktion ist ein boolescher Wert, der angibt, ob ein separater Ausgabekanal für die vom Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetOutputChannel legt enableFlag auf TRUE fest, und ImageAttributes::ClearOutputChannel legt enableFlag auf FALSE fest.
Clears the cyan-magenta-yellow-black (CYAN) output channel setting for a specified category. ( Clears the cyan-magenta-yellow-black (CYAN)-Ausgabekanaleinstellung für eine angegebene Kategorie.
GpStatus WINGDIPAPI GdipSetImageAttributesOutputChannelColorProfile(GpImageAttributes * imageattr, ColorAdjustType type, BOOL enableFlag, GDIPCONST WCHAR * colorProfileFilename)
Status ImageAttributes::SetOutputChannelColorProfile( IN const WCHAR * colorProfileFilename, IN ColorAdjustType type = ColorAdjustTypeDefault )
Status ImageAttributes::ClearOutputChannelColorProfile(IN ColorAdjustType type = ColorAdjustTypeDefault)
Legt die Ausgabekanal-Farbprofildatei für eine angegebene Kategorie fest. Der enableFlag-Parameter in der flachen Funktion ist ein boolescher Wert, der angibt, ob ein separates Ausgabekanalfarbprofil für die vom Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetOutputChannelColorProfile legt enableFlag auf TRUE fest, und ImageAttributes::ClearOutputChannelColorProfile legt enableFlag auf FALSE fest.
Löscht die Einstellung des Ausgabekanal-Farbprofils für eine angegebene Kategorie.
GpStatus WINGDIPAPI GdipSetImageAttributesRemapTable(GpImageAttributes * imageattr, ColorAdjustType type, BOOL enableFlag, UINT mapSize, GDIPCONST ColorMap * map)
Status ImageAttributes::SetRemapTable( IN UINT mapSize, IN const ColorMap * map, IN ColorAdjustType type = ColorAdjustTypeDefault )
Status ImageAttributes::ClearRemapTable(IN ColorAdjustType type = ColorAdjustTypeDefault)
Legt die Farbumwandlungstabelle für eine angegebene Kategorie fest. Der enableFlag-Parameter in der flat-Funktion ist ein boolescher Wert, der angibt, ob eine separate Farbzuordnungstabelle für die kategorie aktiviert ist, die vom Typparameter angegeben wird. ImageAttributes::SetRemapTable legt enableFlag auf TRUE fest, und ImageAttributes::ClearRemapTable legt enableFlag auf FALSE fest.
Löscht die Farbumwandlungstabelle für eine angegebene Kategorie.
GpStatus WINGDIPAPI GdipSetImageAttributesWrapMode(GpImageAttributes * imageAttr, WrapMode wrap, ARGB argb, BOOL clamp )
Status ImageAttributes::SetWrapMode(IN WrapMode wrap, IN const Color& color = Color(), IN BOOL-Klammer = FALSE)
Legt den Wrap-Modus dieses ImageAttributes-Objekts fest.
GpStatus WINGDIPAPI GdipSetImageAttributesICMMode(GpImageAttributes * imageAttr, BOOL on )
Wird nicht von Wrappermethoden aufgerufen.
Diese Funktion legt eine interne Zustandsvariable auf den Wert fest, der vom on-Parameter angegeben wird. Wenn dieser Wert TRUE ist, wird die Bildfarbverwaltung (ICM) für alle Farbanpassungen verwendet. Wenn der Wert FALSE ist, ICM nicht verwendet.
GpStatus WINGDIPAPI GdipGetImageAttributesAdjustedPalette(GpImageAttributes * imageAttr, ColorPalette * colorPalette, ColorAdjustType colorAdjustType )
Status ImageAttributes::GetAdjustedPalette(IN OUT ColorPalette * colorPalette, IN ColorAdjustType colorAdjustType) const
Passt die Farben in einer Palette entsprechend den Anpassungseinstellungen einer angegebenen Kategorie an.
GpStatus WINGDIPAPI GdipSetImageAttributesCachedBackground(GpImageAttributes * imageattr, BOOL enableFlag)
Wird nicht von Wrappermethoden aufgerufen.
Legt den CachedBackground-Member eines angegebenen GpImageAttributes-Objekts fest oder entfernt es. GDI+ cachedBackground-Member nicht verwendet, sodass der Aufruf dieser Funktion keine Auswirkungen hat. Der imageattr-Parameter gibt das GpImageAttributes-Objekt an. Der enableFlag-Parameter gibt an, ob der CachedBackground-Member festgelegt (TRUE) oder leer (FALSE) ist.