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 path of the color dictionary file. | Yes |
The following example lists the colors in the basic colors dictionary:
/action=ListColors&colordictionary=./colorcluster/basiccolors.dat
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>224 224 224</color> <color>255 255 255</color> </entry> <entry> <colorname>silver</colorname> <color>192 192 192</color> </entry> ... </dictionary> </responsedata> </autnresponse>
The response contains the following information for each entry in the dictionary:
colorname
element contains the name of the color.color
element contains the definition for the color, in the color space specified by the colorspace
element. Some entries might have more than one color
element. 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, HPE Media Server combines the clusters for definitions with the same name (unless you set the parameter CombineNamedColors to FALSE
).
|