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
- Könyvtárfájlok
- Osztálygyárak
- képalkotó összetevők
- Lásd még:
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: