Media Server 25.4
Media Server Help

# 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, see Crop Transformation Engine.

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

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

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 25.4

Topic Title: Crop Images