Color Analysis Results
The following XML shows a single record produced by color analysis.
<output> <record> ... <trackname>ColorCluster.Result</trackname> <ColorClusterResult> <id>76b7b8dd-59f6-4fe7-9a6e-bcfae3cf94e8</id> <colorspace>RGB</colorspace> <cluster> <color>232 242 252</color> <colorname>white</colorname> <proportion>66.65</proportion> <score>66.65</score> </cluster> <cluster> <color>10 11 13</color> <colorname>black</colorname> <proportion>33.35</proportion> <score>33.35</score> </cluster> </ColorClusterResult> </record> </output>
The record contains the following information:
colorspace
- the color space in which the results are provided. You can choose the color space by setting theColorSpace
configuration parameter.-
Each
cluster
element represent a cluster of similar colors. The following information is available:color
- the color at the center of the cluster, in the color space requested.colorname
- a name for the color. This element contains a value only if you have configured a dictionary that associates names with color values. For information about color dictionaries, see Color Dictionaries.proportion
- the percentage of the image or video frame that belongs to that cluster.score
- some color dictionaries apply a greater weight to some colors. If you do not use a color dictionary or the color dictionary applies the same weight to every color, the score is the same as theproportion
. The sum of the scores for all of the clusters is equal to 100. If you set the parameterColorThreshold
in the task configuration, any cluster with a score that does not meet the threshold is omitted from the results.
In addition to the Result
track, the color clustering task also produces a track named ClusteredImage
. This contains the source image, containing only colors that match the center of a color cluster, and cropped to the analyzed region. If the analyzed region is not rectangular any pixels outside the region are transparent (or black if you use an image format that does not support transparency).