# OCRCodeActivity Class

> OCRCodeActivity abstract class, used as the base for building CodeActivity-based OCR engine activities.

## Definition

* Namespace: `UiPath.OCR.Contracts.Activities`
* Assembly: `UiPath.OCR.Contracts`

## Description

An abstract class that must be implemented in order to construct a `CodeActivity` from the Workflow Foundation framework.

## Members

### Methods

* `BeforeExecute(System.Activities.CodeActivityContext)` `System.Collections.Generic.Dictionary<string, object>` - Overrides this method to compute and provide all the activity input arguments, other than the Image argument, and returns the activity input arguments as a dictionary where the key is the argument name and the value is the argument value.
  :::note
  At design time, when no context is available, the method's parameters are null. In this case, the activity arguments can't be read, so you may want to provide default values for them.
  :::
* `Execute(System.Activities.CodeActivityContext)` `System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<System.Drawing.Rectangle, string>>`
* `OCRCodeActivity()`
* `OnSuccess(System.Activities.CodeActivityContext, UiPath.OCR.Contracts.DataContracts.OCRResult)` `void OnSuccess(System.Activities.CodeActivityContext context, UiPath.OCR.Contracts.DataContracts.OCRResult result)` - This method is called after computing the OCR result. It can be used to set output arguments or any other final operations.
* `PerformOCRAsync(System.Drawing.Image, System.Collections.Generic.Dictionary<string, object>, System.Threading.CancellationToken)` `System.Threading.Tasks.Task<UiPath.OCR.Contracts.DataContracts.OCRResult>` - Processes an image and returns the extracted text information. The *options* parameter is a dictionary of activity arguments having as key the argument name and as value the argument value.

### Properties

* `ExtractWords` - Gets or sets if the words should be extracted.
* `Image` `System.Activities.InArgument<System.Drawing.Image>` - Image to be processed.
* `Language` `System.Activities.InArgument<string>` -
* `Output` `System.Activities.OutArgument<UiPath.OCR.Contracts.OcrActivityResult>` -
* `Text` `System.Activities.OutArgument<UiPath.OCR.Contracts.OcrActivityResult>` -

## Code Sample

```
[DisplayName("Sample OCRCodeActivity")]
internal class SampleOCRCodeActivity : OCRCodeActivity
    {
        public InArgument<string> CustomInput { get; set; }

        public OutArgument<string> CustomOutput { get; set; }

        public override Task<OCRResult> PerformOCRAsync(Image image, Dictionary<string, object> options, CancellationToken ct)
        {
            string customInput = options[nameof(CustomInput)] as string;
            string text = $"Text from {nameof(SampleOCRCodeActivity)} with custom input: {customInput}";
            return Task.FromResult(OCRResultHelper.FromText(text));
        }

        protected override void OnSuccess(CodeActivityContext context, OCRResult result)
        {
            CustomOutput.Set(context, $"Custom output: '{result.Text}' has {result.Words.Length} words.");
        }

        protected override Dictionary<string, object> BeforeExecute(CodeActivityContext context)
        {
            return new Dictionary<string, object>
            {
                { nameof(CustomInput), CustomInput.Get(context) }
            };
        }
    }
```