Media Server 25.1
Media Server Help

# Object Recognition

Object Recognition recognizes known objects that appear in media. Object recognition identifies specific objects, not classes of objects.

Before using object recognition, you must train Media Server by adding training images to the training database. For instructions that describe how to train Media Server, see Train Object Recognition.

Configuration Parameter | Description
--- | ---
ColorAnalysis | Whether to perform color analysis on detected objects to reduce false detections.
Database | A comma-separated list of databases to use for recognition.
Geometry | The analysis mode to use when comparing the source media to 2-D objects in the training database.
Geometry3 | The analysis mode to use when comparing the source media to 3-D objects in the training database.
Identifier | A comma-separated list of identifiers that specifies the objects to recognize.
Input | The image track to process.
MaxInputQueueLength | Can be used to place a limit on latency.
MaxSize | The maximum expected size of an object.
Metadata | A metadata field name and value that specifies the objects to recognize.
MinimumMatchPercentage | The (approximate) minimum proportion of the trained object that must be recognized.
MinSize | The minimum expected size of an object.
NumParallel | The maximum number of video frames to analyze simultaneously.
ObjectEnvironment | The type of background that a partially or completely transparent object is superimposed on.
Occlusion | Whether the object might be partially hidden in images.
Region | A region of the frame to restrict processing to.
SampleInterval | The interval at which frames are selected to be analyzed.
SegmentDuration | The maximum duration of a record in the `SegmentedResult` or `SegmentedResultWithSource` track.
SyncDatabase | Specifies whether to synchronize with the training database before beginning the analysis task.
Type | The analysis engine to use. Set this parameter to `ObjectRecognition`.

## Output Tracks

The following table describes the tracks that are generated by this engine. The Output column indicates whether the information contained in the track is included by default in the output created by an output task (when you don't set the `Input` parameter for the output task).

Output track | Description | Output
--- | --- | ---
`Data` | Contains one record, describing the analysis results, per recognized object, per video frame. | No
`DataWithSource` | The same as the `Data` track, but each record also includes the source frame. | No
`Result` | Contains one record, describing the analysis results, for each recognized object. When the same object appears in many consecutive frames, Media Server produces a single result. | Yes
`ResultWithSource` | The same as the `Result` track, but each record also includes the best source frame. | No
`SegmentedResult` | (Available only when processing video). The same as the `Result` track, except the duration of each record is limited by the parameter SegmentDuration. If a result exceeds the specified duration, Media Server begins a new record with the same ID. | Yes
`SegmentedResultWithSource` | (Available only when processing video). The same as the `ResultWithSource` track, except the duration of each record is limited by the parameter SegmentDuration. If a result exceeds the specified duration, Media Server begins a new record with the same ID. | No
`Start` | The same as the `Data` track, except it contains only the first record of each event. | No
`End` | The same as the `Data` track, except it contains only the last record of each event. | No

For more information see Object Recognition Results or use the action GetExampleRecord.

Copyright 2024 Open Text
Version 25.1 | Last updated January 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.1

Topic Title: Object Recognition