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.

• File Header WIC
• File Pustaka
• Pabrik Kelas
• Komponen Pencitraan
• Lihat Juga

File Header WIC

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

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.

Pabrik Kelas

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

Komponen Pencitraan

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.

 

Lihat juga

Referensi

Contoh Sampel dan Kode