icon

Contains the definition of an icon that can be used by CUE and other application user interfaces.

An icon element can appear as the child of one of the following elements:

content-type, in which case it defines the icon to be used to represent content items of this type in the user interface.
macro, in which case it defines the icon to be used to represent this macro in the user interface.

In general, the icon element must contain the absolute URI of the image you want to use as an icon. For good results in CUE, the image must have the following characteristics:

PNG format
Monochrome: black on a transparent background. CUE automatically inverts the colors where necessary.
32x32 pixels in size

When used as the child of a macro element:

The icon can be smaller (it will be scaled down to 16x16 pixels by CUE).
You can also specify a single unicode character as element content. An icon will then be generated from the specified character. You can specify the character either literally or as a numeric entity (↑ for example).

Syntax

<icon>
  text
</icon>

Examples

This example selects a custom icon stored on a server somewhere in the network.
```
<ui:icon>http://my-company-server/icons/custom-audio.png</ui:icon>
```
This example creates an icon from the ↑ character. You can also specify characters as entities (↑ in this case). Note that this form of the icon element only works when the element is the child of a macro element.
```
<ui:icon>↑</ui:icon>
```