Media Server 26.1
Media Server Help

# Region

A region to process, instead of processing the whole image or video frame.

Specify the region as a comma-separated list of values in the order: `left,top,width,height`, followed by the units that you want to use.

- `left` is the distance from the left of the frame to the left edge of the region.
- `top` is the distance from the top of the frame to the top edge of the region.
- `width` is the width of the region.
- `height` is the height of the region.

You can choose the following units:

- `percent` or `%` to use percentages of the image or video dimensions (`left` and `width` as percentages of the width, `top` and `height` as percentages of the height).
- `pixels` or `px` to use numbers of pixels.

Many analysis engines produce records that contain regions, and you might want to process a region that has been identified by another task. To process a region of the image or video that is described in the input track, set `Region=Input`.

NOTE: Tracking is not supported with `Region=Input`. In this case each video frame is considered to be an independent image, and Media Server might produce multiple results for the same text.

NOTE: When you ingest a PDF document and ProcessTextElements is set to `TRUE`, a word from a text element is included in the output if any part of the word overlaps the region. This is because text elements do not provide information about the position of individual characters. To set a region with character-level precision, you can set `ProcessTextElements=FALSE` so that Media Server runs OCR on an image of the page.

Type: | Custom
Default: |
Required: | No
Configuration Section: | TaskName
Example: | To process the central 50% of the width of the frame, and the entire height of the frame:
    Region=25,0,50,100 percent
To process a region 800 pixels wide by 400 pixels high, 50 pixels from the left and top sides of the image or video:
    Region=50,50,800,400 pixels
To process a region described in the input track:
    Region=Input
See Also: |

Copyright 2025 Open Text
Version 26.1 | Last updated January 2026

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 26.1

Topic Title: Region