Open topic with navigation

# 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.

TIP:

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 `[Session]` section, add a new task by setting the `EngineN` parameter. You can give the task any name, for example:

       [Session]
       Engine0=Ingest
       ...
       Engine2=Crop

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:

       [Crop]
       Type=Crop
       Input=FaceRecognition.ResultWithSource

   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. Micro Focus recommends that you save your configuration files in the location specified by the `ConfigDirectory` parameter.

© 2018 Micro Focus or one of its affiliates | Send documentation feedback to Micro Focus Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm