Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Решение распространенных проблем

В разделе представлены инструкции по устранению проблем, возникающих при создании проекта Alpha.HMI. Раздел находится в разработке и будет дополняться.

Снижение производительности из-за высокого потребления памяти экземплярами типов

В Alpha.HMI каждый экземпляр типа занимает определенный объем памяти. Размер, занимаемый экземпляром, зависит от его типа и совокупного размера его дочерних экземпляров.

Типы с большим количеством дочерних элементов (например, массивы из десятков тысяч элементов) создают экземпляры большого размера, что может влиять на:

  • Скорость конструирования экземпляров.
  • Общее потребление памяти приложением.
  • Производительность проекта в целом.

Как просматривать размер экземпляров

Для мониторинга размеров экземпляров используйте окно Контрольные значения во время исполнения проекта.

  1. Запустите форму на исполнение.
  2. Откройте окно Обзор.
  3. Добавьте нужный экземпляр в окно Контрольные значения одним из способов:
    1. Щелкните правой кнопкой мыши по элементу в окне Обзор и выберите Добавить контрольное значение.
    2. дважды щёлкните по нему левой кнопкой мыши.

При добавлении экземпляра в окно Контрольные значения автоматически отображается информация о его размере в специальных колонках мониторинга размера:

  • Размер — размер тела экземпляра (в байтах).
  • Размер в лэйауте — размер тела экземпляра с учётом служебных накладных расходов на размещение в лэйауте родительского экземпляра (в байтах).

Ошибки при превышении лимита GDI в Windows

GDI (Graphics Device Interface) — это системный компонент Windows, который отвечает за отображение графических объектов в приложениях. В Alpha.HMI, когда вы создаете формы с различными графическими компонентами (например, кнопками или полями ввода), Windows выделяет объекты GDI для управления этими компонентами. Однако в Windows существует ограничение — не более 10,000 таких объектов на одно приложение.

В Alpha.HMI версии 2.0.6 для различных графических компонентов установлены следующие значения потребления GDI-объектов:

Веб-содержимое 15 объектов
Выпадающий список 14 объектов
Дерево 8 объектов
Индикатор прогресса 8 объектов
Компонент Alpha.Alarms 14 объектов
Компонент Alpha.Trends 6 объектов
Поле ввода 8 объектов
Ползунок 8 объектов
Редактор текста 8 объектов
Системная кнопка 8 объектов
Флажок 8 объектов
Фрейм 18 объектов

Если вы создаете форму с большим количеством графических элементов, это может привести к превышению лимита объектов GDI, что вызывает ошибки отображения или даже критическое завершение Alpha.HMI.

Как избежать ошибок связанных с превышением GDI

  1. Оптимизируйте структуру проекта. Например, если форма содержит слишком много графических элементов, разделите её на несколько отдельных форм.
  2. Увеличьте лимит объектов GDI. Если вам необходимо поддерживать больше графических элементов, вы можете увеличить лимит объектов GDI, изменив параметр GDIProcessHandleQuota в реестре Windows.

Как изменить лимит GDI в реестре Windows:

  1. Откройте редактор реестра (нажмите Win + R, введите regedit).
  2. Перейдите по пути:
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Windows
  3. Найдите параметр GDIProcessHandleQuota.
  4. Измените его значение на нужное, но не превышающее 50,000.
  5. Перезагрузите компьютер для применения изменений.

Линия не отображается или выглядит как точка

При работе с компонентами Линия, Кривая линия и Соединительная линия может возникнуть ситуация, когда созданная линия не отображается на форме или выглядит как маленькая точка. Ниже приведена таблица с описанием признаков, причин и способов их устранения.

Признаки на форме Причина Как исправить
Линия не видна на форме 1. При редактировании удалены все точки линии.

В Структуре объекта выберите линию → в контекстном меню Создать точку → задайте координаты X, Y.

2. Создан новый тип на основе линии, но в нём изначально нет точек.

В режиме редактирования типа: в Структуре объекта выберите линию → в контекстном меню выберите Создать точку → задайте координаты X, Y .

Либо на форме нажмите F2 и добавьте точки щелчками.

На форме видна маленькая точка Линия является вырожденной, то есть состоит из одной точки или из нескольких точек с одинаковыми координатами, поэтому выглядит как точка.

Выберите линию на форме (кликните по точке) → нажмите F2 → добавьте новые точки щелчками или переместите существующую.
Либо в Структуре объекта выберите линию → в контекстном меню Создать точку → задайте координаты X, Y.