문제 해결

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 를 방문해 주세요.