Bagikan melalui

Antarmuka IWiaImageFilter

  • Artikel

Antarmuka IWiaImageFilter adalah antarmuka ekstensi yang diterapkan oleh pengembang filter pemrosesan gambar dan dipanggil oleh Windows Image Acquisition (WIA) 2.0.

Anggota

Antarmuka IWiaImageFilter mewarisi dari antarmuka IUnknown . IWiaImageFilter juga memiliki jenis anggota berikut:

Metode

Antarmuka IWiaImageFilter memiliki metode ini.

Metode Deskripsi
ApplyProperties Memungkinkan filter pemrosesan gambar untuk menulis properti kembali ke driver (dan perangkat).
FilterPreviewImage Memfilter gambar pratinjau.
InitializeFilter Menginisialisasi filter. Dipanggil oleh WIA 2.0 sebelum setiap unduhan gambar.
SetNewCallback Mengatur panggilan balik aplikasi baru untuk filter pemrosesan gambar yang akan digunakan untuk mengalihkan panggilan.

 

Keterangan

Pengembang filter pemrosesan gambar harus mengimplementasikan antarmuka ini dan antarmuka IWiaTransferCallback .

WIA 2.0 memanggil metode filter. Mereka tidak pernah dipanggil langsung dari aplikasi.

Microsoft memasok Komponen Pratinjau WIA 2.0, yang menyimpan gambar pratinjau asli yang tidak difilter yang diperoleh dari pemindai. Aplikasi menggunakan CoCreateInstance untuk membuat bersama instans Komponen Pratinjau WIA 2.0 (CLSID_WiaPreview), yang memuat filter menggunakan IWiaItem2::GetExtension. Filter dipanggil secara otomatis ketika aplikasi memanggil IWiaTransfer::D ownload.

Filter pemrosesan gambar selalu dijalankan saat gambar dipindai. Aplikasi tidak dapat memperoleh gambar dari pemindai tanpa menerapkan filter pencitraan terlebih dahulu.

Filter harus menerapkan kecerahan dan kontras minimal. UI umum, yang memberikan kecerahan dan kontrol kontras kepada pengguna, dapat menampilkan pratinjau yang akurat kepada pengguna.

Filter pemrosesan gambar tidak boleh memodifikasi anggota lMessage dari struktur WiaTransferParams .

Untuk membaca properti yang diperlukan, filter pemrosesan gambar harus memanggil IWiaPropertyStorage::GetPropertyStream pada antarmuka IWiaPropertyStorage yang didapatkannya dari item dengan memanggil IWiaImageFilter::QueryInterface. Filter kemudian dapat membuat instans IPropertyStorage pada aliran ini untuk membaca properti item. Filter pemrosesan gambar tidak boleh memanggil IWiaPropertyStorage::ReadMultiple secara langsung karena metode ini memanggil ke driver drvReadItemProperties, tetapi layanan WIA 2.0 telah mengunci driver dalam drvAcquireItemData panggilan sehingga panggilan ini akan waktu habis dan gagal.

Properti yang diminati filter dapat misalnya pengaturan kecerahan dan kontras. Filter biasanya juga perlu membaca format gambar serta properti pratinjau, WIA_DPS_PREVIEW, dari pWiaItem2. Semua properti ini digunakan dalam proses pemfilteran.

Komponen WIA 2.0 selalu menulis data yang tidak difilter ke dalam filter pemrosesan gambar. Algoritma pemrosesan gambar yang diterapkan oleh aliran filter dapat memfilter data lebih dari sekali dan tidak perlu khawatir dengan menghasilkan hasil yang sama seperti memfilter data sekali.

Filter harus memperhatikan properti WIA_DPS_PREVIEW , terutama jika beberapa tugas terkait filter ditangani dalam perangkat keras. Misalnya, driver tertentu dapat mengubah kecerahan lampu di perangkat keras pemindai tergantung pada bagaimana aplikasi telah mengatur kecerahan menjadi item WIA 2.0. Selama pemindaian akhir (ketika aplikasi memanggil IWiaTransfer::D ownload) driver biasanya akan memodifikasi lampu fisik pemindai. Dalam hal ini filter pemrosesan gambar mungkin tidak harus melakukan pemrosesan kecerahan sama sekali. Namun, selama pemindaian pratinjau, driver tidak boleh memodifikasi kecerahan lampu—sebagai gantinya ini harus diurus hanya dalam filter pemrosesan gambar. Penting bahwa Komponen Pratinjau WIA 2.0 dan filter pemrosesan gambar mengembalikan gambar yang akurat berdasarkan properti yang diatur ke dalam item.

Filter pemrosesan gambar harus mendukung semua format gambar yang didukung driver.

Filter pemrosesan gambar selalu diberi gambar yang sesuai dengan area pilihan yang diatur ke dalam item tempat kami memperoleh gambar. Namun, perhatikan bahwa gambar mungkin telah diputar oleh driver jika mendukung properti WIA_IPS_ROTATION .

Filter pemrosesan gambar dibuat melalui IWiaItem2::GetExtension, biasanya bukan oleh aplikasi tetapi oleh komponen WIA 2.0 ketika aplikasi memanggil IWiaPreview::GetNewPreview atau IWiaTransfer::D ownload.

Antarmuka IWiaImageFilter , seperti semua antarmuka Model Objek Komponen (COM), mewarisi metode antarmuka IUnknown .

Metode IUnknown Deskripsi
IUnknown::QueryInterface Mengembalikan pointer ke antarmuka yang didukung.
IUnknown::AddRef Jumlah referensi kenaikan.
IUnknown::Release Jumlah referensi pengurangan.

 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2008 [hanya aplikasi desktop]
Header
Wia.h
IDL
Wia.idl