~~Title: Icon Set XML Definition File ~~
<pageheader/>

The XML file defines the icons that make up the icon set. Below is an example of an Icon Set .xml file: 

\\
<code>
<?xml version="1.0"encoding="utf-8"?>
<iconset name="sample">
    <display_name>SampleI con Set</display_name>
    <copyright>(c)2007 Fred Bloggs Productions</copyright>
    <artist>Fred Bloggs</artist>
    <set size="small" width="20" height="20" filename="MyIconsSmall.png">
        <icon name="copy" row="1" col="1" />
        <icon name="move" row="1" col="2" />
    </set>
    <set size="large" width="32" height="32" filename="MyIconsLarge.png">
        <icon name="copy" row="1" col="1" />
        <icon name="move" row="1" col="2" />
    </set>
</iconset></code>



The root node of the definition file is called `iconset`. The `name` attribute given here specifies an internal name that is used for this set. This is never shown to the user, but is used internally for referencing icons the user has configured in their toolbar. It is important that you pick a unique name for your icon set – if two icon sets with the same internal name are installed, their contents will be merged together as if they were one big set.



Several values below the root node let you specify icon set metadata – **display_name** is the name of the set that is actually displayed to the user, and **copyright** and **artist** are strings that are shown in the list of Icon Sets in Preferences.

Following this, the **set** nodes are used to specify one or more icons in the set. Each icon set can contain one or two distinct groups of icons – a **small** group and a **large** group. The **size** attribute to the **set** node specifies which icon size is being defined, and the **width** and **height** attributes define the actual pixel sizes of the icons. The **filename** attribute specifies the image file that this group of icons is drawn from.

Below each **set** node are one or more **icon** nodes which define the individual icons that make up the set. Each icon must have a name specified with the **name** attribute, and its row and column within the image file given with the **row** and **col** attributes.