ImageAttributes-Funktionen

Windows GDI+ macht eine flache API verfügbar, die aus etwa 600 Funktionen besteht, die in Gdiplus.dll implementiert und in Gdiplusflat.h deklariert werden. Die Funktionen in der GDI+-Flat-API werden von einer Auflistung von etwa 40 C++-Klassen umschlossen. Es wird empfohlen, die Funktionen in der flat-API nicht direkt aufzurufen. Wenn Sie GDI+ aufrufen, sollten Sie dazu die Methoden und Funktionen aufrufen, die von den C++-Wrappern bereitgestellt werden. Microsoft Product Support Services bietet keine Unterstützung für Code, der die Flat-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	Bemerkungen
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 Ressourcen frei, die vom ImageAttributes-Objekt verwendet werden.
GpStatus WINGDIPAPI GdipSetImageAttributesToIdentity(GpImageAttributes *imageattr, ColorAdjustType-Typ)	Status ImageAttributes::SetToIdentity( IN ColorAdjustType type = ColorAdjustTypeDefault )	Legt die Farbanpassungsmatrix einer angegebenen Kategorie auf Identitätsmatrix fest.
GpStatus WINGDIPAPI GdipResetImageAttributes(GpImageAttributes *imageattr, ColorAdjustType-Typ)	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* 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 Flat-Funktion ist ein boolescher Wert, der angibt, ob eine separate Farbanpassung für die durch den 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-ParametersColorMatrixFlagsAltGray ist.
GpStatus WINGDIPAPI GdipSetImageAttributesThreshold(GpImageAttributes *imageattr, ColorAdjustType type, BOOL enableFlag, REAL threshold)	Status ImageAttributes::SetThreshold( IN REAL-Schwellenwert, 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 Flat-Funktion ist ein boolescher Wert, der angibt, ob ein separater Schwellenwert für die durch den Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetThreshold legt enableFlag auf TRUE und ImageAttributes::ClearThresholdauf enableFlag auf FALSE fest. Löscht den Schwellenwert 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 flat-Funktion ist ein boolescher Wert, der angibt, ob ein separates Gamma für die durch den 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 wie vor dem Aufruf der ImageAttributes::SetNoOp-Methode wiederhergestellt zu haben. Der enableFlag-Parameter in der flat-Funktion ist ein boolescher Wert, der angibt, ob eine Farbanpassung für die durch den Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetNoOp legt enableFlag auf TRUE fest, und ImageAttributes::ClearNoOp legt enableFlag auf FALSE fest. Löscht die 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 durch den 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 CMYK-Ausgabekanal cyan-magenta-yellow-black (CMYK) 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 durch den Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetOutputChannel legt enableFlag auf TRUE fest, und ImageAttributes::ClearOutputChannel legt enableFlag auf FALSE fest. Löscht die Ausgabekanaleinstellung cyan-magenta-yellow-black (CMYK) 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 Flat-Funktion ist ein boolescher Wert, der angibt, ob ein separates Ausgabekanalfarbprofil für die durch den 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 Farbrezuordnungstabelle für die durch den Typparameter angegebene Kategorie aktiviert ist. ImageAttributes::SetRemapTable legt enableFlag auf TRUE und ImageAttributes::ClearRemapTableenableFlag 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 clamp = FALSE)	Legt den Umbruchmodus dieses ImageAttributes-Objekts fest.
GpStatus WINGDIPAPI GdipSetImageAttributesICMMode(GpImageAttributes *imageAttr, BOOL on )	Nicht von Wrappermethoden aufgerufen.	Diese Funktion legt eine interne Zustandsvariable auf den wert fest, der durch den on-Parameter angegeben wird. Wenn dieser Wert TRUE ist, wird die Bildfarbverwaltung (Image Color Management, ICM) für die gesamte Farbanpassung verwendet. Wenn der Wert FALSE ist, wird 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)	Nicht von Wrappermethoden aufgerufen.	Legt das CachedBackground-Element eines angegebenen GpImageAttributes-Objekts fest oder löscht es. GDI+ verwendet nicht das CachedBackground-Element, sodass der Aufruf dieser Funktion keine Auswirkungen hat. Der parameter imageattr gibt das GpImageAttributes-Objekt an. Der enableFlag-Parameter gibt an, ob das CachedBackground-Element festgelegt (TRUE) oder gelöscht (FALSE) ist.