KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2

Artikel
05/22/2024

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 adalah ID properti yang menentukan bidang tampilan diagonal kamera (FoV) dalam derajat. Nilai FoV diagonal sesuai dengan FoV diagonal pada rasio aspek asli sensor. Ini menghasilkan rasio aspek non-asli yang memiliki fov diagonal nyata yang sedikit berbeda.

Bidang diagonal dari rasio aspek tampilan.

Kontrol ini terkait dengan KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW, KSPROPERTY_CAMERACONTROL_ZOOM, dan KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM. Lihat bagian keterangan di bawah ini untuk persyaratan interoperabilitas.

Tabel ringkasan penggunaan

Cakupan	Dapatkan	Set	Menguasai	Jenis
Versi 1	Ya	Ya	Filter	Sinkron

KSCAMERA_EXTENDEDPROP_HEADER bidang struktur

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

Anggota	Deskripsi
Versi	Harus 1.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Ukuran	Harus sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Hasil	Harus berisi 0. Bidang ini hanya digunakan untuk mengembalikan hasil operasi SET asinkron terakhir.
Kemampuan	Harus 0.
Bendera	Harus 0.

payload KSCAMERA_EXTENDEDPROP_VALUE

Payload menggunakan struktur KSCAMERA_EXTENDEDPROP_VALUE yang ada dengan jenis ULONG.

Keterangan

Interoperabilitas dengan KSPROPERTY_CAMERACONTROL_ZOOM dan KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

Jika driver/perangkat memilih untuk mendukung kontrol FoV baru ini dan KSPROPERTY_CAMERACONTROL_ZOOM lama atau KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM, kontrol zoom harus berfungsi dalam pilihan Bidang Tampilan (FoV) baru. Artinya Zoom relatif terhadap FoV. Untuk nilai FoV yang berbeda, nilai Zoom yang sama menghasilkan jumlah zoom yang jelas yang berbeda. Selain itu, mengatur FoV selalu mengatur ulang Zoom ke nilai defaultnya, terlepas dari apakah ada perubahan dalam nilai FoV yang sebenarnya.

Misalnya, rentang kontrol Zoom lama ditentukan dari 10 hingga 600 dan zoom adalah nilai defaultnya, 10, ketika pengaturan FoV baru diatur dari 75 derajat ke 90 derajat, kontrol zoom lama masih akan berada di 10 dengan rentang 10 hingga 600 yang sama. Tetapi jika zoom lama berada di 50, itu diatur ulang kembali ke 10 ketika nilai FoV baru diatur.

Interoperabilitas dengan KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW dan DIGITALWINDOW_CONFIGCAPS

Jika driver/perangkat memilih untuk mendukung kontrol FoV2 baru ini dan kontrol Jendela Digital (DW), persyaratan berikut harus diikuti:

Jika tujuan tunggal untuk menerapkan dukungan Jendela Digital adalah untuk mendukung KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING, dapat diterima bahwa Jendela Digital manual hanya mendukung satu ukuran jendela yang mewakili jendela penuh. Jendela penuh ini harus cocok dengan DefaultDiagonalFieldOfViewInDegrees dari FIELDOFVIEW2_CONFIGCAPS, meskipun FoV maksimum dapat lebih luas. Dalam hal ini, persyaratan yang tercantum di bawah ini untuk Jendela Digital manual dapat diabaikan, karena Jendela Digital manual tidak didukung sepenuhnya.
Area Jendela Digital manual yang didukung harus mencakup setidaknya pengaturan FoV terluas, misalnya, dengan menggunakan Jendela Digital, Anda dapat membuat pemangkasan digital yang akan cocok dengan salah satu pengaturan FoV yang didukung. Jika FoV default bukan FoV terluas, Jendela Digital harus menggunakan nilai Porch untuk mewakili jendela yang lebih luas.
KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW_CONFIGCAPS harus melaporkan kemampuan yang sama terlepas dari status kontrol FoV.
- Jendela Digital manual saat ini harus mencerminkan pengaturan FoV saat ini dan sebaliknya, kontrol terakhir menang.
- Ketika Jendela Digital manual diatur, FoV harus diubah secara internal ke pengaturan FoV terkecil yang tersedia yang mencakup area jendela yang dipilih. Ini berarti koordinat asal Jendela Digital dapat menyebabkan perubahan dalam FoV meskipun ukuran jendela Jendela Digital tetap sama. Misalnya, jika koordinat asal Jendela Digital berada di sudut kiri atas dengan ukuran jendela 0,4, pengaturan FoV mengiklankan FoV yang paling luas tersedia (dalam contoh ini 120°) karena sebaliknya tidak mencakup area tersebut. Tetapi jika Jendela Digital kedua dengan ukuran jendela yang sama dilakukan sebagai pemangkasan tengah, FoV yang tercermin kemungkinan sesuatu yang lebih sempit (75° dalam contoh kita).
- Ketika KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING didukung dan diatur, driver/perangkat harus mengubah FoV secara internal ke pengaturan terluas. Misalnya, operasi GET untuk KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 akan mengembalikan pengaturan FoV terluas saat KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING diaktifkan. Namun, setiap operasi SET yang berhasil untuk KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 akan mengubah Jendela Digital kembali ke mode KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL, saat kontrol terakhir menang.

Jendela digital dan bidang perilaku sinkronisasi kontrol tampilan di pengaturan jendela digital yang berbeda.

Interoperabilitas dengan kontrol Wilayah Minat

Karena kontrol ini mengubah Bidang Tampilan (FoV) yang jelas, koordinat yang dipilih melalui kontrol region of interest (ROI) apa pun harus diatur ulang ke defaultnya setiap kali SET dikeluarkan untuk kontrol ini. Daftar kontrol ROI saat ini meliputi:

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY_ID
KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS /KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

Jika kita menentukan kontrol di masa mendatang yang menentukan wilayah persegi panjang, kontrol itu juga harus diatur ulang.

Selain itu, kontrol Wilayah Minat menentukan wilayahnya relatif terhadap jendela output, sehingga koordinat yang mereka tentukan selalu persegi panjang di bidang tampilan saat ini. Karena kontrol ini mengubah bidang tampilan saat ini, persegi panjang Wilayah Minat harus dipetakan ulang oleh kamera agar pas dalam Bidang Tampilan saat ini.