IWICBitmapFrameEncode::SetColorContexts-Methode (wincodec.h)

Legt eine angegebene Anzahl von IWICColorContext-Profilen auf den Frame fest.

Syntax

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

Parameter

[in] cCount

Typ: UINT

Die Anzahl der festzulegenden IWICColorContext-Profile .

[in] ppIColorContext

Typ: IWICColorContext**

Ein Zeiger auf einen IWICColorContext-Zeiger , der die Farbkontextprofile enthält, die auf den Frame festgelegt werden sollen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

• BMPDas Festlegen von Farbkontexten wird nicht unterstützt. Diese Funktion gibt WINCODEC_ERR_UNSUPPORTEDOPERATION zurück.
• PNGDas Festlegen von höchstens einem Farbkontext wird unterstützt, und zusätzliche Farbkontexte werden ignoriert. Dieser Kontext muss ein WICColorContextProfile sein und wird zum Codieren der iCCP-, gAMA- und cHRM-Blöcke in der PNG-Datei verwendet.
• JPEG, TIFF, JPEG-XRDas Einrichten von bis zu einem WICColorContextProfile und einem WICColorContextExifColorSpace wird unterstützt. Benutzer dürfen nicht mehr als einen von jedem Farbkontexttyp angeben, da alle Außer des letzten Kontexts jedes Typs ignoriert werden. In JPEG wird das WICColorContextProfile als JPEG APP2 ICC-Metadatenblock codiert.

  In TIFF und JPEG-XR wird wiCColorContextProfile in den IFD ICC-Profilmetadatenblock (IFD-Tag 0x8773) codiert. In allen drei Formaten wird wiCColorContextExifColorSpace in exif colorspace metadata block (EXIF tag 0xA001) codiert.

Anforderungen