Alpha.Community

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

Динамика и проигрывание звуков

Alpha.HMI предоставляет набор компонентов для применения динамики и проигрывания звуков на мнемосхеме. Под динамикой подразумевается:

  • мигание графических объектов, например задвижек;
  • циклическое выполнение каких-либо процедур, например обновление локального времени.

Выполнение процедур по таймеру

Чтобы выполнять процедуру с заданной периодичностью, используйте компонент Таймер. Компонент невизуальный и виден только в области Структура объекта.

Компонент позволяет циклически выполнять процедуру (определяется в обработчике события OnTimer), которая повторяются с заданной периодичностью (свойство Период).

Как настроить таймер для автоматических действий (Демо-проект)

Далее кратко описан пример (скачать его можно здесь) использования компонента Таймер для выполнения различных действий через заданные промежутки времени в проекте Alpha.HMI с использованием языка Alpha.Om.

В результате этого примера будет подготовлена форма с возможностью:

Автоматическое увеличение значения счётчика каждую секунду

Чтобы настроить увеличение счётчика каждую секунду и отобразить его на форме:

  1. Добавьте на форму компонент Таймер и настройте его свойства:

    • Установите значение свойства Активность в true, чтобы активировать таймер.
    • В поле Период задайте интервал выполнения событий, например, 1000 мс, чтобы действия выполнялись каждую секунду.

  2. Добавьте объект типа int4 на экранную форму и назовите его, например, counter. Этот объект будет использоваться для хранения значения счетчика.

    1. Для этого в Структуре объекта щелкните правой кнопкой мыши на MainForm → Создать. Откроется мастер создания элементов.

    2. В поле Тип элемента выберите Поле. В поле Базовый тип элемента → int4 → Создать.

  3. Добавьте текстовое поле для отображения текущего значения счетчика.

  4. В обработчике события OnTimer компонента Таймер добавьте код для увеличения значения переменной на 1 и вывода его в текстовое поле. Пример кода:

    counter += 1; // Увеличиваем значение переменной-счетчика на 1
    Text_1.Text = "Текущее значение счетчика: " + String.ToString(counter); // Выводим значение в текстовое поле

Перемещение графического объекта

Чтобы создать анимацию, при которой объект перемещается по экрану:

  1. Добавьте на форму объект (например, прямоугольник).

  2. Добавьте на форму компонент Таймер и настройте его свойства:

    • Установите значение свойства Активность в true, чтобы активировать таймер.

    • В поле Период задайте интервал выполнения событий, например, 100 мс.

  3. В обработчике события OnTimer компонента Таймер добавьте код для изменения позиции прямоугольника на несколько пикселей при каждом срабатывании таймера. Пример кода:

    // Смещение по X
    Rectangle_1.X += 5;
    //Если объект выходит за пределы формы, возвращаем его в начальную позицию
    if (Rectangle_1.X > here.Width)
    {
    Rectangle_1.X = 0;
    }

Мигание графических объектов

Чтобы добавить эффект мигания графическим объектам, используйте компонент Мигание. Компонент невизуальный и виден только в области Структура объекта.

Компонент позволяет графическим элементам с заданной периодичностью (свойство Период) изменять:

  • Цвет заливки (свойство Цвет заливки)
  • Цвет внешней границы (свойство Цвет пера)
  • Цвет шрифта (свойство Цвет шрифта, если элемент содержит текст).

Цвет будет циклически чередоваться от стандартного цвета элемента к цвету, установленному в свойствах компонента Мигание.

Как настроить мигание графического объекта (Демо-проект)

Далее кратко описан пример (скачать его можно здесь) использования компонента Мигание для создания визуального эффекта мигания на графическом объекте в проекте Alpha.HMI с использованием языка Alpha.Om.

В примере показано, как:

  • Регулировать частоту мигания с помощью ползунка.

  • Переключать цвет мигания с помощью взаимозависимых флажков.

  • Управлять миганием с помощью кнопок для включения и выключения эффекта.

В результате получится форма, где можно управлять цветом мигания с помощью флажков, настраивать частоту мигания с помощью ползунка, а также запускать и останавливать мигание с помощью двух кнопок.

Регулирование частоты мигания с помощью ползунка

  1. Создайте графический объект на форме (например, задвижку) и добавьте к нему компонент Мигание.

  2. Добавьте на форму компонент Ползунок, чтобы управлять частотой мигания, и настройте его свойства:

    • Установите начальное значение свойства Значение, например, в 600 мс.
    • Задайте диапазон с помощью свойств Минимальное значение — 100 мс и Максимальное значение — 1500 мс, чтобы период мигания можно было регулировать.

  3. Чтобы регулировать скорость мигания ползунком, установите для свойства Период компонента Мигание вычисляемое значение.

Переключение цвета мигания с помощью флажков

  1. Добавьте на форму два флажка для выбора цвета мигания.

  2. Чтобы при активации одного флажка другой автоматически отключался, настройте обработчики события StateChanged для каждого флажка. Это позволит переключать цвет мигания объекта между двумя заданными вариантами.

    1. В обработчике события StateChanged первого флажка пропишите следующий код:

      if (state)
      {
      Line_1.Blinker_1.BrushColor = 0xffffff7f; // Цвет для первого флажка (желтый)
      Checkbox_2.State = false; // Отключаем второй флажок
      }
    2. В обработчике события StateChanged второго флажка пропишите следующий код:

      if (state)
      {
      Line_1.Blinker_1.BrushColor = 0xffff7860; // Цвет для второго флажка (красный)
      Checkbox_1.State = false; // Отключаем первый флажок
      }

Управление миганием с помощью кнопок

  1. Добавьте на форму две кнопки: одну для запуска мигания, вторую — для его остановки.

  2. В обработчике события ButtonPressed кнопки Button_1 пропишите код для активации мигания:

    Line_1.Blinker_1.Active = true;
  3. В обработчике события ButtonPressed кнопки Button_2 пропишите код для остановки мигания и сброса настроек к исходным:

    Line_1.Blinker_1.Active = false; // Отключаем мигание объекта
    Line_1.Blinker_1.BrushColor = 0xffcecece; // Сбрасываем цвет заливки к исходному
    Checkbox_1.State = false; // Сбрасываем первый флажок
    Checkbox_2.State = false; // Сбрасываем второй флажок
    Slider_1.Value = 600; // Устанавливаем начальное значение для ползунка

Проигрывание звуков

Чтобы добавить звуки на мнемосхему, используйте компонент Звук. Компонент невизуальный и виден только в области Структура объекта.

После добавления компонента Звук на экранную форму, укажите в свойстве Путь до файла путь к звуковому файлу, который вы хотите проигрывать. Вы можете сделать это вручную или выбрать файл через диалоговое окно, нажав кнопку ... рядом с полем ввода. Если выбранный файл не находится в папке ресурсов проекта, он будет автоматически скопирован в эту папку.

Компонент Звук поддерживает файлы формата WAV с кодировками:

  • WAVE_FORMAT_PCM;
  • WAVE_FORMAT_IEEE_FLOAT;
  • WAVE_FORMAT_EXTENSIBLE.

Чтобы звук начал проигрываться в рантайме, переключите свойство Активность в состояние true.

Для проигрывания очереди звуков используйте обработчики событий LoopPlayed (завершение одного цикла проигрывания звука) или AllLoopsPlayed (завершение всех циклов проигрывания звука).

Как настроить воспроизведение очереди звуков (Демо-проект)

Далее кратко описан небольшой пример (скачать его можно здесь) использования компонента Звук в проекте Alpha.HMI с использованием языка Alpha.Om.

В примере показано, как:

  • Построить очередь звуков для последовательного воспроизведения нескольких файлов.
  • Запускать и останавливать воспроизведение звуков с помощью кнопок Начать воспроизведение и Остановить воспроизведение
  • Обрабатывать ситуацию с отсутствием или повреждением звукового файла, записывая ошибки в журнал времени исполнения.

В результате будет подготовлена форма, позволяющая по нажатию кнопки проигрывать несколько звуков по очереди, а также отлаживать ошибки воспроизведения, если файлы отсутствуют или повреждены.

Убедитесь, что в папке resources вашего проекта находятся три звуковых файла с именами: Kick_1.wav, Kick_2.wav, Kick_3.wav.

Эти файлы будут использованы в примере для воспроизведения по очереди.

Построение очереди звуков и их воспроизведение

  1. Добавьте на форму компонент Звук для воспроизведения звуков.

  2. Добавьте две кнопки: Button_1 для начала воспроизведения и Button_2 для его остановки.

  3. Добавьте текстовое поле для отображения количества срабатываний события LoopPlayed.

  4. Добавьте объект типа int4 на экранную форму. Этот объект будет использоваться для хранения количества воспроизведенных циклов. Для этого в Структуре объекта правой кнопкой мыши щелкните на MainForm → Создать. Откроется мастер создания элементов.

    1. В поле Тип элемента выберите Поле, Базовый тип элемента→ int4→ Создать.

  5. В обработчике события LoopPlayed компонента Звук пропишите следующий код, который будет управлять переключением звуков по очереди:

    int4_1 = int4_1 + 1; // Увеличить счетчик срабатываний
    Text_1.Text = "Воспроизведено звуков: " + Str.ToString(int4_1); // Обновить текстовое поле с пояснением
    if (int4_1 == 1) {
    Sound_1.Path = "Kick_2.wav"; // Переключиться на второй звук
    Sound_1.Active = true;
    }
    else if (int4_1 == 2) {
    Sound_1.Path = "Kick_3.wav"; // Переключиться на третий звук
    Sound_1.Active = true;
    }
    else if (int4_1 == 3) {
    int4_1 = 0;
    Sound_1.Active = false; // Остановить после третьего звука
    }

Управление воспроизведением звуков с помощью кнопок

Для управления воспроизведением звуков в проекте используйте две кнопки: Button_1 для начала воспроизведения и Button_2 для его остановки.

  1. В обработчике события ButtonPressed кнопки Button_1 пропишите следующий код:

    int4_1 = 0; // Обнулить счетчик
    Sound_1.Path = "Kick_1.wav"; // Указать первый звук
    Sound_1.Active = true; // Начать воспроизведение
  2. В обработчике события ButtonPressed кнопки Button_2 пропишите следующий код:

    int4_1 = 0; // Обнулить счетчик
    Sound_1.Active = false; // Остановить воспроизведение

Обработка ошибок воспроизведения

Для отслеживания ошибок используйте событие ErrorStateChanged, которое срабатывает при изменении значения свойства Состояние ошибки. Ошибки могут возникнуть, например, если звуковой файл отсутствует или поврежден.

Чтобы настроить вывод ошибок:

  1. Добавьте на форму компонент Средство отладки.

  2. В обработчике события ErrorStateChanged пропишите следующий код:

    if (errorState != 0) {
    errorDescription: string = Sound_1.GetErrorStateAsString(errorState); // Получить описание ошибки
    DebugTool_1.Log("Ошибка воспроизведения: " + errorDescription); // Записать в журнал
    Sound_1.Active = false; // Остановить воспроизведение при ошибке
    }

    В этом коде строковое описание ошибки извлекается с помощью метода GetErrorStateAsString(), затем оно записывается в журнал с помощью компонента Средство отладки, после чего воспроизведение звуков останавливается, если произошла ошибка.