共用方式為

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

  • 發行項

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION是用來開啟和關閉臉部偵測的屬性標識碼。

使用量摘要數據表

範圍 控制 類型

第 1 版

篩選

同步

下列旗標可以放在KSCAMERA_EXTENDEDPROP_HEADER中。用來控制驅動程式中臉部偵測的旗標欄位。 根據預設，驅動程式應該有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

如果驅動程式支援此控件，它必須支援FACEDETECTION_OFF，以及任何一個FACEDETECTION_PREVIEW、FACEDETECTION_VIDEO或FACEDETECTION_PHOTO。 當啟用臉部偵測時，驅動程式應該進一步執行主要臉部分析，並將臉部直接饋送至 3A。

如果驅動程式不支援臉部偵測，驅動程式就不應該實作此控件。

下表描述旗標功能。

旗標 描述

KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF

這是必要功能。 指定時，會在驅動程式中停用臉部偵測。

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW

這是選擇性的功能。 指定時，會在驅動程式中啟用臉部偵測，而且驅動程式必須提供臉部資訊，以及支持的時間戳，作為透過預覽釘選的元數據。 此旗標與 OFF 旗標互斥，可以與其他旗標搭配使用。

KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO

這項功能是選擇性的。 指定時，會在驅動程式中啟用臉部偵測，且支援這類功能的驅動程序必須提供臉部資訊，以及支援的時間戳，以及透過視訊釘選的元數據相關聯的時間戳。 此旗標與 OFF 旗標互斥，可以與其他旗標搭配使用。

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO

這項功能是選擇性的。 指定時，會在驅動程式中啟用臉部偵測，且支援這類功能的驅動程序必須提供臉部資訊，以及支援的時間戳，以及透過相片釘選的元數據相關聯的時間戳。 此旗標與 OFF 旗標互斥，可以與其他旗標搭配使用。

KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK

這項功能是選擇性的。 只有在指定 PREVIEW、VIDEO 和\或 PHOTO 旗標時，才能指定這個旗標。 指定時，支援這類功能的驅動程式必須透過對應的釘選，以元數據的形式提供閃爍資訊。

KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE

這項功能是選擇性的。 只有在指定 PREVIEW、VIDEO 和\或 PHOTO 旗標時，才能指定這個旗標。 指定時，支援這類功能的驅動程式必須透過對應的釘選，以元數據的形式提供笑臉資訊。

注意

MFT0 應進一步將臉部資訊附加為MF_CAPTURE_METADATA_FACEROIS、時間戳作為MF_CAPTURE_METADATA_FACEROITIMESTAMPS，以及將閃爍和/或笑臉資訊附加為樣本上的MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS。 預覽、視訊和 PHOTO 功能是選擇性的。 不過，如果支援此控件，至少必須支援其中一個 PREVIEW、VIDEO 和 PHOTO 功能。

下表包含使用 控件時 ，KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的描述和需求。

member 描述

版本

這必須是 1。

PinId

必須是KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。

大小

這必須是sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) 。

結果

指出最後一個SET作業的錯誤結果。 如果沒有進行 SET 作業，這必須是 0。

功能

必須是上述支援的KSCAMERA_EXTENDEDPROP_FACEDETECTION_* 旗標的位 OR。

Flags

這是讀取/寫入欄位。 這可以是上面定義的KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF/PREVIEW/VIDEO/PHOTO 旗標的位 OR，或是KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK和/或KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE的任何組合KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO 旗標的位 OR。

下表包含 KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION 屬性KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING結構欄位的描述和需求。 此結構定義於 Ksmedia.h 中。

member 描述

[模式]

未使用的。 必須是 0。

最小值/最大值/步驟

Min/Max/Step 包含相機驅動程式可以偵測或搜尋的臉部數目下限/最大值/增量，其中 Min 必須是 >1，而步驟必須是 1。 驅動程式必須針對 GET 作業傳回這些專案。

VideoProc

如果在KSCAMERA_EXTENDEDPROP_HEADER的 Flags 欄位中指定FACEDETECTION_PREVIEW、FACEDETECTION_VIDEO或FACEDETECTION_PHOTO，VideoProc.Value.ul 也必須指定驅動程式應該搜尋的最大臉部數目。

如果指定了FACEDETECTION_OFF，則會忽略 SET 作業的 VideoProc 欄位。

針對 GET 作業，驅動程式必須傳回驅動程式目前搜尋的最大臉部數目。 如果臉部偵測為 OFF，則應該傳回 0。

保留

這未使用。 驅動程式必須忽略此專案。

備註

開啟臉部偵測時，驅動程式可以直接取用感興趣的臉部區域 (RO) ，以視需要協助 3A 處理。 如果同時透過KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL設定任何使用者指定的 RO，則使用者指定的 RO 會優先於偵測到的臉部 RO。 如果清除使用者指定的 RO，偵測到的臉部 RO 將會生效。

規格需求

標頭

 Ksmedia.h