ListColors
Lists the color names that have been defined in a color dictionary file, and the associated color values.
Type: synchronous
| Parameter | Description | Required |
|---|---|---|
ColorDictionary
|
The dictionary file. If the dictionary file is located in the colorcluster folder, in the StaticDataDirectory, you can specify just the file name. Otherwise specify a path - either absolute or relative to the Media Server executable file. |
Yes |
Example
The following example lists the colors in the basic colors dictionary:
/action=ListColors&ColorDictionary=basiccolors.dat
Response
The response returns the color names that have been defined:
<autnresponse>
<action>LISTCOLORS</action>
<response>SUCCESS</response>
<responsedata>
<colorspace>RGB</colorspace>
<dictionary>
<entry>
<colorname>white</colorname>
<color weight="5">248 247 246</color>
<color weight="4">236 233 224</color>
</entry>
<entry>
<colorname>silver</colorname>
<color weight="5">212 213 217</color>
<color weight="1">169 179 181</color>
</entry>
...
</dictionary>
</responsedata>
</autnresponse>
The response contains the following information for each entry in the dictionary:
- The
colornameelement contains the name of the color. -
The
colorelement contains the definition for the color, in the color space specified by thecolorspaceelement. Some entries might have more than onecolorelement. This means that the dictionary has multiple definitions for the same color name. The color dictionary can have different definitions for the same color to allow for lighting variations. In the output, Media Server combines the clusters for definitions with the same name (unless you set the parameter CombineNamedColors toFALSE).The
weightattribute indicates that an optional weight has been assigned to the color for scoring purposes. In the results of color analysis, a greater weight results in a greater score. If the same weight is applied to every color the score is the proportion of the image or video frame that belongs to that color cluster. Theweightedcarcolors.datdictionary uses weights to help score the paintwork color more highly than trim and reflections from glass.