Class InferenceFaceDetector

View Source

Definition

Namespace:
Tizen.Multimedia.Vision
Assembly:
Tizen.Multimedia.Vision.dll

Provides the ability to detect faces.


                
C#

                

                    
Copy

                    

                

            
public class InferenceFaceDetector : IDisposable
Inheritance
object
InferenceFaceDetector
Implements
System.IDisposable

Constructors

View Source

InferenceFaceDetector()

Initializes a new instance of the InferenceFaceDetector class.

Declaration

                
C#

                

                    
Copy

                    

                

            
public InferenceFaceDetector()
Exceptions
Type Condition
System.NotSupportedException

The required features are not supported.

Methods

View Source

Dispose()

Releases all resources used by the InferenceFaceDetector.

Declaration

                
C#

                

                    
Copy

                    

                

            
public void Dispose()
View Source

Dispose(bool)

Releases the unmanaged resources used by the InferenceFaceDetector.

Declaration

                
C#

                

                    
Copy

                    

                

            
protected virtual void Dispose(bool disposing)
Parameters
Type Name Description
bool disposing

true to release both managed and unmanaged resources; false to release only unmanaged resources.
View Source

~InferenceFaceDetector()

Finalizes an instance of the InferenceFaceDetector class.

Declaration

                
C#

                

                    
Copy

                    

                

            
protected ~InferenceFaceDetector()
View Source

GetRequestResults()

Gets the bounding boxes as a result of RequestInference(MediaVisionSource).

Declaration

                
C#

                

                    
Copy

                    

                

            
public InferenceFaceDetectorResult GetRequestResults()
Returns
Type Description
InferenceFaceDetectorResult

The bounding boxes of detected face.
Remarks

If there's no detected face, BoundingBoxes will be empty.
This method uses about twice as much memory as Inference(MediaVisionSource).

Exceptions
Type Condition
System.ObjectDisposedException

The InferenceFaceDetector already has been disposed.
See Also
View Source

Inference(MediaVisionSource)

Detects faces on the source image synchronously.

Declaration

                
C#

                

                    
Copy

                    

                

            
public InferenceFaceDetectorResult Inference(MediaVisionSource source)
Parameters
Type Name Description
MediaVisionSource source

The image data to detect faces.
Returns
Type Description
InferenceFaceDetectorResult

The BoundingBoxes of detected face.
Remarks

BoundingBoxes can be empty, if there's no detected face.

Exceptions
Type Condition
System.ObjectDisposedException

The InferenceFaceDetector already has been disposed.
System.ArgumentNullException

source is null.
View Source

InferenceAsync(MediaVisionSource)

Detects faces on the source image asynchronously.

Declaration

                
C#

                

                    
Copy

                    

                

            
public Task<InferenceFaceDetectorResult> InferenceAsync(MediaVisionSource source)
Parameters
Type Name Description
MediaVisionSource source

The image data to detect faces.
Returns
Type Description
System.Threading.Tasks.Task<TResult><InferenceFaceDetectorResult>
Remarks

BoundingBoxes can be empty, if there's no detected face.
This method uses about twice as much memory as Inference(MediaVisionSource).

Exceptions
Type Condition
System.ObjectDisposedException

The InferenceFaceDetector already has been disposed.
System.ArgumentNullException

source is null.
View Source

RequestInference(MediaVisionSource)

Requests detecting faces to get their bounding boxes asynchronously.

Declaration

                
C#

                

                    
Copy

                    

                

            
public ulong RequestInference(MediaVisionSource source)
Parameters
Type Name Description
MediaVisionSource source

The image data to detect faces.
Returns
Type Description
ulong

The request ID that indicates the order of requests.
Remarks

This function does not guarantee that inference is done when this method returns. The user can get the result by using GetRequestResults().
If the user calls this method again before the previous one is finished internally, the call will be ignored.
BoundingBoxes can be empty, if there's no detected face.
Note that this method could use about twice as much memory as Inference(MediaVisionSource).

Exceptions
Type Condition
System.ObjectDisposedException

The InferenceFaceDetector already has been disposed.
System.ArgumentNullException

source is null.
See Also

Implements

System.IDisposable