Color Clustering (Region)

DEPRECATED:

This analysis engine is deprecated in HPE Media Server version 11.1.0 and later. It is still available for existing implementations, but it might be incompatible with new functionality. The engine might be removed in future.

HPE recommends using the ColorCluster engine instead, with the configuration parameter RestrictToInputRegion=TRUE.

The Color Cluster (Region) analysis engine determines the dominant colors in a region of a frame by clustering similar colors. The engine returns the color at the center of each cluster, and the proportion of the pixels in the region that belong to each cluster.

You can use this engine to analyze any track where the records include an image, a region, and a UUID. To run color analysis on records that do not contain a region, use the ColorCluster task.

This section describes the parameters that you can use to configure color analysis.

Configuration Parameter Description
ColorSpace The color space in which the results of analysis are provided.
ColorThreshold Discards colors that do not make up a significant proportion of the region.
Input The image track to process.
Type The analysis engine to use. Set this parameter to ColorClusterRegion.

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).
Result ColorClusterRegionResult Contains a record for each analyzed frame. Each record contains information about the colors that are present in the region. True

ColorClusterRegionResult

Field name Type Description
id UUIDData A universally unique identifier to identify the analyzed frame.
colorspace String The color space in which the results are presented.
cluster An array of ColorClusters Information about the colors in the analyzed region.

ColorCluster

Field name Type Description
Color String The color at the center of a cluster.
Proportion Float The proportion of pixels in the frame that belong to the cluster.

_HP_HTML5_bannerTitle.htm