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.

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: