Megosztás a következőn keresztül:


A WIC API áttekintése

A Windows Képalkotó összetevő (WIC) egy COM-alapú API-t biztosít a C és a C++-ban való használatra. A WIC API számos képpel kapcsolatos funkciót tesz elérhetővé, többek között a következőket:

  • Beépített kodekek a szabványos webes képformátumokhoz.
  • Beépített támogatás a szabványos metaadat-formátumokhoz.
  • A képpontformátumok széles köre támogatja.
  • Magas színtámogatás; beleértve a 30 bites kiterjesztett tartományt, a 30 bites nagy pontosságot és a 48 bites nagy pontosságot és a széles színtartományú képpontformátumokat.
  • Bővíthető keretrendszer képkódokhoz, képpontformátumokhoz és metaadat-formátumokhoz.

Ez a témakör az alábbi témaköröket tartalmazza.

WIC-fejlécfájlok

A WIC API-k a következő fejléc- és interfészdefiníciós (IDL-) fájlokban vannak definiálva:

Fájl Leírás
wincodec.h Az elsődleges WIC API-k C és C++ verzióit határozza meg.
wincodec.idl Meghatározza az elsődleges WIC-adaptereket.
wincodecsdk.h A metaadatok WIC API-k C és C++ verzióit határozza meg.
wincodecsdk.idl A WIC metaadat-interfészeit határozza meg.
wincodec_proxy.h Meghatározza a WIC proxy exportokat.

 

A WIC használatához az alkalmazásoknak tartalmazniuk kell a wincodec.h és/vagy wincodecsdk.h azonosítót az alkalmazás által igényelt API-tól függően.

Könyvtár fájlok

A WIC-kódtár fájljai:

Fájl Leírás
windowscodecs.lib Importálja a Windows Software Development Kit (SDK) által biztosított kódtárat.
windowscodecs.dll Az operációs rendszer által biztosított készletmegvalósítási kódtár.

 

A WIC API-k csatolásához az alkalmazásnak tartalmaznia kell a windowscodec.lib-et további csatolófüggőségként.

Osztálygyárak

Az alábbi táblázat a WIC API-k által a WIC-összetevők létrehozásához biztosított két COM-osztálygyárat ismerteti.

Gyári felület Leírás
IWICImagingFactory Elsődleges osztálygyár alkalmazásfejlesztéshez WIC-összetevők használatával. Ez a gyár olyan összetevőket hoz létre, mint a képdekódolók, kódolók és adatfolyamok.
IWICComponentFactory WIC-összetevők fejlesztőinek célzott osztálygyár. Az ebből a gyárból létrehozott összetevőket elsősorban a kodek- és metaadatok kezelőjének fejlesztésében használják.

 

Bármelyik osztály-előállító létrehozásához használja a CoCreateInstance COM függvényt. Az alábbi példa a WIC képalkotó gyár létrehozását mutatja be.

// 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)
);

Képalkotó összetevők

A WIC API-k többféle képalkotó összetevőt biztosítanak. Az alábbi táblázat néhány gyakori WIC-összetevőt ismertet. Az elérhető összetevők teljes listájáért tekintse meg WIC-adapterek.

Alkatrésztípus Leírás
Bitmap Egy IWICBitmapSourceírható memóriabeli ábrázolását jelöli.
dekóder A képadatok streamből való dekódolására szolgál olyan formátumba, amely hasznos a képfeldolgozáshoz.
Kódoló Képadatokat ír egy streambe.
Stream Adatok beolvasására és írására szolgál fájlból, hálózati erőforrásból, memóriablokkból stb.
Formátumkonverter Az egyik képpontformátumból a másikba való konvertálásra szolgál.
metaadat-lekérdezésolvasó Kép vagy képkeret metaadatainak olvasására szolgál.
metaadat-lekérdezésíró Metaadatok képre vagy képkeretre való írására szolgál.

 

Lásd még:

hivatkozások

példák és példakódok