# Analyze Image

> `UiPath.MicrosoftVision.Activities.AnalyzeImage`

`UiPath.MicrosoftVision.Activities.AnalyzeImage`

The **Analyze Image** activity uses the Microsoft Vision [API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/computer-vision-v3-1-ga/operations/56f91f2e778daf14a499f21b) to make a generic image call.

## 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](https://docs.uipath.com/activities/other/latest/legacy-integrations/microsoft-vision-scope) activity to your project.
2. Add the **Analyze Image** activity inside the **Microsoft Vision Scope** activity.
3. Create and enter variables for the **Intput** 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.

### Options

* **Result Language** - A selection that specifies the language in which the result is shown. Choose one of the following options: en, ja, pt, zh.
* **Selected Features** - A combo box that defines the type of analysis to carry out on the image. The available options are: Adult, Categories, Color, Description, Faces, ImageType, Tags

  :::note
  The allowed values are defined as:
  * **Adult** - Identifies adult or racy content. For more information on the call, see [Concept detecting adult content](https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/concept-detecting-adult-content) in the Microsoft Azure documentation.
  * **Categories** - Categorizes the image based on a predefined taxonomy.
     * For a full list of categories, see [Category taxonomy](https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/category-taxonomy) in the Azure documentation.
     * For more information about categories, see [Concept categorizing images](https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/concept-categorizing-images) in the Microsoft Azure documentation.
  + **Color** - Retrieves dominant colors from the image.
     * For more information, see [Concept detecting color schemes](https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/concept-detecting-color-schemes) in the Microsoft Azure documentation.
  + **Description** - Generates a description of the image.
     * For more information, see [Concept describing images](https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/concept-describing-images) in the Microsoft Azure documentation.
  + **Faces** - Identifies faces in the image and guesses the gender and age for the identified people.
     * For more information see [Concept detecting faces](https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/concept-detecting-faces) in the Microsoft Azure documentation.
  + **ImageType** - Identifies whether an image is clip art (rating the likelihood on a scale) or line drawing.
     * For more information, see [Concept detecting image types](https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/concept-detecting-image-types) in the Microsoft Azure documentation.
  + **Tags** - Assigns tags to the image based on identified objects in the image.
     * For more information, see [Concept tagging images](https://docs.microsoft.com/en-us/azure/cognitive-services/computer-vision/concept-tagging-images) in the Microsoft Azure documentation.
  :::

### Output

* **Result** - The result of the call based on the selected analysis features. Enter a `ImageAnalysis` variable.