Class InferenceFacialLandmarkDetector

View Source

Definition

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

Provides the ability to detect facial landmarks.


                
C#

                

                    
Copy

                    

                

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

Constructors

View Source

InferenceFacialLandmarkDetector()

Initializes a new instance of the InferenceFacialLandmarkDetector class.

Declaration

                
C#

                

                    
Copy

                    

                

            
public InferenceFacialLandmarkDetector()
Exceptions
Type Condition
System.NotSupportedException

The required features are not supported.

Methods

View Source

Dispose()

Releases all resources used by the InferenceFacialLandmarkDetector.

Declaration

                
C#

                

                    
Copy

                    

                

            
public void Dispose()
View Source

Dispose(bool)

Releases the unmanaged resources used by the InferenceFacialLandmarkDetector.

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

~InferenceFacialLandmarkDetector()

Finalizes an instance of the InferenceFacialLandmarkDetector class.

Declaration

                
C#

                

                    
Copy

                    

                

            
protected ~InferenceFacialLandmarkDetector()
View Source

GetRequestResults()

Gets the points as a result of RequestInference(MediaVisionSource).

Declaration

                
C#

                

                    
Copy

                    

                

            
public InferenceFacialLandmarkDetectorResult GetRequestResults()
Returns
Type Description
InferenceFacialLandmarkDetectorResult

The points of detected facial landmarks.
Remarks

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

Exceptions
Type Condition
System.ObjectDisposedException

The InferenceFacialLandmarkDetector already has been disposed.
See Also
View Source

Inference(MediaVisionSource)

Detects facial landmarks on the source image synchronously.

Declaration

                
C#

                

                    
Copy

                    

                

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

The image data to detect facial landmarks.
Returns
Type Description
InferenceFacialLandmarkDetectorResult

The coordinates of detected facial landmarks.
Remarks

Points can be empty, if there's no detected facial landmark.

Exceptions
Type Condition
System.ObjectDisposedException

The InferenceFacialLandmarkDetector already has been disposed.
System.ArgumentNullException

source is null.
View Source

InferenceAsync(MediaVisionSource)

Detects facial landmarks on the source image asynchronously.

Declaration

                
C#

                

                    
Copy

                    

                

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

The image data to detect facial landmarks.
Returns
Type Description
System.Threading.Tasks.Task<TResult><InferenceFacialLandmarkDetectorResult>
Remarks

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

Exceptions
Type Condition
System.ObjectDisposedException

The InferenceFacialLandmarkDetector already has been disposed.
System.ArgumentNullException

source is null.
View Source

RequestInference(MediaVisionSource)

Requests detecting facial landmarks to get their points asynchronously.

Declaration

                
C#

                

                    
Copy

                    

                

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

The image data to detect facial landmarks.
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.
Points can be empty, if there's no detected facial landmark.
Note that this method could use about twice as much memory as Inference(MediaVisionSource).

Exceptions
Type Condition
System.ObjectDisposedException

The InferenceFacialLandmarkDetector already has been disposed.
System.ArgumentNullException

source is null.
See Also

Implements

System.IDisposable