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. |