# 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>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:

- The `colorname` element contains the name of the color.
- The `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, Media Server combines the clusters for definitions with the same name (unless you set the parameter CombineNamedColors to `FALSE`).

© Copyright 2019 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm