Crop Images

The Crop transformation task crops an image or video frame, to a region of interest that has been identified by another task. The task creates a new output track containing the cropped images. The track is named taskName.Output, where taskName is the name of the transformation task. The original input track is not modified.

The Crop transformation engine also translates any co-ordinates contained in records, so that their position is correct for the cropped image. For example, face detection outputs the locations of a person's eyes. The co-ordinates are modified so that the positions are correct for the cropped image.


To write the cropped images to disk, use the image encoder.

To crop images or video frames

  1. Create a new configuration to send to Media Server with the process action, or open an existing configuration that you want to modify.

  2. In the [Transform] section, add a new transformation task by setting the TransformEngineN parameter. You can give the task any name, for example:

  3. Create a new configuration section to contain the task settings and set the following parameters:

    Type The transformation engine to use. Set this parameter to Crop.
    Input The name of the image track that contains the images to crop, and supplies region data to use for cropping the images.

    For example:


    For more information about the parameters that you can use to configure this task, refer to the Media Server Reference.

  4. Save and close the configuration file. HPE recommends that you save your configuration files in the location specified by the ConfigDirectory parameter.