Detect Faces

UiPath.MicrosoftVision.Activities.DetectFaces

The Detect Faces activity uses the Microsoft Vision API to identify and retrieve faces inside the image and gives information on the gender and age of the identified persons.

How it works

The following steps are an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Add the Microsoft Vision Scope activity to your project.
2. Add the Detect Faces activity inside the Microsoft Vision Scope activity.
3. Create and enter variables for the Input properties.
4. Create and enter variables for the Output property.

Properties

Common

• Continue On Error - This field only supports boolean values (True, False). The default value in this field is False. As a result, if this field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Input

• Image Path - The path to a local image to be analyzed. This field supports only Strings or String variables. If Image URL is provided, this field is ignored.
• Image URL - The URL of an image to be analyzed. This field supports only Strings or String variables. If Image Path is provided, this field is ignored.

Misc

• Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Output

• Result - The result is returned as an Array<FaceImage> which contains all the identified faces along with their gender and age. Enter a FaceImage[] variable. FaceImage has the following structure:
  • Gender - String. The gender of the identified person.
  • Position - System.Drawing.Rectangle. The position of the person's face inside the image.
  • Age - Integer. The predicted age of the identified person.