Object Engine Configuration Parameters

An Object analysis task recognizes known objects in video. Before using the Object engine, you must populate a database with training images. For instructions, refer to the Media Server Administration Guide.

This section describes the parameters that you can set in the configuration section for an Object analysis task.

Configuration Parameter Description
ColorAnalysis Whether to perform color analysis on detected objects to reduce false detections.
Database An object database to use to detect objects in an image.
FrameRate The number of frames to analyze per second of video.
Identifier A comma-separated list of identifiers that specifies the objects to match against.
Input The image track to process.
NumParallel

The maximum number of threads to use for running the object detection task.

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.
Perspective Whether the object might be subject to perspective transformations (skew). Perspective transformations result from the object being viewed from any angle other than the perspective of the training images.
Region A region of the frame to restrict processing to.
RegionUnit The units that the Region parameter uses to specify the size and position of a region.
Type The analysis engine to use. Set this parameter to Object.

Output Tracks

Output track Type Description Output1This 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).
Data ObjectResult Contains a record for every frame in which an object is detected. No
DataWithSource ObjectAndImage Contains the same information as the Data track, but each record also includes the source frame. No
Event ObjectEvent Media Server creates a record in the Event track when an object appears or disappears. Yes
Result ObjectResult Contains a single record for each detected object (a detected object might appear in many consecutive frames). This track only contains the best result from running analysis on an object. Yes
ResultWithSource ObjectAndImage Contains the same information as the Result track, but each record also includes the best source frame. No

ObjectResult

Field name Type Description
id UUIDData A universally unique identifier to identify the object
identity IdentityData The identity of the model in the database that matches the detected object
boundary PolygonData A polygon to indicate the location of the object in the frame

ObjectAndImage

Field name Type Description
id UUIDData A universally unique identifier to identify the object
identity IdentityData The identity of the model in the database that matches the detected object
boundary PolygonData A polygon to indicate the location of the object in the frame
image ImageData The source frame

ObjectEvent

Field name Type Description
id UUIDData A universally unique identifier to identify the object
event TrackingEventData The type of event (begin/end), and the elapsed time since the object appeared
identity IdentityData The identity of the model in the database that matches the detected object

_HP_HTML5_bannerTitle.htm