https://docs.dopus.com/ 2026-08-24T02:29:16+00:00 https://docs.dopus.com/ https://docs.dopus.com/lib/exe/fetch.php?media=logo.png text/html 2023-10-22T16:05:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:dpi_aware_icon_sets&rev=1697990733&do=diff DPI aware Icon Sets Directory Opus handles different system DPI settings transparently, and will scale icons as needed. However, you may want to provide multiple base icon images in your icon sets to handle different DPI settings. Scaling often results in blurry and unsatisfactory images - providing the same icons in multiple resolutions can result in a better aesthetic result when the user is running on a high-DPI system. text/html 2025-12-08T11:04:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:icon_categories&rev=1765191882&do=diff 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 text/html 2023-10-22T15:47:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:icon_display_names&rev=1697989620&do=diff Icon Display Names By default, the names given to each icon are shown to the user when they hover over each image in the Select Icon dialog. If desired, you can specify a “display name” for each icon, which is displayed alongside the icon’s real name. text/html 2023-10-22T16:10:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:icon_images&rev=1697991049&do=diff Icon Images As mentioned above, the actual image data for your icons can be supplied in any image format that Directory Opus understands. The most common of these would be JPEG, PNG, GIF and BMP. Any number of separate image files can be used, and each image file can provide one or more icons. text/html 2026-03-19T05:48:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:icon_keywords&rev=1773899330&do=diff Icon Keywords Individual icons can be given optional keywords to make it easier for the user to find them in your icon set. The keywords aren't displayed, but are used when the user searches for an icon by name. Individual keywords should be separated by semi-colons. text/html 2025-12-01T18:08:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:icon_names&rev=1764612519&do=diff Icon Names Every icon in an icon set must have a name. The name is used for two things – it lets the user search for icons in the Select Icon dialog, and it is stored in the toolbar configuration and used internally by Opus to identify which icon the user has configured for a given button. text/html 2023-10-22T16:05:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:icon_set_xml_definition_file&rev=1697990757&do=diff Icon Set XML Definition File The XML file defines the icons that make up the icon set. Below is an example of an Icon Set .xml file: <?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" co… text/html 2023-10-22T16:07:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:icon_sizes&rev=1697990831&do=diff Icon Sizes As already mentioned, each icon set can contain one or two distinct groups of icons. For simplicity, these are referred to as the size and the size. However, you are not limited to only two sizes of icon-only two groups of icons. It is possible to have different icons of multiple sizes within the one group. For example, text/html 2023-10-22T16:09:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:localization&rev=1697990976&do=diff Localization The Icon Set format optionally supports localization of both the icon display names and custom icon category names. To localize your custom icon names, you need to specify one or more nodes in the definition XML file. For example, <iconset name="sample"> <language_map language="deutsch"> <icon name="ftpimage" display_name="Hochladen Sie dieses Bild" /> <category name="Image" display_name="Bild" /> </language_map> <language_map language="francais"> … text/html 2026-06-29T00:52:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://docs.dopus.com/doku.php?id=reference:icon_sets:svg_icon_sets&rev=1782694379&do=diff SVG Icon Sets As well as an icon set referring to external images, an icon set can be based on SVG code. Unlike traditional icon sets that use one or more bitmaps with a grid of icons, SVG icon sets store the SVG code directly in their XML definition file, making them completely self-contained. SVG icons will scale automatically, and if rendered using "currentColor" in the SVG will use the toolbar's default text color automatically.