GMVLargestFaceFocusingDataOutput Class


GMVLargestFaceFocusingDataOutput Class Reference

Overview

A concrete subclass of GMVFocusingDataOutput.

This dataOutput focuses on tracking a single "prominent face", in conjunction with the associated face detector. A prominent face is defined as a face which was initially the largest, most central face when tracking began. This face will continue to be tracked as the prominent face for as long as it is visible, event when it is not the largest face. When the current prominent face is no longer present, another face will be selected as the new prominent face. This class implements GMVFocusingDataOutputDelegate, so there's no need to assign dataDelegate.

Inherits GMVFocusingDataOutput.

Instance Method Summary

(instancetype) - initWithDetector:
 Designated initializer. More...
 
(void) - receivedResults:
 Subclasses need to override these methods. More...
 
(void) - cleanup
 Clean up resources. More...
 

Property Summary

id< GMVOutputTrackerDelegatetrackerDelegate
 Post processing delegation. More...
 
id< GMVFocusingDataOutputDelegatedataDelegate
 Data output delegate. More...
 
AVCaptureDevicePosition captureDevicePosition
 Sets the camera device position to help calculate image rotation. More...
 
CGSize previewFrameSize
 The video frame preview size. More...
 
NSUInteger maxFrameGap
 The maximum allowable frames must pass without detecting a specific feature before delegate is notified the feature is no longer available. More...
 

Method Detail

- (instancetype) initWithDetector: (GMVDetector *)  NS_DESIGNATED_INITIALIZER

Designated initializer.

Parameters
detectoruse to run detection.
- (void) receivedResults: (NSArray< __kindof GMVFeature * > *)  results

Subclasses need to override these methods.

Detected GMVFeature results.

Parameters
resultsThe full detection results.
- (void) cleanup

Clean up resources.

Property Detail

- (id<GMVOutputTrackerDelegate>) trackerDelegate
readwritenonatomicstronginherited

Post processing delegation.

The trackerDelegate is referenced strongly. Call -cleanup to free up internal resources.

- (id<GMVFocusingDataOutputDelegate>) dataDelegate
readwritenonatomicweakinherited

Data output delegate.

- (AVCaptureDevicePosition) captureDevicePosition
readwritenonatomicassigninherited

Sets the camera device position to help calculate image rotation.

If not provided, it will try to retrieve position info through AVCaptureConnection.

- (CGSize) previewFrameSize
readnonatomicassigninherited

The video frame preview size.

The value is used to normalize display properties.

- (NSUInteger) maxFrameGap
readwritenonatomicassigninherited

The maximum allowable frames must pass without detecting a specific feature before delegate is notified the feature is no longer available.

The value is default to 3.