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

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 Mendefinisikan 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 kit pengembangan perangkat lunak (SDK) Windows.
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 API WIC 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 menjelaskan beberapa komponen WIC umum. Untuk daftar lengkap komponen yang tersedia, lihat antarmuka WIC.

Jenis 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.
Pengonversi Format 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