KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

  • 项目

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION是用于打开和关闭人脸检测的属性 ID。

使用情况摘要表

范围 控制 类型

版本 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。 预览、视频和照片功能是可选的。 但是，如果支持此控件，则必须至少支持预览、视频和照片功能之一。

下表包含使用 控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的说明和要求。

成员 说明

版本

此值必须为 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/预览/VIDEO/PHOTO 标志的位明智 OR，也可以是KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK和/或KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO 标志的任意组合的位或。

下表包含 KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION 属性的 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 结构字段的说明和要求。 此结构在 Ksmedia.h 中定义。

成员 说明

“模式”

未使用。 必须为 0。

Min/Max/Step

Min/Max/Step 包含相机驱动程序可以检测或搜索的人脸数的最小值/最大/增量，其中 Min 必须为 >1，而步骤必须为 1。 驱动程序必须返回 GET 操作的这些值。

VideoProc

如果在KSCAMERA_EXTENDEDPROP_HEADER的“标志”字段中指定了FACEDETECTION_PREVIEW、FACEDETECTION_VIDEO或FACEDETECTION_PHOTO，则 VideoProc.Value.ul 还必须指定驱动程序应搜索的最大人脸数。

如果指定了FACEDETECTION_OFF，则对于 SET 操作，将忽略 VideoProc 字段。

对于 GET 操作，驱动程序必须返回驱动程序当前正在搜索的最大人脸数。 如果人脸检测为 OFF，应返回 0。

预留

这未使用。 驱动程序必须忽略这一点。

注解

启用人脸检测后，驱动程序可以直接使用兴趣区域 (ROI) ，以便根据需要帮助 3A 处理。 如果同时通过KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL配置任何用户指定的 ROI，则用户指定的 ROI 将优先于检测到的人脸 ROI。 如果清除了用户指定的 ROI，则检测到的人脸 ROI 将生效。

要求

标头

 Ksmedia.h