Инструменты пользователя
Боковая панель
Это старая версия документа.
Содержание
Работа с иконками меню и элементов
Визуальное оформление элементов графического интерфейса программного комплекса Топоматик Робур осуществляется с помощью файлов растровой графики в формате PNG (Portable Network Graphics). Привязка иконок к элементам интерфейса определяется в plugin-файлах с помощью параметра «icon».
Путь к файлам
Файлы пользовательских иконок располагаются в папке «c:\Program Files\Topomatic Robur <Type> 16.0\Icons».
Правила именования файлов иконок
Имя файла иконки должно соответствовать следующему шаблону:
<IconId>_<Size>dp_<Scale>x.png
| Элемент | Описание |
|---|---|
| <IconId> | Имя иконки. Оно используется в качестве значения параметра «icon» при описании элементов графического интерфейса в plugin-файлах |
| <Size> | Исходный размер иконки. Допускается указывать значения: «16» или «32». Программа ищет файл иконки соответствующего размера в зависимости от значения параметра «size» элемента графического интерфейса. Если для параметра «size» установлены значения «small» или «middle», программа ищет файл с исходным размером 16dp. Для значения «large», ищется размер 32dp. |
| <Scale> | Масштаб указывающий, во сколько раз увеличен размер исходного изображения в этом файле. Допустимые значения: «1»,«1.5»,«2»,«2.5»,«3». Файлы следует масштабировать для корректного отображения иконок при различных значениях плотности точек на дюйм (DPI) в настройках операционной системы. Программа автоматически определяет, какой масштаб необходимо использовать. Если программе не удалось найти файл иконки необходимого ей масштаба, то будет использован файл с масштабом равным «1». |
Пример имени файла иконки
Рассмотрим пример имени пользовательской иконки:
my_custom_icon_32dp_1.5x.png
В данном примере: имя иконки - my_custom_icon, размер исходного файла - 32, масштаб преобразования 1.5.
Размер изображения в файле должен соответствовать размеру исходного файла умноженному на масштаб. Значит изображение иконки в этом файле должно быть 32 * 1.5 = 48 пикселей по высоте и ширине.
Рекомендуемый набор иконок
Для каждой пользовательской иконки рекомендуется создавать файл на каждое возможное сочетание размера и масштаба. Полный набор для одной иконки содержит следующие файлы:
| Имя файла | Размер изображения | Изображение |
|---|---|---|
| my_custom_icon_16dp_1x.png | 16×16 |  |
| my_custom_icon_16dp_1.5x.png | 24×24 |  |
| my_custom_icon_16dp_2x.png | 32×32 |  |
| my_custom_icon_16dp_2.5x.png | 40×40 |  |
| my_custom_icon_16dp_3x.png | 48×48 |  |
| my_custom_icon_32dp_1x.png | 32×32 |  |
| my_custom_icon_32dp_1.5x.png | 48×48 |  |
| my_custom_icon_32dp_2x.png | 64×64 |  |
| my_custom_icon_32dp_2.5x.png | 80×80 |  |
| my_custom_icon_32dp_3x.png | 96×96 |  |
Элементы графического интерфейса использующие иконки
| Элемент | Описание |
|---|---|
| Кнопка | объект содержащий параметр «button» или объект секции "action" |
| Список элементов | объект с массивом элементов «items» |
| Элементы структуры проекта | объект секции "cores" |
| Динамические элементы | объект секции "dynamics" |
| Панель | объект секции "panels" |
Пример plugin-файла
Инструменты страницы
