Depanare
Dacă întâmpinați o problemă cu OpenShot, cum ar fi blocarea, prăbușirea sau un mesaj de eroare, există multe tehnici diferite care pot fi utile pentru depanarea problemei.
Utilizarea jurnalelor pentru depanarea unei probleme
Un jurnal este un fișier text care înregistrează ce face OpenShot, împreună cu avertismente și erori. Aceste fișiere pot ajuta echipa de suport să înțeleagă o problemă, chiar dacă nu vedeți un mesaj de eroare pe ecran.
OpenShot păstrează două fișiere jurnal în folderul .openshot_qt din interiorul folderului dvs. personal. Pe Linux și macOS, această locație este scrisă ca ~/.openshot_qt/. Folderul poate fi ascuns în managerul dvs. de fișiere.
Fișier |
Ce înregistrează |
|---|---|
|
Activitatea în editor: pornirea OpenShot, încărcarea proiectelor, schimbarea setărilor și utilizarea interfeței. Acesta este de obicei cel mai bun loc pentru a începe investigarea unei probleme. |
|
Activitatea în motorul video și audio al OpenShot, partea care citește media și construiește imaginile și sunetul folosite în previzualizări și videoclipuri exportate. Înregistrarea detaliată a motorului poate ajuta la investigarea problemelor de redare și export. |
Aceste fișiere înregistrează părți diferite ale aceleiași aplicații. Când raportați o problemă, includeți ambele fișiere dacă sunt disponibile. Nu trebuie să înțelegeți fiecare linie personal.
Alegeți ce parte a OpenShot să fie înregistrată
Deschideți Editare → Preferințe → Avansat pentru a găsi aceste două setări:
Preferință |
Argument corespunzător |
Fișier jurnal |
|---|---|---|
Înregistrare depanare interfață utilizator |
|
|
Înregistrare depanare motor video și audio |
|
|
Ambele preferințe sunt dezactivate implicit, ceea ce păstrează mesajele sumare normale. Activarea uneia adaugă imediat detalii în fișierul său jurnal. Nu schimbă celălalt jurnal și nu adaugă mesaje în terminal. Preferințele rămân activate între lansări până când le dezactivați.
Înregistrarea depanare interfață utilizator este un punct bun de plecare pentru probleme legate de pornire, încărcarea proiectelor, setări sau interfață. Înregistrarea depanare motor video și audio adaugă detalii despre procesarea video și audio, ceea ce poate ajuta la investigarea problemelor de redare și export. Jurnalele motorului pot crește foarte rapid și pot încetini OpenShot. Activați această setare cu puțin timp înainte de a repeta problema, apoi dezactivați-o după aceea.
Preferința motorului a fost anterior numită Mod depanare (detaliat). Setarea sa salvată on/off se păstrează cu noul nume.
Folosiți un terminal pentru o lansare
Un terminal este o fereastră în care tastați comenzi. Argumentele corespunzătoare activează aceleași detalii suplimentare ca preferințele și le afișează și în terminal:
openshot-qt --debug-ui
Aceasta înregistrează detalii ale interfeței pentru o lansare. Opțiunile familiare --debug și mai scurte -d înseamnă exact același lucru ca --debug-ui. Pentru detalii despre motorul video și audio, folosiți:
openshot-qt --debug-engine
Pentru a colecta ambele tipuri de detalii împreună:
openshot-qt --debug-ui --debug-engine
Repetați pașii care cauzează problema, apoi închideți OpenShot și colectați jurnalele. Acești argumente nu modifică preferințele salvate. Pornirea normală a OpenShot revine la setările obișnuite de înregistrare.
openshot-qt.log începe un fișier nou când ajunge la aproximativ 25 MB și păstrează trei copii mai vechi. libopenshot.log continuă să crească pe măsură ce se adaugă mesaje. După ce salvați jurnalele de care aveți nevoie, puteți șterge fișierele jurnal vechi în timp ce OpenShot este închis.
Alte opțiuni din linia de comandă
Majoritatea utilizatorilor au nevoie doar de cele două controale de mai sus. Opțiunile următoare vă permit să alegeți cât de multe detalii sunt în fișiere sau apar în terminal. Aici, console înseamnă ieșirea terminalului.
Opțiune |
Ce face |
|---|---|
|
Activează înregistrarea depanare interfață utilizator în fișierul său și în terminal. |
|
Activează înregistrarea depanare motor video și audio în fișierul său și în terminal. |
|
Adaugă detalii ale editorului în |
|
Adaugă detalii ale editorului în terminal fără a adăuga detalii în fișier. |
|
Setează nivelul de detaliu pentru ambele jurnale și ieșirea lor în terminal. |
|
Setează nivelul de detaliu pentru ambele fișiere jurnal, fără a modifica setările terminalului. |
|
Setează detaliile în terminal pentru editor și motor, lăsând setările fișierului neschimbate. |
Înlocuiți LEVEL cu debug pentru mesaje detaliate sau cu info pentru rezumatul normal. warning afișează avertismente și erori; error afișează erori și defecțiuni critice; critical afișează doar defecțiuni critice. off oprește mesajele obișnuite de jurnal, dar diagnosticele de crash existente pot fi încă scrise. Numele cu majuscule, cum ar fi DEBUG, funcționează de asemenea.
De exemplu, pentru a colecta mesaje detaliate în ambele fișiere păstrând terminalul la nivelul său obișnuit:
openshot-qt --log-file-level debug
Aceasta activează și jurnalul mare al motorului, deci folosiți-l pe termen scurt. Opțiunile mai vechi --debug-file și --debug-console funcționează în continuare, chiar dacă nu sunt listate în --help.
Variabile de mediu
O variabilă de mediu este o setare denumită transmisă unui program la pornire. Acestea sunt utile când porniți OpenShot dintr-un script sau când o persoană de suport vă cere să încercați o anumită setare. Nu trebuie să le setați pentru utilizarea normală.
Variabilă |
Ce controlează |
|---|---|
|
Detalii în ambele fișiere și în terminal. |
|
Detalii doar în ambele fișiere. |
|
Detalii doar în terminal, pentru ambele părți ale OpenShot. |
|
Detalii pentru motorul video și audio, în fișierul său și în terminal. |
|
Detalii doar în |
|
Detalii ale motorului doar în terminal. |
De exemplu, această comandă de terminal Linux/macOS solicită jurnalizare detaliată a motorului în fișierul său pentru o lansare:
LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt
Dacă setările se suprapun, opțiunile din linia de comandă au prioritate, urmate de variabilele de mediu, apoi Preferințele și în final valorile implicite normale. Fiecare control afectează doar ieșirea pe care o descrie: --debug nu suprascrie preferința motorului. Suprascrierile temporare nu modifică preferințele salvate. Plasați cursorul peste oricare casetă de selectare pentru a vedea dacă o altă setare controlează acel fișier de jurnal.
În cadrul setărilor de mediu, valorile LIBOPENSHOT_ au prioritate față de valorile OPENSHOT_ pentru motor. În fiecare grup, un nivel doar pentru fișier sau doar pentru consolă are prioritate față de nivelul general. Opțiunile din linia de comandă urmează aceeași regulă fișier/consolă. Nivelurile conflictuale din linia de comandă pentru aceeași ieșire sunt respinse; nivelurile invalide de mediu sunt raportate și ignorate.
Pentru scripturile mai vechi, LIBOPENSHOT_DEBUG activează în continuare mesaje detaliate ale motorului în terminal ori de câte ori este prezent, chiar dacă valoarea sa este 0. Setările noi de nivel au prioritate față de acesta. LIBOPENSHOT_LOG_FILE este destinat programelor care folosesc motorul separat; OpenShot însuși folosește folderul de jurnal de mai sus. Modificarea setărilor de jurnalizare nu schimbă preferința dvs. de raportare a erorilor.
Windows 11 nu răspunde
Dacă întâmpinați o blocare pe Windows 11, aceasta este o problemă cunoscută cu PyQt5 și Windows 11, legată de funcțiile de accesibilitate din Qt. Aceasta este declanșată prin apăsarea Ctrl+C în OpenShot (doar pe Windows 11). OpenShot va deveni nefuncțional și există o scurgere de memorie (adică, cu cât OpenShot rămâne nefuncțional mai mult timp, cu atât scurgerea de memorie va crește până când OpenShot se prăbușește sau utilizatorul închide procesul).
O soluție simplă este să evitați Ctrl+C pe Windows 11 și să folosiți în schimb meniurile Copy/Paste accesate prin clic dreapta. O altă soluție este să remapați comanda „Copy” de la Ctrl+C la altceva, de exemplu Alt+C. Puteți schimba mapările tastaturii în Preferințele OpenShot. Consultați Tastatură.
Depanare Windows cu GDB
Dacă întâmpinați o prăbușire sau blocare cu OpenShot pe Windows 10/11, următoarele instrucțiuni pas cu pas vă vor ajuta să determinați cauza prăbușirii. Aceste instrucțiuni vor afișa un stack trace al codului sursă OpenShot, la locul prăbușirii. Aceste informații pot fi extrem de utile echipei noastre de dezvoltare și foarte utile pentru a fi atașate rapoartelor de erori (pentru o rezolvare mai rapidă).
Instalați cea mai recentă versiune zilnică
Înainte de a atașa un debugger, vă rugăm să descărcați cea mai recentă versiune de OpenShot: https://www.openshot.org/download#daily. Instalați această versiune de OpenShot în locația implicită: C:\Program Files\OpenShot Video Editor\. Pentru instrucțiuni detaliate despre depanarea OpenShot pe Windows, consultați acest wiki.
Instalați MSYS2
Versiunea Windows a OpenShot este compilată folosind un mediu numit MSYS2. Pentru a atașa debuggerul GDB la executabilul nostru, openshot-qt.exe, trebuie mai întâi să instalați MSYS2. Acest pas este necesar o singură dată.
Descărcați și instalați MSYS2: http://www.msys2.org/
Rulați promptul de comandă
MSYS2 MinGW x64(de exemplu:C:\msys64\msys2_shell.cmd -mingw64)Actualizați toate pachetele (Copiați/Lipiți următoarea comandă):
pacman -SyuInstalați debuggerul GDB (Copiați/Lipiți următoarea comandă):
pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
Lansați OpenShot cu debuggerul GDB
Rulați promptul de comandă MSYS2 MinGW x64 (de exemplu: C:\msys64\msys2_shell.cmd -mingw64)
Actualizați PATH (Copiați/Lipiți următoarele comenzi):
export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"
Încărcați OpenShot în debuggerul GDB (Copiați/Lipiți următoarele comenzi):
cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe
Lansați OpenShot din promptul GDB (Copiați/Lipiți următoarea comandă):
run --debug
Afișați informații de depanare
Odată ce OpenShot a fost lansat cu succes cu GDB atașat, tot ce trebuie să faceți este să declanșați o prăbușire sau blocare în OpenShot. Când apare o prăbușire, reveniți la terminalul MSYS2 MinGW64 și rulați una dintre următoarele comenzi (tastați comanda și apăsați ENTER). De obicei, prima comandă introdusă este bt, care înseamnă backtrace. Mai multe comenzi sunt listate mai jos.
(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)
Monitoare High DPI / 4K
OpenShot Video Editor oferă suport robust pentru monitoarele High DPI (puncte pe inch), asigurând că interfața arată clar și este ușor de citit pe ecrane cu diverse setări DPI. Acest suport este deosebit de util pe monitoarele 4K și alte ecrane cu rezoluție înaltă.
Conștientizarea DPI pe monitor
OpenShot este conștient de DPI pe fiecare monitor în parte, ceea ce înseamnă că poate ajusta scalarea dinamic în funcție de setările DPI ale fiecărui monitor conectat. Acest lucru ajută la oferirea unei experiențe consistente pe diferite ecrane.
Scalarea DPI pe Windows
Pe Windows, OpenShot rotunjește factorul de scalare la cea mai apropiată valoare întreagă pentru a menține integritatea vizuală. Acest lucru ajută la evitarea artefactelor vizuale în interfață și păstrează elementele UI clare și bine aliniate. Din cauza acestei rotunjiri, unele opțiuni de scalare pot duce la fonturi și elemente UI mai mari decât se așteaptă.
Scalarea de 125% se rotunjește la 100%
Scalarea de 150% se rotunjește la 200%
Soluții alternative pentru ajustări fine
Deși rotunjirea ajută la menținerea unei interfețe curate, există soluții alternative pentru utilizatorii care necesită un control mai precis asupra scalării. Aceste metode nu sunt recomandate din cauza posibilelor artefacte vizuale:
QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
Setarea acestei variabile de mediu poate dezactiva rotunjirea și permite o scalare mai precisă.
Notă: Acest lucru poate cauza artefacte vizuale, în special în cronologie, și nu este recomandat.
QT_SCALE_FACTOR=1.25 (sau o valoare similară)
Setarea manuală a factorului de scalare poate oferi ajustări mai fine ale fontului și scalării interfeței.
Aceasta poate fi setată și prin Preferințe (Scalarea interfeței utilizator), dar se pot aștepta probleme cu marginile/liniile pe Windows la scalări fracționare.
Notă: Această metodă poate duce, de asemenea, la artefacte vizuale și poate face OpenShot mai dificil de utilizat.
Pentru mai multe informații despre ajustarea acestor variabile de mediu, vă rugăm să vizitați https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.