Přehled rozhraní WIC API

Článek
03/14/2025

Komponenta WIC (Windows Imaging Component) poskytuje rozhraní API založené na modelu COM (Component Object Model) pro použití v jazyce C a C++. Rozhraní WIC API zveřejňuje celou řadu funkcí souvisejících s obrázky, mezi které patří:

Integrované kodeky pro standardní formáty webových obrázků
Integrovaná podpora standardních formátů metadat
Podpora široké škály formátů pixelů.
Podpora vysoké barvy; včetně 30bitového rozšířeného rozsahu, 30bitové vysoké přesnosti a 48bitového formátu s vysokou přesností a širokým gamut pixelem.
Rozšiřitelná architektura pro kodeky obrázků, formáty pixelů a formáty metadat.

Toto téma obsahuje následující témata.

soubory hlaviček WIC
soubory knihovny
Tovární třídy
komponenty zobrazení
viz také

Soubory hlaviček WIC

Rozhraní API WIC jsou definována v následující hlavičce a souborech IDL (Interface Definition Language):

Soubor	Popis
wincodec.h	Definuje verze C a C++ primárních rozhraní API WIC.
wincodec.idl	Definuje primární rozhraní WIC.
wincodecsdk.h	Definuje verze C a C++ pro rozhraní API metadat WIC.
wincodecsdk.idl	Definuje rozhraní metadat WIC.
wincodec_proxy.h	Definuje export proxy serveru WIC.

Aby bylo možné používat WIC, musí vaše aplikace obsahovat wincodec.h a/nebo wincodecsdk.h v závislosti na rozhraní API, které vaše aplikace potřebuje.

Soubory knihovny

Soubory knihovny WIC:

Soubor	Popis
windowscodecs.lib	Import knihovny poskytované sadou Windows Software Development Kit (SDK).
windowscodecs.dll	Standardní implementační knihovna poskytovaná operačním systémem.

Pokud chcete propojit rozhraní API WIC, musí vaše aplikace jako další závislost linkeru obsahovat windowscodec.lib.

Továrny tříd

Následující tabulka popisuje dvě továrny tříd COM, které poskytuje rozhraní API WIC pro vytváření komponent WIC.

Rozhraní továrny	Popis
IWICImagingFactory	Objekt pro vytváření primární třídy pro vývoj aplikací pomocí komponent WIC Tato továrna vytváří komponenty, jako jsou dekodéry obrázků, kodéry a datové proudy.
IWICComponentFactory	Objekt pro vytváření tříd určený pro vývojáře komponent WIC. Komponenty vytvořené z této továrny se primárně používají při vývoji kodeků a obslužných rutin metadat.

Chcete-li vytvořit některou z objektů pro vytváření tříd, použijte funkci CoCreateInstance COM. Následující příklad ukazuje vytvoření továrny pro zpracování obrázků WIC.

// Initialize COM
CoInitialize(NULL);

// The factory pointer
IWICImagingFactory *pFactory = NULL;

// Create the COM imaging factory
HRESULT hr = CoCreateInstance(
    CLSID_WICImagingFactory,
    NULL,
    CLSCTX_INPROC_SERVER,
    IID_PPV_ARGS(&pFactory)
);

Součásti pro vytváření obrázků

Rozhraní WIC API poskytují několik typů zobrazovacích komponent. Následující tabulka popisuje některé běžné součásti WIC. Úplný seznam dostupných komponent najdete v tématu rozhraní WIC.

Typ komponenty	Popis
bitmapové	Představuje zapisovatelnou reprezentaci IWICBitmapSource.
dekodéru	Slouží k dekódování dat obrázků z datového proudu do formátu, který je užitečný pro zpracování obrázků.
kodéru	Zapíše data obrázků do datového proudu.
Stream	Slouží ke čtení a zápisu dat ze souboru, síťového prostředku, bloku paměti atd.
převaděče formátu	Slouží k převodu z jednoho pixelového formátu na jiný.
čtečka dotazů metadat	Slouží ke čtení metadat obrázku nebo rámečku obrázku.
zapisovače dotazů metadat	Slouží k zápisu metadat do obrázku nebo rámečku obrázku.

Viz také

Reference

ukázky a příklady kódu

Sdílet prostřednictvím