Модулі/Пускач Qt GUI

Модуль	Ім'я	Версія	Ліцензія	Джерело	Мови	Платформи	Тип	Автор
QTStarter	Qt GUI пускач	5.14	GPL2	ui_QTStarter.so	en,uk,ru,de	x86,x86_64,ARM	Користувацькі інтерфейси	Роман Савоченко
Опис
Надає Qt GUI пускач. Qt-пускач є єдиним та обов'язковим компонентом для всіх GUI модулів, основаних на бібліотеці Qt. Загальна працемісткість: > 10 ЛД[!] Спонсорування, реалізації резервування на 0.5 ЛД[!]: Хайді Рамезані Завдання (To Do): - реалізувати менеджер підпроєктів для їх запуску у окремих процесах, але із їх зберіганням та керуванням у одному конфігураційному файлі проєкту, для високо-надійних конфігурацій; - реалізувати менеджер фонового виконання процесів.

Модуль надає до OpenSCADA пускач GUI модулів, заснованих на багатоплатформеній бібліотеці Qt графічного користувацького інтерфейсу (GUI), початково створеній фірмою TrollTech. Також, модуль реалізує елементи менеджеру проєктів OpenSCADA. Окремий модуль для запуску Qt GUI модулів потрібно через необхідність організації однопотокового виконання всіх компонентів візуалізації Qt та централізованої ініціалізації головного об'єкту Qt-бібліотеки — QApplication.

1 Вступ

Від початку цей модуль створює окремий потік для основного потоку Qt, де є можливість формування екрану динамічної заставки, оскільки основні завдання OpenSCADA продовжують виконання у основному потоці. Та версія Qt5 стала особливо чутливою до виконання у неголовному потоці, тому для неї у OpenSCADA додано таку можливість, але із оновленням повідомлень у заставці із сервісного потоку до та після моменту перемикання на виконання ним первинний завдань. Для контролю цієї можливості передбачено параметр запуску --QtInNotMainThread, який вмикає виконання у неголовному потоці, для Qt4, відтак, по замовченню, здійснюється виконання у головному, що типово для Qt5.

Рис.1. Динамічний екран заставки модуля.

Діалогове вікно пускачу (Рис.2) загалом надає:

• вибір наявних Qt GUI модулів, може бути відсутнім у випадку первинного запуску для обрання лише проєкту OpenSCADA;
• вибір наявних OpenSCADA проєктів для їх обрання або перемикання;
• вихід з OpenSCADA;
• меню допомоги з пунктами: "Про", "Про Qt", "Посібник QTStarter" (F1), "Посібник OpenSCADA 0.9" та "Що це" (Shift+F1).

Рис.2. Діалогове вікно пускачу цього модуля.

У разі відсутності діалогового вікна запуску та всіх вікно модулів Qt GUI, програма може бути запущена або згорнута у системний лоток (Рис.3), створений цим модулем.

Рис.3. Проєкт "АГЛКС", запущений або згорнутий до системного лотка.

Модулем здійснюється відключення функції збереження сеансу програми при примусовому закритті системою, для того щоб запобігти спробам відновлення цього сеансу при старті системи, оскільки OpenSCADA цього не потребує.

Модулем передбачено підтримку емуляції правої клавіші миші для оточень із сенсорним екраном, на кшталт Android, оскільки інтерфейс часто передбачає контроль виключно за допомогою контекстного меню. Емуляція вмикається встановленням параметру командного рядку --simulRightMKeyTm=<tm>, при старті програми, де вказується час утримання (типово дві секунди) натиску лівої клавіші миші (або на екрані) для генерації повідомлення правої клавіші миші та контекстної допомоги. Емуляція правої клавіші не вимикає-відкладає первинних повідомлень лівої клавіші, відтак її загальні дії мають працювати коректно, але можливі невідповідності у місцях де первинне повідомлення щось перемикає та емульоване повідомлення вже піде не за адресою!

2 Qt модулі OpenSCADA

Для запуску Qt GUI модулів використовується розширений інтерфейс виклику функцій модулів. Цей інтерфейс передбачає експортування функцій зовнішніми модулями. У нашому випадку Qt GUI модулі повинні експортувати наступні функції:

• QIcon icon(); — передає об'єкт іконки модуля що викликається, для побудови переліку.
• QMainWindow *openWindow(); — створює об'єкт головного вікна цього Qt GUI модуля та передає його пускачу. Може повертати NULL у випадку неможливості створення нового вікна.

Для ідентифікації, Qt GUI модуль повинен визначити інформаційний елемент модуля "SubType" як "Qt". Виходячи з цієї ознаки "Пускач" з ним працює.

Після отримання об'єкту головного вікна "Пускач" його просто відображає, а вікно модуля може саме додатково додати елементи "Пускача", у вигляді загального переліку Qt модулів OpenSCADA, для їх виклику з цього вікна. Загальний перелік Qt модулів OpenSCADA може додаватися у меню або панель інструментів вікна, шляхом виклику слоту "makeStarterMenu(QWidget *mn = NULL)" класу QApplication від "Пускачу", де у mn вказується віджет контейнеру дій (QAction), або меню головного вікна, для NULL.

Для встановлення Qt GUI модулів, які запускаються при старті, модуль стартеру містить конфігураційне поле "StartMod". У цьому полі записуються ідентифікатори модулів, що запускаються. Конфігураційне поле "StartMod" можна визначити у конфігураційному файлі, а також у системній таблиці БД ("SYS") через діалог конфігурації модуля (рис.4).

У випадку закриття вікон всіх Qt GUI модулів або запуску без визначення модуля для запуску у полі "StartMod", "Пускач" створює власне діалогове вікно (рис.2). Якщо поле "CloseToTray" конфігураційного файлу або конфігурацією модуля (рис.4) встановлено то у цьому випадку відбудеться згортання програми до системного лотку (рис.3).

3 Проєкти OpenSCADA

З інтеграцією до OpenSCADA елементів менеджеру проєктів цей модуль отримав функцію обрання чинних та створення нових проєктів OpenSCADA, у переліку проєктів та команд проєктів (рис.2). Наразі передбачено два режими діалогового вікна пускачу (рис.2), це — режим первинного-ініціюючого запуску та режим виконання обраного проєкту.

Первинний-ініціюючий режим, по факту, є режимом запуску без визначеного проєкту та передбачає саме обрання проєкту для переключення у другий режим, та відповідно приховує перелік Qt GUI модулів, навіть якщо вони завантажені до ініціюючої конфігурації.

У режимі виконання проєкту працюють всі типові механізми, а саме це виклик Qt GUI модулів та запуск-згортання у системний лоток, а діалогове вікно пускачу (рис.2) містить перелік наявних Qt GUI модулів та інформацію про запущений проєкт, у заголовку вікна.

У переліку проєктів користувачу (через контекстне меню) додатково надається можливість видалити невиконувані проєкти, зарезервувати — створити резервну копію, та відновити проєкти із обраної резервної копії.

Окрім безпосередньо назв проєктів у переліку проєктів, праворуч від назви, наведено їх стан — "поточний", "виконується" та "{N} рез.копій". Стан "поточний" означає, що здійснюється виконання саме цього проєкту. Стан "виконується" вказує на наявність файлу блокування багаторазового запуску, а відтак і виконання проєкту, та окремо від цього проєкту якщо поряд не вказано стану "поточний". Обрати та спробувати перемкнутися на проєкт у стані "виконується" можна, прийнявши попередження, але якщо цей проєкт реально зараз виконується і наявність файлу блокування не є залишковим після аварійного завершення програми то програма, що перемикається, просто завершиться! Стан "{N} рез.копій" вказує на наявність визначеної кількості резервних копій проєкту.

4 Вигляд та відчуття

У зв'язку із розширенням меж використання OpenSCADA на мобільні програмні платформи на кшталт Maemo, MeeGo, Android та частих випадків невідповідності вигляду програм на бібліотеках Qt4 та Qt5 до сучасних оточень робочого столу, цей модуль було розширено власним механізмом контролю вигляду та відчуттів кінцевого візуального інтерфейсу.

Загалом, модуль наразі передбачає контроль за загальним: стилем віджетів Qt, основним шрифтом, палітрою інтерфейсу та таблицями каскадних стилів. Цей контроль здійснюється через параметри конфігураційного файлу "Style", "Font", "Palette", "StyleSheets" та конфігурацією модуля (рис.4).

Також, модулем передбачено оформлення напрацювань окремих видів та відчуттів у бібліотеці композитного характеру, яка формується у таблиці конфігураційного файлу зі структурою: LookFeel(NAME, FONT, STYLE, PALETTE, STL_SHTS).

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

5 Configuration

To configure the functions shown above, the module provides the ability to configure their parameters through the OpenSCADA control interface (Fig. 4):

• Section "Module options":
  • Qt modules for startup.
  • Collapse or startup to the system tray.
  • Sessions control-restart — that is applied at the next start and works only for directly started projects without the starter dialog window (Fig.2) of the module. The modes are supported:
    • "if running" — if it is still running when the session is shut down;
    • "anyway" — wants to be started at the start of the next session; on most Linux/X11 desktops that is the same as "if running";
    • "immediately" — wants to be started immediately whenever it is not running; on most Linux/X11 desktops that is the same as "if running";
    • "never" — does not want to be restarted automatically.
• Section "Look and feels", changes are not applied immediately and require overload:
  • Known profiles — a combobox with a list of profiles in the library and a series of commands over the current profile:
    • "<Clear>" — clear the current profile;
    • "<Read back>" — read back the profile from the current Qt settings, only in the cleaned profile items.
    • "{Profile name}" — read the value from the specified profile name and add-combine with the current one if it is not empty.
  • Widgets style — the profile field allows you to select from the list known styles in this configuration Qt and is not composite.
  • Common font — the Qt common font which specifies icons size also.
  • Palette — the field of the color profile of the interface in three groups of rows: active, disabled, inactive. But with twenty colors in the group line, separated by the character ',': WindowText(0), Button(1), Light(2), Midlight(3), Dark(4), Mid(5), Text(6), BrightText(7), ButtonText(8), Base(9), Window(10), Shadow(11), Highlight(12), HighlightedText(13), Link(14), LinkVisited(15), AlternateBase(16), NoRole(17), ToolTipBase(18), ToolTipText(19). The profile allows you to define only the colors you want, leaving the indeterminate as the empty ones, which determines the composite palette, that is filling the voids with another library profile.
  • Style Sheets — the field of Cascading Style Sheets Profile (CSS), the composite of which is to add CCS rules at the end of the current profile.

Рис.4. Сторінка конфігурації модуля.

6 API програмування користувача

Об'єкт модуля (SYS.UI.QTStarter)

• Array sensors() — отримати всі наявні сенсори від Qt mobility, повертає "false" якщо не доступно жодного сенсору.