5.11.1. Общие положения

Application Server предоставляет следующие способы работы с изображениями, используемыми в прикладных приложениях:

  1. Коллекции изображений - наборы изображений, объединённых в виде спрайта изображений и хранящихся в ресурсах Application Server или в базе данных прикладного проекта. Используются для быстрого и централизованного доступа к большому количеству однотипных изображений по индексу.

  2. Изображения ресурсов прикладного проекта - отдельные файлы изображений, хранящиеся в каталоге КореньПроекта/Модуль/src/main/resources прикладного проекта. Используются для хранения уникальных или редко используемых изображений, которые нецелесообразно добавлять в коллекции изображений, так как они предназначены исключительно для конкретного прикладного проекта.

See also

Pascal API

5.11.1.1. Сравнение способов

Характеристика

Коллекции изображений

Изображения ресурсов прикладного проекта

Место хранения

${G3_HOME}/server/resources/imagecollection/ или таблица BTK_COMPONENT базы данных прикладного проекта

КореньПроекта/Модуль/src/main/resources

Поддерживаемые форматы

.png, .svg

.jpeg, .jpg, .png, .ico, .svg

Доступ к данным

  1. EngineEndpoint.get_image

  2. Сервис загрузки коллекций изображений

  1. EngineEndpoint.get_resource_image

  2. Сервис загрузки ресурсных файлов

Назначение

Набор однотипных изображений

Единичные или уникальные изображения

Требования к размеру

Единый размер для всех изображений коллекции

Нет

Производительность при массовом доступе

Высокая (все изображения передаются в составе одного спрайта)

Низкая (каждое изображение запрашивается отдельно)

5.11.1.2. Рекомендации по выбору

Используйте коллекции изображений, если:

  • Требуется быстрый доступ к большому набору изображений.

  • Важно уменьшить количество сетевых запросов.

  • Все изображения имеют одинаковый размер.

  • Все изображения схожи по смыслу и назначению. Например: коллекция изображений, используемых в кнопках редактора - editbuttons, коллекция изображений панели инструментов - toolbarprimary.

Используйте изображения ресурсов прикладного проекта, если:

  • Графика уникальна для конкретного прикладного проекта.

  • Изображений мало, нет смысла собирать их в коллекцию.

  • Необходимо гибко обновлять отдельные файлы без обновления коллекции изображений.