Gambaran Umum WIC API
Komponen Pencitraan Windows (WIC) menyediakan API berbasis Model Objek Komponen (COM) untuk digunakan dalam C dan C++. WIC API memaparkan berbagai fungsionalitas terkait gambar, termasuk:
- Codec bawaan untuk format gambar web standar.
- Dukungan bawaan untuk format metadata standar.
- Berbagai dukungan format piksel.
- Dukungan warna tinggi; termasuk rentang yang diperluas 30-bit, presisi tinggi 30-bit, dan presisi tinggi 48-bit dan format piksel gamut lebar.
- Kerangka kerja yang dapat diperluas untuk codec gambar, format piksel, dan format metadata.
Topik ini berisi topik berikut.
API WIC didefinisikan dalam file header dan Interface Definition Language (IDL) berikut:
File | Deskripsi |
---|---|
wincodec.h | Mendefinisikan versi C dan C++ dari API WIC utama. |
wincodec.idl | Mendefinisikan antarmuka WIC utama. |
wincodecsdk.h | Mendefinisikan versi C dan C++ dari API WIC metadata. |
wincodecsdk.idl | Menentukan antarmuka metadata WIC. |
wincodec_proxy.h | Menentukan ekspor proksi WIC. |
Untuk menggunakan WIC, aplikasi Anda harus menyertakan wincodec.h dan/atau wincodecsdk.h, tergantung pada API yang dibutuhkan aplikasi Anda.
File pustaka WIC:
File | Deskripsi |
---|---|
windowscodecs.lib | Impor pustaka yang disediakan oleh Windows Software Development Kit (SDK). |
windowscodecs.dll | Pustaka implementasi stok yang disediakan oleh sistem operasi. |
Untuk menautkan ke API WIC, aplikasi Anda harus menyertakan windowscodec.lib sebagai dependensi linker tambahan.
Tabel berikut menjelaskan dua pabrik kelas COM yang disediakan WIC API untuk membuat komponen WIC.
Antarmuka Pabrik | Deskripsi |
---|---|
IWICImagingFactory | Pabrik kelas utama untuk pengembangan aplikasi menggunakan komponen WIC. Pabrik ini membuat komponen seperti dekoder gambar, encoder, dan aliran. |
IWICComponentFactory | Pabrik kelas ditargetkan untuk pengembang komponen WIC. Komponen yang dibuat dari pabrik ini terutama digunakan dalam pengembangan penangan codec dan metadata. |
Untuk membuat salah satu pabrik kelas, gunakan fungsi CoCreateInstance COM. Contoh berikut menunjukkan pembuatan pabrik pencitraan 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)
);
API WIC menyediakan beberapa jenis komponen pencitraan. Tabel berikut ini menjelaskan beberapa komponen WIC umum. Untuk daftar lengkap komponen yang tersedia, lihat antarmuka WIC.
Tipe Komponen | Deskripsi |
---|---|
Bitmap | Mewakili representasi dalam memori yang dapat ditulis dari IWICBitmapSource. |
Decoder | Digunakan untuk mendekode data gambar dari aliran ke dalam format yang berguna untuk pemrosesan gambar. |
Encoder | Menulis data gambar ke aliran. |
Stream | Digunakan untuk membaca dan menulis data dari file, sumber daya jaringan, blok memori, dan sebagainya. |
Format Pengonversi | Digunakan untuk mengonversi dari satu format piksel ke format piksel lainnya. |
Pembaca Kueri Metadata | Digunakan untuk membaca metadata gambar atau bingkai gambar. |
Penulis Kueri Metadata | Digunakan untuk menulis metadata ke bingkai gambar atau gambar. |