トラブルシューティング

OpenShotでフリーズ、クラッシュ、エラーメッセージなどの問題が発生している場合、問題解決に役立つさまざまな手法があります。

Windows 11が応答しない

Windows 11でフリーズが発生する場合、これはPyQt5とWindows 11の既知の問題で、Qtのアクセシビリティ機能に関連しています。これはOpenShotで Ctrl+C を押すことで発生します（Windows 11のみ ）。OpenShotが応答しなくなり、メモリリークも発生します（つまり、OpenShotが応答しない時間が長くなるほどメモリリークが大きくなり、最終的にOpenShotがクラッシュするか、ユーザーがプロセスを終了させるまで続きます）。

簡単な回避策として、Windows 11では Ctrl+C を避け、代わりに右クリックのコピー/貼り付けメニューを使用してください。別の回避策として、「コピー」のキー割り当てを Ctrl+C から別のキー（例： Alt+C ）に変更することもできます。キーボードの割り当てはOpenShotの設定で変更可能です。詳細はキーボードを参照してください。

WindowsでのGDBによるデバッグ

Windows 10/11でOpenShotがクラッシュまたはフリーズする場合、以下の手順に従うことでクラッシュの原因を特定できます。これらの手順は、クラッシュ箇所のOpenShotのソースコードのスタックトレースを表示します。この情報は開発チームにとって非常に有用であり、バグ報告に添付すると迅速な解決に役立ちます。

MSYS2をインストールする

Windows版OpenShotはMSYS2という環境を使ってコンパイルされています。GDBデバッガを実行ファイル openshot-qt.exe に接続するには、まずMSYS2をインストールする必要があります。この手順は一度だけ行えば十分です。

MSYS2をダウンロード＆インストール: http://www.msys2.org/
MSYS2 MinGW x64 コマンドプロンプトを起動します（例：C:\msys64\msys2_shell.cmd -mingw64 ）
すべてのパッケージを更新する（以下のコマンドをコピー＆ペースト ）:
```
pacman -Syu
```
GDBデバッガをインストールする（以下のコマンドをコピー＆ペースト ）:
```
pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
```

GDBデバッガでOpenShotを起動する

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"

GDBデバッガにOpenShotを読み込む（以下のコマンドをコピー＆ペースト ）:

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

GDBプロンプトからOpenShotを起動する（以下のコマンドをコピー＆ペースト ）:

run --debug

デバッグ情報を表示する

GDBを接続してOpenShotが正常に起動したら、OpenShotでクラッシュやフリーズを発生させてください。クラッシュが発生したら、MSYS2 MinGW64のターミナルに戻り、以下のコマンドのいずれかを入力してENTERを押します。通常、最初に入力するコマンドは bt （バックトレースの意味）です。その他のコマンドも以下に記載されています。

(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設定に応じてスケーリングを動的に調整できます。これにより、異なるディスプレイ間で一貫した操作感が得られます。

WindowsでのDPIスケーリング

Windowsでは、OpenShotは視覚的な整合性を保つためにスケーリング係数を最も近い整数値に丸めます。これによりUIの視覚的な乱れを防ぎ、インターフェース要素を鮮明かつ整然と保ちます。この丸め処理のため、一部のスケーリング設定では予想より大きなフォントやUI要素になることがあります。

125% のスケーリング は 100% に丸められます
150% のスケーリング は 200% に丸められます

細かい調整のための回避策

丸め処理はクリーンなインターフェースを維持するのに役立ちますが、より正確なスケーリング制御を必要とするユーザー向けの回避策もあります。これらの方法は視覚的な乱れが生じる可能性があるため、推奨されません：

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- この環境変数を設定すると丸め処理が無効になり、より正確なスケーリングが可能になります。
- 注意： これにより特にタイムラインで視覚的な乱れが生じる可能性があり、推奨されません。
QT_SCALE_FACTOR=1.25 （または類似の値）
- スケールファクターを手動で設定することで、フォントやUIのスケーリングをより細かく調整できます。
- これは設定の「ユーザーインターフェースのスケール」からも設定可能ですが、Windowsで小数のスケールを使うと境界線やラインの問題が発生することがあります。
- 注意： この方法も視覚的な乱れを引き起こし、OpenShotの操作が難しくなる可能性があります。

これらの環境変数の調整に関する詳細は、https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large をご覧ください。