Вирішення проблем

Якщо у вас виникають проблеми з OpenShot, такі як зависання, збій або повідомлення про помилку, існує багато різних методів, які можуть допомогти у їх усуненні.

Використання журналів для усунення проблем

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

OpenShot зберігає два журнали у папці .openshot_qt у вашій домашній теці. У Linux та macOS це розташування записується як ~/.openshot_qt/. Папка може бути прихованою у вашому файловому менеджері.

Два журнальні файли

Файл	Що він записує
openshot-qt.log	Діяльність у редакторі: запуск OpenShot, завантаження проєктів, зміна налаштувань та використання інтерфейсу. Зазвичай це найкраще місце для початку розслідування проблеми.
libopenshot.log	Діяльність відео- та аудіо-двигуна OpenShot, частини, що зчитує медіа та формує зображення і звук для попереднього перегляду та експорту відео. Детальний журнал двигуна допомагає розслідувати проблеми відтворення та експорту.

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

Виберіть, яку частину OpenShot вести в журналі

Відкрийте Редагувати → Налаштування → Додатково, щоб знайти ці два параметри:

Налаштування та відповідні параметри терміналу

Параметр	Відповідний аргумент	Журнальний файл
Журнал налагодження інтерфейсу користувача	--debug-ui	openshot-qt.log
Журнал налагодження відео- та аудіо-двигуна	--debug-engine	libopenshot.log

Обидва параметри за замовчуванням вимкнені, що зберігає звичайні підсумкові повідомлення. Увімкнення одного з них одразу додає деталі до відповідного журналу. Це не змінює інший журнал і не додає повідомлень у термінал. Параметри залишаються увімкненими між запусками, доки ви їх не вимкнете.

Журнал налагодження інтерфейсу користувача — хороший початок для проблем із запуском, завантаженням проєктів, налаштуваннями або інтерфейсом. Журнал налагодження відео- та аудіо-двигуна додає деталі про обробку відео та аудіо, що допомагає розслідувати проблеми відтворення та експорту. Журнали двигуна можуть швидко рости і сповільнювати OpenShot. Увімкніть цей параметр безпосередньо перед повторенням проблеми, а потім вимкніть.

Параметр двигуна раніше називався Режим налагодження (детальний). Збережене увімкнення/вимкнення перенесено на нову назву.

Використовуйте термінал для одного запуску

Термінал — це вікно, де ви вводите команди. Відповідні аргументи вмикають ті ж додаткові деталі, що й параметри, а також відображають їх у терміналі:

openshot-qt --debug-ui

Це записує деталі інтерфейсу для одного запуску. Знайомі опції --debug і коротша -d означають те саме, що і --debug-ui. Для деталей відео- та аудіо-двигуна використовуйте:

openshot-qt --debug-engine

Щоб зібрати обидва типи деталей разом:

openshot-qt --debug-ui --debug-engine

Повторіть кроки, що викликають проблему, потім закрийте OpenShot і зберіть журнали. Ці аргументи не змінюють ваші збережені налаштування. Звичайний запуск OpenShot повертає звичні налаштування журналювання.

openshot-qt.log створює новий файл, коли досягає приблизно 25 МБ, і зберігає три старі копії. libopenshot.log продовжує рости, коли додаються повідомлення. Після збереження потрібних журналів ви можете видалити старі файли журналів, поки OpenShot закритий.

Інші параметри командного рядка

Більшість користувачів потребують лише двох вищезазначених керувань. Наступні опції дозволяють вибрати, скільки деталей записується у файли або відображається в терміналі. Тут console означає вивід у термінал.

Параметри журналювання

Опція	Що вона робить
--debug-ui, --debug, або -d	Увімкнення журналювання налагодження інтерфейсу користувача у файлі та терміналі.
--debug-engine	Увімкнення журналювання налагодження відео- та аудіо-двигуна у файлі та терміналі.
--debug-file	Додає деталі редактора до openshot-qt.log без додавання деталей у термінал.
--debug-console	Додає деталі редактора у термінал без додавання деталей у файл.
--log-level LEVEL	Встановлює рівень деталізації для обох журналів та їх виводу у термінал.
--log-file-level LEVEL	Встановлює рівень деталізації для обох файлів журналів, не змінюючи налаштування терміналу.
--log-console-level LEVEL	Встановлює рівень деталізації в терміналі для редактора та движка, не змінюючи налаштувань файлів.

Замініть LEVEL на debug для детальних повідомлень або info для звичайного підсумку. warning показує попередження та помилки; error показує помилки та критичні збої; critical показує лише критичні збої. off припиняє звичайні повідомлення журналу, але існуючі діагностики збоїв можуть все ще записуватися. Великі літери, такі як DEBUG, також працюють.

Наприклад, щоб збирати детальні повідомлення у обох файлах, залишаючи термінал на звичайному рівні:

openshot-qt --log-file-level debug

Це також увімкне великий журнал движка, тому використовуйте його недовго. Старі опції --debug-file та --debug-console все ще працюють, хоча їх і немає у списку --help.

Змінні середовища

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

Додаткові налаштування середовища

Змінна	Що вона контролює
OPENSHOT_LOG_LEVEL	Деталізація в обох файлах і в терміналі.
OPENSHOT_LOG_FILE_LEVEL	Деталізація лише в обох файлах.
OPENSHOT_LOG_CONSOLE_LEVEL	Деталізація лише в терміналі для обох частин OpenShot.
LIBOPENSHOT_LOG_LEVEL	Деталізація для відео- та аудіодвижка, у його файлі та терміналі.
LIBOPENSHOT_LOG_FILE_LEVEL	Деталізація лише у libopenshot.log.
LIBOPENSHOT_LOG_CONSOLE_LEVEL	Деталізація движка лише в терміналі.

Наприклад, ця команда для терміналу Linux/macOS запитує детальний журнал движка у файлі для одного запуску:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

Якщо налаштування перекриваються, пріоритет мають параметри командного рядка, потім змінні середовища, потім Налаштування, а потім звичайні значення за замовчуванням. Кожен параметр впливає лише на той вихід, який він описує: --debug не замінює налаштування движка. Тимчасові заміни не змінюють збережені налаштування. Наведіть курсор на будь-який прапорець, щоб побачити, чи інше налаштування контролює цей файл журналу.

У налаштуваннях середовища значення LIBOPENSHOT_ мають пріоритет над OPENSHOT_ для движка. У кожній групі рівень лише для файлу або лише для консолі має пріоритет над загальним рівнем. Параметри командного рядка дотримуються того самого правила для файлу/консолі. Конфліктні рівні командного рядка для одного й того ж виходу відхиляються; недійсні рівні середовища повідомляються і ігноруються.

Для старіших скриптів LIBOPENSHOT_DEBUG все ще вмикає детальні повідомлення движка в терміналі, коли він присутній, навіть якщо його значення 0. Новіші налаштування рівня мають пріоритет над ним. LIBOPENSHOT_LOG_FILE призначений для програм, що використовують движок окремо; сам OpenShot використовує вищезазначену папку журналів. Зміна налаштувань журналювання не змінює ваші налаштування звітування про помилки.

Відсутність відповіді Windows 11

Якщо у вас виникає зависання у Windows 11, це відома проблема з PyQt5 і Windows 11, пов’язана з функціями доступності в Qt. Вона виникає при натисканні Ctrl+C в OpenShot (тільки у Windows 11). OpenShot перестане відповідати, і також виникає витік пам’яті (тобто чим довше OpenShot не відповідає, тим більшим стає витік пам’яті, доки OpenShot не зупиниться або користувач не завершить процес).

Простим обхідним шляхом є уникати Ctrl+C у Windows 11 і замість цього використовувати контекстне меню Копіювати/Вставити. Інший спосіб — переназначити «Копіювати» з Ctrl+C на іншу комбінацію, наприклад Alt+C. Ви можете змінити налаштування клавіатури в налаштуваннях OpenShot. Див. Клавіатура.

Налагодження Windows за допомогою GDB

Якщо у вас виникає збій або зависання OpenShot у Windows 10/11, наведені покрокові інструкції допоможуть визначити причину збою. Ці інструкції відобразять стек викликів вихідного коду OpenShot у місці збою. Ця інформація може бути надзвичайно корисною для нашої команди розробників і дуже корисною для додавання до звітів про помилки (для швидшого вирішення).

Встановіть останню щоденну збірку

Перед підключенням налагоджувача завантажте останній випуск OpenShot: https://www.openshot.org/download#daily. Встановіть цю версію OpenShot у стандартне розташування: C:\Program Files\OpenShot Video Editor\. Для детальних інструкцій з налагодження OpenShot у Windows див. цю вікі.

Встановіть MSYS2

Версія OpenShot для Windows компілюється в середовищі під назвою MSYS2. Щоб підключити налагоджувач GDB до нашого виконуваного файлу openshot-qt.exe, спочатку потрібно встановити MSYS2. Цей крок потрібно виконати лише один раз.

1. Завантажте та встановіть MSYS2: http://www.msys2.org/

2. Запустіть командний рядок MSYS2 MinGW x64 (наприклад: C:\msys64\msys2_shell.cmd -mingw64)

3. Оновіть усі пакети (Скопіюйте/Вставте наступну команду):

   pacman -Syu
   

4. Встановіть налагоджувач GDB (Скопіюйте/Вставте наступну команду):

   pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
   

Запустіть OpenShot з налагоджувачем GDB

Запустіть командний рядок MSYS2 MinGW x64 (наприклад: C:\msys64\msys2_shell.cmd -mingw64)

Оновіть PATH (Скопіюйте/Вставте наступні команди):

export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"

Завантажте OpenShot у налагоджувач GDB (Скопіюйте/Вставте наступні команди):

cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe

Запустіть OpenShot з підказки GDB (Скопіюйте/Вставте наступну команду):

run --debug

Вивести інформацію для налагодження

Після успішного запуску OpenShot з підключеним GDB, вам потрібно лише викликати збій або зависання в OpenShot. Коли станеться збій, поверніться до терміналу MSYS2 MinGW64 і виконайте одну з наведених команд (введіть її та натисніть ENTER). Зазвичай першою командою є bt, що означає backtrace. Нижче наведено більше команд.

(gdb) run            (launch openshot-qt.exe)
(gdb) CTRL + C       (to manually break out   OR   wait for a crash / segmentation fault)
(gdb) bt             (Print stack trace for the current thread #)
(gdb) info threads   (to view all threads, and what they are doing. Look for `__lll_lock_wait` for Mutex/deadlocks)
(gdb) thread 35      (Switch to thread number, for example thread 35)

Висока щільність пікселів (DPI) / 4K монітори

OpenShot Video Editor забезпечує надійну підтримку моніторів з високою щільністю пікселів (DPI), гарантуючи чіткий вигляд інтерфейсу та легку читаність на екранах з різними налаштуваннями DPI. Ця підтримка особливо корисна для 4K моніторів та інших дисплеїв з високою роздільною здатністю.

Обізнаність про DPI для кожного монітора

OpenShot враховує DPI для кожного монітора окремо, що означає, що він може динамічно регулювати масштабування залежно від налаштувань DPI кожного підключеного монітора. Це допомагає забезпечити послідовний досвід роботи на різних дисплеях.

Масштабування DPI у Windows

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

• Масштабування 125% округлюється до 100%

• Масштабування 150% округлюється до 200%

Обхідні шляхи для точнішого налаштування

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

• QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough

  • Встановлення цієї змінної середовища може вимкнути округлення та дозволити більш точне масштабування.

  • Примітка: Це може спричинити візуальні артефакти, особливо на часовій шкалі, і не рекомендується.

• QT_SCALE_FACTOR=1.25 (або подібне значення)

  • Ручне встановлення коефіцієнта масштабування може забезпечити більш точне налаштування шрифтів та масштабування інтерфейсу.

  • Це також можна встановити через Налаштування (Масштаб інтерфейсу), але очікуйте проблеми з межами/лініями у Windows при дробових масштабах.

  • Примітка: Цей метод також може призводити до візуальних артефактів і ускладнювати використання OpenShot.

Для отримання додаткової інформації про налаштування цих змінних середовища, будь ласка, відвідайте https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.