IWICColorTransform::Initialize-Methode (wincodec.h)

Artikel
08/27/2023

Initialisiert eine IWICColorTransform mit einer IWICBitmapSource und transformiert sie von einem IWICColorContext in eine andere.

Syntax

HRESULT Initialize(
  [in] IWICBitmapSource      *pIBitmapSource,
  [in] IWICColorContext      *pIContextSource,
  [in] IWICColorContext      *pIContextDest,
  [in] REFWICPixelFormatGUID pixelFmtDest
);

Parameter

[in] pIBitmapSource

Typ: IWICBitmapSource*

Die Bitmapquelle, die zum Initialisieren der Farbtransformation verwendet wird.

[in] pIContextSource

Typ: IWICColorContext*

Die Farbkontextquelle.

[in] pIContextDest

Typ: IWICColorContext*

Das Ziel des Farbkontexts.

[in] pixelFmtDest

Typ: REFWICPixelFormatGUID

Die GUID des gewünschten Pixelformats.

Dieser Parameter ist auf eine Teilmenge der nativen WIC-Pixelformate beschränkt. Eine Liste finden Sie unter Hinweise.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die derzeit unterstützten Formate für die Parameter pIContextSource und pixelFmtDest sind:

GUID_WICPixelFormat8bppGray
GUID_WICPixelFormat16bppGray
GUID_WICPixelFormat16bppBGR555
GUID_WICPixelFormat16bppBGR565
GUID_WICPixelFormat24bppBGR
GUID_WICPixelFormat24bppRGB
GUID_WICPixelFormat32bppBGR
GUID_WICPixelFormat32bppBGRA
GUID_WICPixelFormat32bppPBGRA
GUID_WICPixelFormat32bppPRGBA (Windows 8 und höher)
GUID_WICPixelFormat32bppRGBA
GUID_WICPixelFormat32bppBGR101010
GUID_WICPixelFormat32bppCMYK
GUID_WICPixelFormat48bppBGR
GUID_WICPixelFormat64bppBGRA (Windows 8 und höher)
GUID_WICPixelFormat64bppPBGRA (Windows 8 und höher)
GUID_WICPixelFormat64bppPRGBA (Windows 8 und höher)
GUID_WICPixelFormat64bppRGBA (Windows 8 und höher)

Um das richtige Verhalten einer Farbtransformation zu erhalten, müssen die Eingabe- und Ausgabepixelformate mit den Quell- und Zielfarbprofilen kompatibel sein. Beispielsweise führt ein sRGB-Zielfarbprofil zu falschen Ergebnissen, wenn es mit einem CMYK-Zielpixelformat verwendet wird.

Beispiele

Im folgenden Beispiel wird eine Farbtransformation von einem IWICColorContext in eine andere ausgeführt.


    IWICImagingFactory *pFactory = NULL;
    IWICBitmapDecoder *pDecoder = NULL;
    IWICBitmapFrameDecode *pBitmapFrame = NULL;
    IWICColorContext *pContextSrc = NULL;
    IWICColorContext *pContextDst = NULL;
    IWICColorTransform *pColorTransform = NULL;

    UINT uiFrameCount = 0;

    HRESULT hr = CoCreateInstance(
                    CLSID_WICImagingFactory,
                    NULL, CLSCTX_INPROC_SERVER,
                    IID_IWICImagingFactory,
                    (LPVOID*) &pFactory);

    if (SUCCEEDED(hr))
    {
        hr = pFactory->CreateDecoderFromFilename(
                           L"test.jpg",
                           NULL,
                           GENERIC_READ,
                           WICDecodeMetadataCacheOnDemand,
                           &pDecoder);
    }

    if (SUCCEEDED(hr))
    {
        hr = pDecoder->GetFrameCount(&uiFrameCount);
    }

    if (SUCCEEDED(hr) && (uiFrameCount > 0))
    {
        hr = pDecoder->GetFrame(0, &piBitmapFrame);
    }

    if (SUCCEEDED(hr))
    {
        hr = pFactory->CreateColorContext(&pContextSrc);
    }

    if (SUCCEEDED(hr))
    {
        hr = pContextSrc->InitializeFromFilename(
                              L"c:\\windows\\system32\\spool\\drivers\\color\\kodak_dc.icm");
    }

    if (SUCCEEDED(hr))
    {
        hr = pFactory->CreateColorContext(&pContextDst);
    }

    if (SUCCEEDED(hr))
    {
        hr = pContextDst->InitializeFromFilename(
                              L"c:\\windows\\system32\\spool\\drivers\\color\\sRGB Color Space Profile.icm");
    }

    hr = E_FAIL;

    if (SUCCEEDED(hr))
    {
        // Transform from src icm to the destination icm. 
        hr = pColorTransform->Initialize( pBitmapFrame,
                                          pContextSrc,
                                          pContextDst,
                                          GUID_WICPixelFormat32bppBGRA);
    }

    if (SUCCEEDED(hr))
    {
        UINT uiWidth = 0, uiHeight = 0;
        UINT cbStride = 0;
        UINT cbBufferSize = 0;
        BYTE *pbBuffer = NULL; 

        hr = pColorTransform->GetSize(&uiWidth, &uiHeight);

        if (SUCCEEDED(hr))
        {
            WICRect rc = { 0 };
            rc.X = 0;
            rc.Y = 0;
            rc.Width = uiWidth;
            rc.Height = 1; // scanline

            for (UINT i = 0; SUCCEEDED(hr) && (i < uiHeight); i++)
            {
                hr = pColorTransform->CopyPixels(&rc, cbStride, cbBufferSize - (rc.Y * cbStride), pbBuffer);
                pbBuffer += cbStride;
                rc.Y += 1;
            }
        }
    }

    if (pFactory)
    {
        pFactory->Release();
    }

    if (pDecoder)
    {
        pDecoder->Release();
    }

    if (pBitmapFrame)
    {
        pBitmapFrame->Release();
    }

    if (pContextSrc)
    {
        pContextSrc->Release();
    }

    if (pContextDst)
    {
        pContextDst->Release();
    }

    if (pColorTransform)
    {
        pColorTransform->Release();
    }

    return hr;

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll

Freigeben über