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

Статья
08/27/2023

Инициализирует преобразователь формата.

Синтаксис

HRESULT Initialize(
  [in] IWICBitmapSource      *pISource,
  [in] REFWICPixelFormatGUID dstFormat,
  [in] WICBitmapDitherType   dither,
  [in] IWICPalette           *pIPalette,
  [in] double                alphaThresholdPercent,
  [in] WICBitmapPaletteType  paletteTranslate
);

Параметры

[in] pISource

Тип: IWICBitmapSource*

Входной растровый рисунок для преобразования

[in] dstFormat

Тип: REFWICPixelFormatGUID

GUID формата пикселей назначения.

[in] dither

Тип: WICBitmapDitherType

WiCBitmapDitherType, используемый для преобразования.

[in] pIPalette

Тип: IWICPalette*

Палитра, используемая для преобразования.

[in] alphaThresholdPercent

Тип: double

Порог альфа-канала, используемый для преобразования.

[in] paletteTranslate

Тип: WICBitmapPaletteType

Тип преобразования палитры, используемый для преобразования.

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

Тип: HRESULT

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

Если у вас нет предопределенной палитры, ее необходимо сначала создать. Используйте InitializeFromBitmap , чтобы создать объект палитры, а затем передайте его вместе с другими параметрами.

Dither, pIPalette, alphaThresholdPercent и paletteTranslate используются для уменьшения потери цвета при преобразовании в формат с уменьшенной битовой глубиной. Для преобразований, которым не требуются эти параметры, следует использовать следующие значения параметров: dither set to WICBitmapDitherTypeNone, pIPalette — NULL, alphaThresholdPercent — 0.0f и paletteTranslate — WICBitmapPaletteTypeCustom.

Для базового алгоритма, используемого при использовании упорядоченного дизера, требуется фиксированная палитра в перечислении WICBitmapPaletteType в определенном порядке.

Часто фактическая палитра, предоставляемая для выходных данных, может иметь другой порядок или небольшое отклонение фактических цветов. Это происходит при использовании палитры Microsoft Windows, которая имеет небольшие различия между версиями Windows.To обеспечить это, палитра и перевод палитры предоставляются преобразователю форматов. PIPalette — это фактически используемая палитра назначения, а paletteTranslate — фиксированная палитра. После завершения преобразования цвета сопоставляются с фиксированной палитрой с фактическими цветами в pIPalette с помощью ближайшего алгоритма сопоставления цветов.

Если цвета в pIPalette не соответствуют цветам в paletteTranslate, сопоставление может привести к нежелательным результатам.

WICBitmapDitherTypeOrdered4x4 может быть полезен при преобразовании форматов из 8-разрядных форматов в 5- или 6-разрядные, так как нет способа точного преобразования цветовых данных.

WICBitmapDitherTypeErrorDiffusion выбирает алгоритм диффузии ошибок и может использоваться с любой палитрой. Если указана произвольная палитра, wiCBitmapPaletteCustom следует передать в качестве paletteTranslate. Диффузия ошибок часто обеспечивает превосходные результаты по сравнению с упорядоченными алгоритмами смешивания, особенно в сочетании с оптимизированной функциональностью создания палитры на IWICPalette.

При преобразовании растрового изображения с альфа-каналом, например PNG, в формат 8bpp альфа-канал обычно игнорируется. Все пиксели, которые были прозрачными в исходном растровом изображении, отображаются как черные в выходных данных, так как прозрачные и черные имеют нулевое значение пикселей в соответствующих форматах.

Некоторые содержимое 8bpp может содержать альфа-цвет; Например, формат GIF позволяет использовать одну запись палитры в качестве прозрачного цвета. Для этого типа содержимого alphaThresholdPercent указывает, какой процент прозрачности должен соответствовать прозрачному цвету. Поскольку альфа-значение прямо пропорционально непрозрачности (не прозрачности) пикселя, alphaThresholdPercent указывает, какой уровень непрозрачности сопоставляется с полностью прозрачным цветом.

Например, значение 9,8 % означает, что любой пиксель с альфа-значением меньше 25 будет сопоставлен с прозрачным цветом. Значение 100 % сопоставляет все непрозрачные пиксели с прозрачным цветом. Обратите внимание, что палитра должна иметь прозрачный цвет. Если это не так, "прозрачный" цвет будет ближайшим к нулю - часто черный.

Примеры

В следующем примере кадр изображения преобразуется в формат 32bppPBGRA без порогового значения dithering или alpha. Direct2D требует, чтобы источники растровых изображений были в формате 32bppPBGRA для отрисовки. Полный пример использования IWICFormatConverter см. в разделе WiC Image Viewer Using Direct2D Sample (Пример средства просмотра изображений WIC с использованием Direct2D).

HRESULT hr = S_OK;

IWICBitmapDecoder *pIDecoder = NULL;
IWICBitmapFrameDecode *pIDecoderFrame  = NULL;
IWICFormatConverter *pIFormatConverter = NULL;

// Create the decoder.
hr = m_pIWICFactory->CreateDecoderFromFilename(
   L"turtle.jpg",                  // Image to be decoded
   NULL,                           // Do not prefer a particular vendor
   GENERIC_READ,                   // Desired read access to the file
   WICDecodeMetadataCacheOnDemand, // Cache metadata when needed
   &pIDecoder                      // Pointer to the decoder
   );

// Retrieve the first bitmap frame.
if (SUCCEEDED(hr))
{
   hr = pIDecoder->GetFrame(0, &pIDecoderFrame);
}


// Create the flip/rotator.
if (SUCCEEDED(hr))
{
   hr = m_pIWICFactory->CreateFormatConverter(&pIFormatConverter);
}

// Initialize the format converter.
if (SUCCEEDED(hr))
{
   hr = pIFormatConverter->Initialize(
       pIDecoderFrame,                  // Input source to convert
       GUID_WICPixelFormat32bppPBGRA,   // Destination pixel format
       WICBitmapDitherTypeNone,         // Specified dither pattern
       NULL,                            // Specify a particular palette 
       0.f,                             // Alpha threshold
       WICBitmapPaletteTypeCustom       // Palette translation type
       );
}
//Create render target and D2D bitmap from IWICBitmapSource
if (SUCCEEDED(hr))
{
   hr = CreateDeviceResources(hWnd);
}

if (SUCCEEDED(hr))
{
   // Need to release the previous D2DBitmap if there is one
   SafeRelease(&m_pD2DBitmap);
   hr = m_pRT->CreateBitmapFromWicBitmap(pIFormatConverter, NULL, &m_pD2DBitmap);
}

SafeRelease(&pIFormatConverter);
SafeRelease(&pIDecoderFrame);
SafeRelease(&pIDecoder);

Требования


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

Поделиться через