Directory Opus Manual

Icon Categories

Directory Opus groups its internal icon set into categories to make it easier for the user to find a particular icon. The Select Icon dialog lets the user filter by category as well as by icon name.

The internal icons all have pre-assigned categories. If your icons use the same names as the internal ones, they will be placed in the same categories automatically. For example, the copy icon is pre-assigned to the file category, so if your icon set provides an icon called copy it will be placed in the file category as well. The icon names used by internal icons cannot be moved into different categories, and you must give your icons different icon names if you want them in different categories.

If your icon has a name that is not used by the internal icon set, it will in the Uncategorized category by default. It is possible, but not obligatory, to specify your own categories for your icons.

The default icon categories used by Opus are:

Category Name	English Display Name
config	Configuration
edit	Edit
file	File
ftp	FTP
go	Navigation
imageviewer	Image Viewer
misc	Miscellaneous
tools	Tools
view	View
window	Window

The category name is what you should use to specify a category in your icon set XML. The English display name is how the category is displayed to the user, if they are using English. The display name will be different in other languages.

For each icon, you can optionally specify one of the default categories, or define your own custom category. 

You can assign categories to your icons on an icon-by-icon basis, using the icon node, or to a number of icons at once, using the set node. For example,

<set size="small" width="20" height="20" filename="UtilIcons.png">
    <icon name="burncd" row="2" col="8" category="Tools"/>
    <icon name="ftpimage" row="3" col="1" category="Image"/>
</set>

This would define an icon called “burncd” in the “Tools” default category, and another called “ftpimage” in a custom category called “Image”.

Alternatively, both these icons could be placed in the “File” category as follows:

<set size="small" width="20" height="20" filename="UtilIcons.png">
    <category name="File">
        <icon name="burncd" row="2" col="8" />
        <icon name="ftpimage" row="3" col="1" />
    </category>
</set>

You must use one style or the other within a given set . If any category nodes are present then all icon nodes should be under a category. If you want to use the second style but also want some uncategorized icons, you should put them in a category node that does not have a name attribute.

Again, it is not essential to categorize your icons. If you use the default icon names they will be categorized automatically (although you can override the automatic categorization if desired), and if not they will still work, but be listed as “Uncategorized” in the Select Icon dialog.