Метод IWICColorTransform::Initialize (wincodec.h)

Инициализирует IWICColorTransform с помощью IWICBitmapSource и преобразует его из одного объекта IWICColorContext в другой.

Синтаксис

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

Параметры

[in] pIBitmapSource

Тип: IWICBitmapSource*

Источник растрового изображения, используемый для инициализации преобразования цвета.

[in] pIContextSource

Тип: IWICColorContext*

Источник контекста цвета.

[in] pIContextDest

Тип: IWICColorContext*

Назначение контекста цвета.

[in] pixelFmtDest

Тип: REFWICPixelFormatGUID

GUID нужного формата пикселей.

Этот параметр ограничен подмножеством собственных форматов пикселей WIC. См. примечания для списка.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

В настоящее время для параметров pIContextSource и pixelFmtDest поддерживаются следующие форматы:

• GUID_WICPixelFormat8bppGray
• GUID_WICPixelFormat16bppGray
• GUID_WICPixelFormat16bppBGR555
• GUID_WICPixelFormat16bppBGR565
• GUID_WICPixelFormat24bppBGR
• GUID_WICPixelFormat24bppRGB
• GUID_WICPixelFormat32bppBGR
• GUID_WICPixelFormat32bppBGRA
• GUID_WICPixelFormat32bppPBGRA
• GUID_WICPixelFormat32bppPRGBA (Windows 8 и более поздние версии)
• GUID_WICPixelFormat32bppRGBA
• GUID_WICPixelFormat32bppBGR101010
• GUID_WICPixelFormat32bppCMYK
• GUID_WICPixelFormat48bppBGR
• GUID_WICPixelFormat64bppBGRA (Windows 8 и более поздние версии)
• GUID_WICPixelFormat64bppPBGRA (Windows 8 и более поздние версии)
• GUID_WICPixelFormat64bppPRGBA (Windows 8 и более поздние версии)
• GUID_WICPixelFormat64bppRGBA (Windows 8 и более поздние версии)

Чтобы получить правильное поведение преобразования цвета, форматы пикселей ввода и вывода должны быть совместимы с исходным и целевым цветовым профилями. Например, цветной профиль назначения sRGB будет выдавать неверные результаты при использовании с форматом целевого пикселя CMYK.

Примеры

В следующем примере выполняется преобразование цвета из одного IWICColorContext в другой.

    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;

Требования

Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	wincodec.h
Библиотека	Windowscodecs.lib
DLL	Windowscodecs.dll