Difference between revisions of "Modules/QTStarter/uk"

Revision as of 21:47, 27 August 2022

Модуль надає до 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 Конфігурація

Для конфігурації функцій, що наведено вище, модулем надається можливість налаштування їх параметрів за посередництвом інтерфейсу управління OpenSCADA (Рис.4):

• Секція "Опції модуля":
  • Модулі Qt для запуску.
  • Згортати або запускати у системний лоток.
  • Керування-перезапуск сеансів — застосовується при наступному запуску та працює лише для прямо запущених проєктів без діалогового вікна пускачу (Рис.2) цього модуля. Підтримуються режими:
    • "якщо виконується" — якщо він все ще виконується коли сеанс вимикається;
    • "завжди" — бажає бути запущеним із запуском наступного сеансу; на більшості Linux/X11 стільниць це те саме, що й "якщо виконується";
    • "негайно" — бажає бути запущеним негайно коли не виконується; на більшості Linux/X11 стільниць це те саме, що й "якщо виконується";
    • "ніколи" — не бажає перезапускатися автоматично.
• Секція "Вигляд та відчуття", зміни тут не застосовуються одразу та вимагають перевантаження:
  • Відомі профілі — комбобокс з переліком профілів у бібліотеці та низка команд над поточним профілем:
    • "<Очистити>" — очистити поточний профіль;
    • "<Прочитати назад>" — прочитати профіль з поточних налаштувань Qt, тільки у очищені елементи профілю.
    • "{Ім'я профілю}" — прочитати значення з вказаного за ім'ям профілю та додати-скомбінувати з поточним, якщо він не порожній.
  • Стиль віджетів — поле профілю, передбачає можливість обрання з переліку відомих у цій конфігурації Qt та не є композитним.
  • Загальний шрифт — загальний шрифт Qt, який також визначає розмір іконок.
  • Палітра — поле профілю кольорів інтерфейсу у трьох групах за рядками: активна, вимкнена, неактивна. Та з двадцятьма кольорами у групі-рядку, поділені символом ',': 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). Профіль допускає визначення тільки потрібних кольорів, залишаючи невизначені порожніми, та саме це визначає композитність палітри, а саме — заповнення порожнеч іншим профілем бібліотеки.
  • Сторінки стилів — поле профілю каскадних таблиць стилів (CSS), композитність якого полягає у доданні CCS правил у кінець поточного профілю.

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

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

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

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