Rješavanje problema

Ako imate problema s OpenShotom, poput zamrzavanja, pada ili poruke o pogrešci, postoji mnogo različitih tehnika koje mogu biti korisne za rješavanje problema.

Korištenje zapisnika za rješavanje problema

Zapisnik je tekstualna datoteka koja bilježi što OpenShot radi, zajedno s upozorenjima i pogreškama. Ove datoteke mogu pomoći timu za podršku da razumije problem, čak i kada na zaslonu ne vidite poruku o pogrešci.

OpenShot čuva dvije zapisničke datoteke u mapi .openshot_qt unutar vaše početne mape. Na Linuxu i macOS-u, ta se lokacija zapisuje kao ~/.openshot_qt/. Mapa može biti skrivena u vašem upravitelju datoteka.

Dvije zapisničke datoteke
Datoteka	Što bilježi
`openshot-qt.log`	Aktivnosti u uređivaču: pokretanje OpenShota, učitavanje projekata, mijenjanje postavki i korištenje sučelja. Ovo je obično najbolje mjesto za početak istraživanja problema.
`libopenshot.log`	Aktivnosti u video i audio motoru OpenShota, dijelu koji čita medije i gradi slike i zvukove korištene u pregledima i izvezenim videozapisima. Detaljno zapisivanje motora može pomoći u istraživanju problema reprodukcije i izvoza.

Ove datoteke bilježe različite dijelove iste aplikacije. Prilikom prijavljivanja problema, uključite obje datoteke ako su dostupne. Ne morate sami razumjeti svaki redak.

Odaberite koji dio OpenShota želite zapisivati

Otvorite Uredi → Postavke → Napredno da biste pronašli ove dvije postavke:

Postavke i odgovarajuće opcije terminala
Postavka	Odgovarajući argument	Zapisnička datoteka
Zapisivanje otklanjanja pogrešaka korisničkog sučelja	`--debug-ui`	`openshot-qt.log`
Zapisivanje otklanjanja pogrešaka video i audio motora	`--debug-engine`	`libopenshot.log`

Obje postavke su prema zadanim postavkama isključene, što održava normalne sažetke poruka. Uključivanjem jedne odmah se dodaju detalji u njezinu zapisničku datoteku. Ne mijenja drugu zapisničku datoteku niti ne dodaje poruke u terminal. Postavke ostaju uključene između pokretanja dok ih ne isključite.

Zapisivanje otklanjanja pogrešaka korisničkog sučelja je dobar početak za probleme s pokretanjem, učitavanjem projekata, postavkama ili sučeljem. Zapisivanje otklanjanja pogrešaka video i audio motora dodaje detalje o obradi videa i zvuka, što može pomoći u istraživanju problema reprodukcije i izvoza. Zapisnici motora mogu brzo narasti i usporiti OpenShot. Uključite ovu postavku neposredno prije ponavljanja problema, a zatim je isključite.

Postavka motora je prethodno nazvana Debug Mode (Verbose). Njena spremljena postavka uključeno/isključeno prenosi se na novi naziv.

Koristite terminal za jedno pokretanje

Terminal je prozor u koji upisujete naredbe. Odgovarajući argumenti omogućuju iste dodatne detalje kao postavke, a također ih prikazuju u terminalu:

openshot-qt --debug-ui

Ovo bilježi detalje sučelja za jedno pokretanje. Poznate opcije --debug i kraća -d znače točno isto što i --debug-ui. Za detalje video i audio motora koristite:

openshot-qt --debug-engine

Za prikupljanje oba tipa detalja zajedno:

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

Ponovite korake koji uzrokuju problem, zatim zatvorite OpenShot i prikupite zapisnike. Ovi argumenti ne mijenjaju vaše spremljene postavke. Normalno pokretanje OpenShota vraća uobičajene postavke zapisivanja.

openshot-qt.log započinje novu datoteku kada dosegne oko 25 MB i čuva tri starije kopije. libopenshot.log nastavlja rasti kako se dodaju poruke. Nakon spremanja potrebnih zapisnika, možete ukloniti stare zapisničke datoteke dok je OpenShot zatvoren.

Ostale opcije naredbenog retka

Većini korisnika potrebne su samo dvije gore navedene kontrole. Sljedeće opcije omogućuju vam da odaberete koliko detalja ide u datoteke ili se prikazuje u terminalu. Ovdje console znači izlaz u terminal.

Opcije zapisivanja
Opcija	Što radi
`--debug-ui`, `--debug` ili `-d`	Omogućuje zapisivanje otklanjanja pogrešaka korisničkog sučelja u datoteku i terminal.
`--debug-engine`	Omogućuje zapisivanje otklanjanja pogrešaka video i audio motora u datoteku i terminal.
`--debug-file`	Dodaje detalje uređivača u `openshot-qt.log` bez dodavanja detalja u terminal.
`--debug-console`	Dodaje detalje uređivača u terminal bez dodavanja detalja u datoteku.
`--log-level LEVEL`	Postavlja razinu detalja za oba zapisnika i njihov izlaz u terminal.
`--log-file-level LEVEL`	Postavlja razinu detalja za obje zapisničke datoteke, a postavke terminala ostavlja nepromijenjenima.
`--log-console-level LEVEL`	Postavlja detalje u terminalu za uređivač i motor, ostavljajući postavke datoteke nepromijenjenima.

Zamijenite LEVEL s debug za detaljne poruke ili info za normalni sažetak. warning prikazuje upozorenja i pogreške; error prikazuje pogreške i kritične kvarove; critical prikazuje samo kritične kvarove. off zaustavlja obične zapisnike, ali postojeće dijagnostike pada programa mogu se i dalje zapisivati. Velika slova poput DEBUG također rade.

Na primjer, za prikupljanje detaljnih poruka u obje datoteke dok terminal ostaje na uobičajenoj razini:

openshot-qt --log-file-level debug

Ovo također omogućuje veliki zapisnik motora, stoga ga koristite kratko. Starije opcije --debug-file i --debug-console još uvijek rade iako nisu navedene u --help.

Varijable okoline

Varijabla okoline je imenovana postavka koja se prosljeđuje programu prilikom pokretanja. Korisne su pri pokretanju OpenShota iz skripte ili kada vas podrška zamoli da isprobate određenu postavku. Nije ih potrebno postavljati za normalnu upotrebu.

Opcionalne postavke okoline
Varijabla	Što kontrolira
`OPENSHOT_LOG_LEVEL`	Detalji u obje datoteke i terminalu.
`OPENSHOT_LOG_FILE_LEVEL`	Detalji samo u obje datoteke.
`OPENSHOT_LOG_CONSOLE_LEVEL`	Detalji samo u terminalu, za oba dijela OpenShota.
`LIBOPENSHOT_LOG_LEVEL`	Detalji za video i audio motor, u njegovoj datoteci i terminalu.
`LIBOPENSHOT_LOG_FILE_LEVEL`	Detalji samo u `libopenshot.log`.
`LIBOPENSHOT_LOG_CONSOLE_LEVEL`	Detalji motora samo u terminalu.

Na primjer, ova naredba u Linux/macOS terminalu traži detaljno zapisivanje motora u njegovu datoteku za jedno pokretanje:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

Ako se postavke preklapaju, prioritet imaju opcije naredbenog retka, zatim varijable okoline, zatim Postavke, a potom uobičajene zadane vrijednosti. Svaka kontrola utječe samo na izlaz koji opisuje: --debug ne nadjačava postavku motora. Privremene promjene ne mijenjaju vaše spremljene postavke. Zadržite pokazivač iznad bilo kojeg okvira za potvrdu da vidite kontrolira li druga postavka taj zapisnik.

Unutar postavki okoline, vrijednosti LIBOPENSHOT_ imaju prednost nad OPENSHOT_ vrijednostima za motor. Unutar bilo koje grupe, razina samo za datoteku ili samo za konzolu ima prednost nad općom razinom. Opcije naredbenog retka slijede isto pravilo datoteke/konzole. Sukobljene razine naredbenog retka za isti izlaz se odbacuju; nevažeće razine okoline se prijavljuju i ignoriraju.

Za starije skripte, LIBOPENSHOT_DEBUG i dalje omogućuje detaljne poruke motora u terminalu kad god je prisutan, čak i ako mu je vrijednost 0. Novije postavke razine imaju prednost nad njim. LIBOPENSHOT_LOG_FILE je namijenjen programima koji koriste motor zasebno; sam OpenShot koristi gornji zapisnički direktorij. Promjena postavki zapisivanja ne mijenja vašu preferenciju izvještavanja o pogreškama.

Windows 11 ne reagira

Ako dođe do zamrzavanja na Windows 11, to je poznati problem s PyQt5 i Windows 11, vezan uz pristupačne značajke u Qt-u. To se pokreće pritiskom na Ctrl+C u OpenShotu (samo na Windows 11). OpenShot će prestati reagirati, a prisutan je i curenje memorije (što duže OpenShot ne reagira, to će curenje memorije biti veće dok OpenShot na kraju ne padne ili korisnik ne prekine proces).

Jednostavno rješenje je izbjegavati Ctrl+C na Windows 11 i umjesto toga koristiti izbornike Kopiraj/Zalijepi desnim klikom. Drugo rješenje je premapirati „Kopiraj” s Ctrl+C na nešto drugo, na primjer Alt+C. Mape tipkovnice možete promijeniti u postavkama OpenShota. Pogledajte Tipkovnica.

Otklanjanje pogrešaka na Windowsu s GDB-om

Ako doživljavate pad ili zamrzavanje OpenShota na Windows 10/11, sljedeće upute korak po korak pomoći će vam odrediti uzrok pada. Ove upute prikazat će stog poziva izvornog koda OpenShota na mjestu pada. Ove informacije mogu biti izuzetno korisne našem razvojnom timu i vrlo korisne za priložiti uz izvještaje o pogreškama (za brže rješavanje).

Instalirajte najnoviju dnevnu verziju

Prije pridruživanja otklanjanju pogrešaka, preuzmite najnoviju verziju OpenShota: https://www.openshot.org/download#daily. Instalirajte ovu verziju OpenShota na zadanu lokaciju: C:\Program Files\OpenShot Video Editor\. Za detaljne upute o otklanjanju pogrešaka OpenShota na Windowsu, pogledajte ovu wiki stranicu.

Instalirajte MSYS2

Windows verzija OpenShota je kompajlirana koristeći okruženje zvano MSYS2. Da biste mogli pridružiti GDB otklanjanje pogrešaka našem izvršnom programu, openshot-qt.exe, prvo morate instalirati MSYS2. Ovaj korak je potreban samo jednom.

Preuzmite i instalirajte MSYS2: http://www.msys2.org/
Pokrenite naredbeni redak MSYS2 MinGW x64 (na primjer: C:\msys64\msys2_shell.cmd -mingw64)
Ažurirajte sve pakete (Kopirajte/Zalijepite sljedeću naredbu):
```
pacman -Syu
```
Instalirajte GDB otklanjanje pogrešaka (Kopirajte/Zalijepite sljedeću naredbu):
```
pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
```

Pokrenite OpenShot s GDB otklanjanjem pogrešaka

Pokrenite naredbeni redak MSYS2 MinGW x64 (na primjer: C:\msys64\msys2_shell.cmd -mingw64)

Ažurirajte PATH (Kopirajte/Zalijepite sljedeće naredbe):

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

Učitajte OpenShot u GDB otklanjanje pogrešaka (Kopirajte/Zalijepite sljedeće naredbe):

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

Pokrenite OpenShot iz GDB naredbenog retka (Kopirajte/Zalijepite sljedeću naredbu):

run --debug

Ispiši informacije za otklanjanje pogrešaka

Nakon što se OpenShot uspješno pokrene s pridruženim GDB-om, sve što trebate učiniti je izazvati pad ili zamrzavanje u OpenShotu. Kad dođe do pada, vratite se u MSYS2 MinGW64 terminal i pokrenite jednu od sljedećih naredbi (upišite je i pritisnite ENTER). Obično je prva naredba koju treba unijeti bt, što znači backtrace. Više naredbi je navedeno u nastavku.

(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)

Visoka DPI / 4K Monitori

OpenShot Video Editor pruža snažnu podršku za monitore s visokom DPI (točkama po inču), osiguravajući da sučelje izgleda oštro i lako čitljivo na zaslonima s različitim DPI postavkama. Ova podrška je posebno korisna na 4K monitorima i drugim zaslonima visoke rezolucije.

Svjesnost o DPI po monitoru

OpenShot prepoznaje DPI za svaki monitor zasebno, što znači da može dinamički prilagoditi skaliranje ovisno o DPI postavkama svakog povezanog monitora. To pomaže u pružanju dosljednog iskustva na različitim zaslonima.

DPI skaliranje na Windowsu

Na Windowsu, OpenShot zaokružuje faktor skaliranja na najbližu cijelu vrijednost kako bi održao vizualni integritet. To pomaže izbjeći vizualne artefakte u sučelju i održava elemente sučelja oštrima i dobro poravnanima. Zbog ovog zaokruživanja, neke opcije skaliranja mogu rezultirati većim fontovima i elementima sučelja nego što se očekivalo.

125% skaliranje se zaokružuje na 100%
150% skaliranje se zaokružuje na 200%

Zaobilazna rješenja za preciznu prilagodbu

Iako zaokruživanje pomaže održati čisto sučelje, postoje zaobilazna rješenja za korisnike kojima je potrebna preciznija kontrola skaliranja. Ove metode nisu preporučene zbog mogućih vizualnih artefakata:

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- Postavljanje ove varijable okoline može onemogućiti zaokruživanje i omogućiti preciznije skaliranje.
- Napomena: Ovo može uzrokovati vizualne artefakte, osobito na vremenskoj liniji, i nije preporučeno.
QT_SCALE_FACTOR=1.25 (ili slična vrijednost)
- Ručno postavljanje faktora skaliranja može omogućiti finije prilagodbe veličine fonta i skaliranja sučelja.
- Ovo se također može postaviti putem Postavki (Skaliranje korisničkog sučelja), ali očekujte probleme s rubovima/linijama na Windowsu kod djelomičnih skaliranja.
- Napomena: Ova metoda također može dovesti do vizualnih artefakata i otežati korištenje OpenShota.

Za više informacija o podešavanju ovih varijabli okoline, molimo posjetite https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.