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 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버	Description
버전	1이어야 합니다.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF)이어야 합니다.
크기	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)여야 합니다.
결과	마지막 SET 작업의 오류 결과를 나타냅니다. SET 작업이 수행되지 않은 경우 0이어야 합니다.
기능	위에서 정의한 대로 지원되는 KSCAMERA_EXTENDEDPROP_FACEDETECTION_* 플래그의 비트 OR이어야 합니다.
플래그	읽기/쓰기 필드입니다. 위에서 정의한 KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF/PREVIEW/VIDEO/PHOTO 플래그 또는 KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO 플래그의 조합으로 KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK 및/또는 KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE 약간 현명한 OR일 수 있습니다.

아래 표에는 KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION 속성에 대한 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다. 이 구조체는 Ksmedia.h에 정의되어 있습니다.

멤버	Description
Mode	사용되지 않습니다. 0이어야 합니다.
최소/최대/단계	Min/Max/Step에는 카메라 드라이버가 감지하거나 검색할 수 있는 얼굴 수의 최소/최대/증가가 포함되며 Min은 1이어야 >하고 단계는 1이어야 합니다. 드라이버는 GET 작업에 대해 이를 반환해야 합니다.
VideoProc	FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO 또는 FACEDETECTION_PHOTOKSCAMERA_EXTENDEDPROP_HEADER Flags 필드에 지정된 경우 VideoProc.Value.ul은 드라이버에서 검색해야 하는 최대 얼굴 수를 지정해야 합니다. FACEDETECTION_OFF 지정한 경우 SET 작업의 경우 VideoProc 필드는 무시됩니다. GET 작업의 경우 드라이버는 드라이버가 현재 검색 중인 최대 얼굴 수를 반환해야 합니다. 얼굴 감지가 OFF이면 0이 반환되어야 합니다.
예약됨	사용되지 않습니다. 드라이버에서 무시해야 합니다.

설명

얼굴 감지를 켜면 필요에 따라 3A 처리를 돕기 위해 드라이버에서 직접 UI(얼굴 영역)를 사용할 수 있습니다. 사용자가 지정한 ROI가 KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 통해 동시에 구성된 경우 사용자가 지정한 ROI가 검색된 얼굴 ROI보다 우선합니다. 사용자가 지정한 ROI가 지워지면 감지된 얼굴 ROI가 적용됩니다.

요구 사항

헤더

Ksmedia.h