> For the complete documentation index, see [llms.txt](https://chaoses-ib.gitbook.io/directory-opus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-7/icon_images.zh.md).

# 图标图像

如上所述，图标的实际图像数据可以通过 Directory Opus 识别图片格式从任何图片格式中提供。其中最常见的格式为 JPEG、PNG、GIF 和 BMP。可以使用任意数量的独立图像文件，每个图像文件可以提供一个或更多的图标。

假设你有图像文件 “MyIcons.png”，大小为 100x20 像素，并包含 5 个不同图标的图像。因此，每个单独的图标大小为 20x20 像素。在 XML 定义文件中，你将有一个该图像文件的 `set` 条目，然后为每个图标设置最多五个 `icon` 条目。使用 `row` 和 `col` 属性指定每个图标的图像数据的位置。例如，

```
<set size="small" width="20" height="20" filename="MyIcons.png">
    <icon name="icon1" row="1" col="1" />
    <icon name="icon2" row="1" col="2" />
    <icon name="icon3" row="1" col="4" />
    <icon name="icon4" row="1" col="5" />
</set>
```

这将从图像文件添加四个图标 - 前两个和后两个，跳过第三个。

请注意，图像文件也可以只包含单个图像。例如，假设你有一些单图像图标集合，你想将它们组合在一起作为图标集。你只需指定多个 `set` 节点，每个图像文件一个，且每个 `set` 节点包含一个引用第 1 行、第 1 列的单 `icon` 节点。

使用 PNG 或 GIF 格式提供的图像自动支持透明度 - GIF 支持单透明颜色，PNG 支持完全 32 位 alpha。如果你想以不同格式提供透明图标，你可以指定 `transparent="yes"` 作为 `set` 节点的属性。随后，Opus 会使图像中 RGB 值为 255,0,255 (#FF00FF) 的所有像素变得透明。

以 “:INTERNAL:” 开头的文件名引用存储在程序内部的内部图像资源。通常你不会自己使用内部图像，但你可能会看到它用在特殊图标集中，这些图标集通常由 GP 软件创建。
