KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION adalah ID properti yang digunakan untuk mengaktifkan dan menonaktifkan deteksi wajah.

Tabel ringkasan penggunaan

Cakupan	Kontrol	Jenis
Versi 1	Filter	Sinkron

Bendera berikut dapat ditempatkan di KSCAMERA_EXTENDEDPROP_HEADER. Bidang bendera untuk mengontrol deteksi wajah di driver. Secara default, driver harus memiliki FACEDETECTION_OFF.

#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW         0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO           0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO           0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK           0x0000000000000008
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE           0x0000000000000010

Jika driver mendukung kontrol ini, driver harus mendukung FACEDETECTION_OFF dan salah satu FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO, atau FACEDETECTION_PHOTO. Driver harus lebih melakukan analisis wajah mendominasi dan memberi makan wajah yang mendominasi ke 3A secara langsung ketika deteksi wajah diaktifkan.

Jika driver tidak mendukung deteksi wajah, driver tidak boleh menerapkan kontrol ini.

Tabel berikut ini menjelaskan kapabilitas bendera.

Bendera	Deskripsi
KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF	Ini adalah kemampuan wajib. Ketika ditentukan, deteksi wajah dinonaktifkan di driver.
KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW	Ini adalah kemampuan opsional. Ketika ditentukan, deteksi wajah diaktifkan di driver dan driver harus memberikan info wajah, dan tanda waktu yang terkait jika didukung, sebagai metadata melalui pin pratinjau. Bendera ini saling eksklusif dengan bendera OFF dan dapat digunakan dengan bendera lainnya.
KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO	Kemampuan ini bersifat opsional. Ketika ditentukan, deteksi wajah diaktifkan di driver dan driver yang mendukung kemampuan tersebut harus memberikan info wajah, dan tanda waktu yang terkait jika didukung, sebagai metadata melalui pin video. Bendera ini saling eksklusif dengan bendera OFF dan dapat digunakan dengan bendera lainnya.
KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO	Kemampuan ini bersifat opsional. Ketika ditentukan, deteksi wajah diaktifkan di driver dan driver yang mendukung kemampuan tersebut harus memberikan info wajah, dan tanda waktu yang terkait jika didukung, sebagai metadata melalui pin foto. Bendera ini saling eksklusif dengan bendera OFF dan dapat digunakan dengan bendera lainnya.
KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK	Kemampuan ini bersifat opsional. Bendera ini hanya dapat ditentukan ketika bendera PRATINJAU, VIDEO, dan\atau PHOTO ditentukan. Ketika ditentukan, driver yang mendukung kemampuan tersebut juga harus memberikan info blink sebagai metadata melalui pin yang sesuai.
KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE	Kemampuan ini bersifat opsional. Bendera ini hanya dapat ditentukan ketika bendera PRATINJAU, VIDEO, dan\atau PHOTO ditentukan. Ketika ditentukan, driver yang mendukung kemampuan tersebut juga harus memberikan info senyum sebagai metadata melalui pin yang sesuai.

Catatan

MFT0 selanjutnya harus melampirkan informasi wajah sebagai MF_CAPTURE_METADATA_FACEROIS, tanda waktu sebagai MF_CAPTURE_METADATA_FACEROITIMESTAMPS, dan informasi blink dan/atau senyum sebagai MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS pada sampel. Kemampuan PRATINJAU, VIDEO, dan FOTO bersifat opsional. Namun, setidaknya salah satu kemampuan PRATINJAU, VIDEO, dan FOTO harus didukung jika kontrol ini didukung.

Tabel berikut berisi deskripsi dan persyaratan untuk bidang struktur KSCAMERA_EXTENDEDPROP_HEADER saat menggunakan kontrol.

Anggota	Deskripsi
Versi	Ini harus 1.
PinId	Harus KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Ukuran	Ini harus ukuranof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING).
Hasil	Menunjukkan hasil kesalahan dari operasi SET terakhir. Jika tidak ada operasi SET yang terjadi, ini harus 0.
Kemampuan	Harus berupa bitwise ATAU dari bendera KSCAMERA_EXTENDEDPROP_FACEDETECTION_* yang didukung seperti yang didefinisikan di atas.
Bendera	Ini adalah bidang baca/tulis. Ini bisa sedikit bijaksana ATAU dari bendera KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF/PREVIEW/VIDEO/PHOTO yang ditentukan di atas, atau sedikit bijaksana ATAU KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK dan/atau KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE dengan kombinasi bendera KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO.

Tabel di bawah ini berisi deskripsi dan persyaratan untuk bidang struktur KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING untuk properti KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION. Struktur ini didefinisikan dalam Ksmedia.h.

Anggota	Deskripsi
Mode	Tidak digunakan. Harus 0.
Min/Maks/Langkah	Min/Max/Step berisi minimum/maksimum/kenaikan jumlah wajah yang dapat dideteksi atau dicari driver kamera di mana Min harus >= 1 dan Langkah harus 1. Driver harus mengembalikannya untuk operasi GET.
VideoProc	Jika FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO , atau FACEDETECTION_PHOTO ditentukan di bidang Bendera KSCAMERA_EXTENDEDPROP_HEADER, VideoProc.Value.ul juga harus menentukan jumlah maksimum wajah yang harus dicari driver. Jika FACEDETECTION_OFF ditentukan, untuk operasi SET, bidang VideoProc diabaikan. Untuk operasi GET, driver harus mengembalikan jumlah maksimum wajah yang saat ini dicari driver. Jika deteksi wajah NONAKTIF, 0 harus dikembalikan.
Dicadangkan	Ini tidak digunakan. Ini harus diabaikan oleh driver.

Keterangan

Ketika deteksi wajah diaktifkan, wilayah wajah yang menarik (ROI) dapat dikonsumsi langsung oleh driver untuk membantu pemrosesan 3A sesuai kebutuhan. Jika ada ROI yang ditentukan pengguna dikonfigurasi melalui KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL pada saat yang sama, ROI yang ditentukan pengguna akan lebih diutamakan daripada ROI wajah yang terdeteksi. Jika ROI yang ditentukan pengguna dibersihkan, ROI wajah yang terdeteksi akan berlaku.

Persyaratan

Header

Ksmedia.h