Region

The region to use when cropping the image.

Set this parameter only when you want to specify a fixed region. If you do not set this parameter, Media Server uses the region data in the input record (for example a bounding box around a detected face or object).

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.
Type: Custom
Default: Region data from the input record
Required: No
Configuration Section: TaskName
Example:

The following example crops the image, keeping the central 25% of the image.

Region=25,25,50,50 percent
See Also: