Vianmääritys

Jos kohtaat ongelman OpenShotissa, kuten jumiutumisen, kaatumisen tai virheilmoituksen, on olemassa monia erilaisia tekniikoita, jotka voivat auttaa vianmäärityksessä.

Lokit ongelmanratkaisussa

Lokitiedosto on tekstitiedosto, joka tallentaa, mitä OpenShot tekee, mukaan lukien varoitukset ja virheet. Nämä tiedostot voivat auttaa tukitiimiä ymmärtämään ongelman, vaikka et näkisi virheilmoitusta näytöllä.

OpenShot säilyttää kahta lokitiedostoa .openshot_qt-kansiossa kotikansiosi sisällä. Linuxissa ja macOS:ssä tämä sijainti kirjoitetaan muodossa ~/.openshot_qt/. Kansio saattaa olla piilotettu tiedostonhallinnassasi.

Kaksi lokitiedostoa
Tiedosto	Mitä se tallentaa
`openshot-qt.log`	Toiminta editorissa: OpenShotin käynnistäminen, projektien lataaminen, asetusten muuttaminen ja käyttöliittymän käyttäminen. Tämä on yleensä paras paikka aloittaa ongelman tutkiminen.
`libopenshot.log`	Toiminta OpenShotin video- ja äänimoottorissa, osa joka lukee mediaa ja rakentaa esikatseluissa ja viedyissä videoissa käytettävät kuvat ja äänet. Yksityiskohtainen moottorin lokitus voi auttaa toiston ja viennin ongelmien tutkimisessa.

Nämä tiedostot tallentavat eri osia samasta sovelluksesta. Kun raportoit ongelmasta, liitä mukaan molemmat tiedostot, jos ne ovat saatavilla. Sinun ei tarvitse ymmärtää jokaista riviä itse.

Valitse, mitä osaa OpenShotista lokitetaan

Avaa Muokkaa → Asetukset → Lisäasetukset löytääksesi nämä kaksi asetusta:

Asetukset ja vastaavat komentorivivaihtoehdot
Asetus	Vastaava argumentti	Lokitiedosto
Käyttöliittymän virheenkorjauslokitus	`--debug-ui`	`openshot-qt.log`
Video- ja äänimoottorin virheenkorjauslokitus	`--debug-engine`	`libopenshot.log`

Molemmat asetukset ovat oletuksena pois päältä, mikä säilyttää normaalit yhteenvetoviestit. Toisen kytkeminen päälle lisää yksityiskohtia sen lokitiedostoon välittömästi. Se ei muuta toista lokia eikä lisää viestejä terminaaliin. Asetukset pysyvät päällä käynnistysten välillä, kunnes sammutat ne.

Käyttöliittymän virheenkorjauslokitus on hyvä aloituspiste ongelmille käynnistyksessä, projektin latauksessa, asetuksissa tai käyttöliittymässä. Video- ja äänimoottorin virheenkorjauslokitus lisää yksityiskohtia video- ja äänikäsittelystä, mikä voi auttaa toiston ja viennin ongelmien tutkimisessa. Moottorin lokit voivat kasvaa hyvin nopeasti ja hidastaa OpenShottia. Ota tämä asetus käyttöön juuri ennen ongelman toistamista ja poista se käytöstä sen jälkeen.

Moottorin asetus oli aiemmin nimeltään Debug Mode (Verbose). Sen tallennettu päälle/pois -asetus siirtyy uuteen nimeen.

Käytä terminaalia yhden käynnistyksen ajan

Terminaali on ikkuna, johon kirjoitat komentoja. Vastaavat argumentit mahdollistavat samat lisäyksityiskohdat kuin asetukset ja näyttävät ne myös terminaalissa:

openshot-qt --debug-ui

Tämä tallentaa käyttöliittymän tiedot yhden käynnistyksen ajalta. Tutut --debug ja lyhyempi -d tarkoittavat täsmälleen samaa kuin --debug-ui. Video- ja äänimoottorin tietoja varten käytä:

openshot-qt --debug-engine

Kerätäksesi molemmat tiedot yhdessä:

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

Toista ongelman aiheuttavat vaiheet, sulje sitten OpenShot ja kerää lokitiedostot. Nämä argumentit eivät muuta tallennettuja asetuksiasi. OpenShotin normaali käynnistys palauttaa tavalliset lokiasetuksesi.

openshot-qt.log aloittaa uuden tiedoston, kun se saavuttaa noin 25 Mt ja säilyttää kolme vanhempaa kopiota. libopenshot.log kasvaa jatkuvasti viestien lisäyksen myötä. Kun olet tallentanut tarvitsemasi lokit, voit poistaa vanhoja lokitiedostoja OpenShotin ollessa suljettuna.

Muut komentorivivaihtoehdot

Useimmat käyttäjät tarvitsevat vain yllä mainitut kaksi asetusta. Seuraavat vaihtoehdot antavat sinun valita, kuinka paljon yksityiskohtia tallennetaan tiedostoihin tai näytetään terminaalissa. Tässä console tarkoittaa terminaalin tulostetta.

Lokitusasetukset
Vaihtoehto	Mitä se tekee
`--debug-ui`, `--debug` tai `-d`	Ottaa käyttöön käyttöliittymän virheenkorjauslokituksen tiedostossa ja terminaalissa.
`--debug-engine`	Ottaa käyttöön video- ja äänimoottorin virheenkorjauslokituksen tiedostossa ja terminaalissa.
`--debug-file`	Lisää editorin tiedot `openshot-qt.log`-tiedostoon ilman terminaalin tietoja.
`--debug-console`	Lisää editorin tiedot terminaaliin ilman tiedostotietoja.
`--log-level LEVEL`	Asettaa yksityiskohtaisuuden molemmille lokitiedostoille ja niiden terminaalitulosteille.
`--log-file-level LEVEL`	Asettaa yksityiskohtaisuuden molemmille lokitiedostoille jättäen terminaaliasetukset ennalleen.
`--log-console-level LEVEL`	Asettaa yksityiskohtaisuuden terminaaliin sekä editorille että moottorille, jättäen tiedostojen asetukset ennalleen.

Korvaa LEVEL arvolla debug saadaksesi yksityiskohtaiset viestit tai info normaalin yhteenvedon. warning näyttää varoitukset ja virheet; error näyttää virheet ja kriittiset virheet; critical näyttää vain kriittiset virheet. off pysäyttää tavalliset lokiviestit, mutta olemassa olevat kaatumisdianostiikat voidaan silti kirjoittaa. Suuret kirjaimet kuten DEBUG toimivat myös.

Esimerkiksi, kerätäksesi yksityiskohtaiset viestit molemmissa tiedostoissa pitäen terminaalin tavallisella tasolla:

openshot-qt --log-file-level debug

Tämä myös ottaa käyttöön suuren moottorin lokin, joten käytä sitä lyhyesti. Vanhemmat --debug-file ja --debug-console -valinnat toimivat edelleen, vaikka niitä ei ole listattu --help-komennossa.

Ympäristömuuttujat

Ympäristömuuttuja on nimetty asetus, joka välitetään ohjelmalle sen käynnistyessä. Näitä käytetään, kun käynnistät OpenShotin skriptistä tai kun tukihenkilö pyytää sinua kokeilemaan tiettyä asetusta. Niitä ei tarvitse asettaa normaalissa käytössä.

Valinnaiset ympäristöasetukset
Muuttuja	Mitä se ohjaa
`OPENSHOT_LOG_LEVEL`	Yksityiskohdat molemmissa tiedostoissa ja terminaalissa.
`OPENSHOT_LOG_FILE_LEVEL`	Yksityiskohdat vain molemmissa tiedostoissa.
`OPENSHOT_LOG_CONSOLE_LEVEL`	Yksityiskohdat vain terminaalissa, molemmille OpenShotin osille.
`LIBOPENSHOT_LOG_LEVEL`	Yksityiskohdat video- ja äänimoottorille, sen tiedostossa ja terminaalissa.
`LIBOPENSHOT_LOG_FILE_LEVEL`	Yksityiskohdat vain tiedostossa `libopenshot.log`.
`LIBOPENSHOT_LOG_CONSOLE_LEVEL`	Moottorin yksityiskohdat vain terminaalissa.

Esimerkiksi tämä Linux/macOS terminaalikomento pyytää yksityiskohtaista moottorin lokitusta tiedostossaan yhden käynnistyksen ajaksi:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

Jos asetukset menevät päällekkäin, komentorivivalinnat ovat etusijalla, sitten ympäristömuuttujat, sitten Asetukset ja lopuksi normaalit oletukset. Kukin ohjaus vaikuttaa vain siihen ulostuloon, jota se kuvaa: --debug ei ohita moottorin asetusta. Väliaikaiset ohitukset eivät muuta tallennettuja asetuksiasi. Vie hiiri minkä tahansa valintaruudun päälle nähdäksesi, ohjaako jokin muu asetus kyseistä lokitiedostoa.

Ympäristöasetuksissa LIBOPENSHOT_-arvot ovat etusijalla moottorin osalta verrattuna OPENSHOT_-arvoihin. Kummassakin ryhmässä tiedosto- tai terminaalikohtainen taso on etusijalla yleiseen tasoon nähden. Komentorivivalinnat noudattavat samaa tiedosto/terminaali-sääntöä. Ristiriitaiset komentorivitasot samalle ulostulolle hylätään; virheelliset ympäristötasot raportoidaan ja ohitetaan.

Vanhemmissa skripteissä LIBOPENSHOT_DEBUG ottaa edelleen käyttöön yksityiskohtaiset moottoriviestit terminaalissa aina kun se on läsnä, vaikka sen arvo olisi 0. Uudemmat tason asetukset ovat etusijalla sen yli. LIBOPENSHOT_LOG_FILE on tarkoitettu ohjelmille, jotka käyttävät moottoria erikseen; OpenShot itse käyttää yllä olevaa lokikansiota. Lokiasetusten muuttaminen ei muuta virheraportointiasetustasi.

Windows 11 ei vastaa

Jos Windows 11 -järjestelmä jumiutuu, kyseessä on tunnettu ongelma PyQt5:n ja Windows 11:n välillä, joka liittyy Qt:n saavutettavuusominaisuuksiin. Tämä tapahtuu, kun painat Ctrl+C OpenShotissa (vain Windows 11:ssä). OpenShot lakkaa vastaamasta ja muistivuotoa esiintyy (eli mitä pidempään OpenShot ei vastaa, sitä suuremmaksi muistivuoto kasvaa, kunnes OpenShot kaatuu tai käyttäjä lopettaa prosessin).

Yksinkertainen kiertotapa on välttää Ctrl+C käyttöä Windows 11:ssä ja sen sijaan käyttää hiiren oikean painikkeen Kopioi/Liitä-valikoita. Toinen kiertotapa on muuttaa ”Kopioi” -näppäinyhdistelmää Ctrl+C:stä johonkin muuhun, esimerkiksi Alt+C. Voit muuttaa näppäinasetuksia OpenShotin asetuksissa. Katso Näppäimistö.

Windowsin virheenkorjaus GDB:llä

Jos OpenShot kaatuu tai jumiutuu Windows 10/11 -järjestelmässä, seuraavat vaiheittaiset ohjeet auttavat sinua selvittämään kaatumisen syyn. Nämä ohjeet näyttävät pinon jäljityksen OpenShotin lähdekoodista kaatumiskohdassa. Tämä tieto on erittäin hyödyllistä kehitystiimillemme ja hyödyllistä liittää virheraportteihin (nopeamman ratkaisun saamiseksi).

Asenna uusin päivittäinen versio

Ennen virheenkorjaimen liittämistä, lataa uusin versio OpenShotista: https://www.openshot.org/download#daily. Asenna tämä OpenShotin versio oletussijaintiin: C:\Program Files\OpenShot Video Editor\. Yksityiskohtaiset ohjeet OpenShotin virheenkorjaukseen Windowsilla löydät tästä wikistä.

Asenna MSYS2

OpenShotin Windows-versio on käännetty MSYS2-nimisessä ympäristössä. Jotta voit liittää GDB-virheenkorjaimen suoritettavaan tiedostoomme, openshot-qt.exe, sinun täytyy ensin asentaa MSYS2. Tämä vaihe tarvitaan vain kerran.

Lataa ja asenna MSYS2: http://www.msys2.org/
Aja MSYS2 MinGW x64 komentokehote (esimerkiksi: C:\msys64\msys2_shell.cmd -mingw64)
Päivitä kaikki paketit (Kopioi/liitä seuraava komento):
```
pacman -Syu
```

Asenna GDB-virheenkorjain (Kopioi/liitä seuraava komento):

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

Käynnistä OpenShot GDB-virheenkorjaimella

Aja MSYS2 MinGW x64 komentokehote (esimerkiksi: C:\msys64\msys2_shell.cmd -mingw64)

Päivitä PATH (Kopioi/liitä seuraavat komennot):

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

Lataa OpenShot GDB-virheenkorjaimeen (Kopioi/liitä seuraavat komennot):

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

Käynnistä OpenShot GDB-kehotteesta (Kopioi/liitä seuraava komento):

run --debug

Tulosta virheenkorjaustiedot

Kun OpenShot on käynnistynyt onnistuneesti GDB:n kanssa, sinun tarvitsee vain aiheuttaa kaatuminen tai jumiutuminen OpenShotissa. Kun kaatuminen tapahtuu, vaihda takaisin MSYS2 MinGW64 -terminaaliin ja suorita jokin seuraavista komennoista (kirjoita komento ja paina ENTER). Yleensä ensimmäinen komento on bt, joka tarkoittaa backtrace. Lisää komentoja on listattu alla.

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

Korkea DPI / 4K-näytöt

OpenShot Video Editor tarjoaa vahvan tuen korkearesoluutioisille DPI (Dots Per Inch) -näytöille, varmistaen, että käyttöliittymä näyttää terävältä ja on helposti luettavissa eri DPI-asetuksilla varustetuilla näytöillä. Tämä tuki on erityisen hyödyllinen 4K-näytöillä ja muilla korkean resoluution näytöillä.

Näytöittäin DPI-tietoisuus

OpenShot tunnistaa DPI-arvot näytöittäin, eli se voi säätää skaalaustaan dynaamisesti kunkin liitetyn näytön DPI-asetusten mukaan. Tämä auttaa tarjoamaan yhtenäisen käyttökokemuksen eri näytöillä.

DPI-skaalaus Windowsissa

Windowsissa OpenShot pyöristää skaalauskertoimen lähimpään kokonaislukuun visuaalisen eheys säilyttämiseksi. Tämä auttaa välttämään visuaalisia häiriöitä käyttöliittymässä ja pitää käyttöliittymäelementit terävinä ja hyvin kohdistettuina. Tämän pyöristyksen vuoksi jotkin skaalausvaihtoehdot voivat johtaa odotettua suurempiin fontteihin ja käyttöliittymäelementteihin.

125 % skaalaus pyöristyy arvoon 100 %
150 % skaalaus pyöristyy arvoon 200 %

Kiertotavat tarkempaan säätöön

Vaikka pyöristys auttaa säilyttämään siistin käyttöliittymän, on olemassa kiertotapoja käyttäjille, jotka tarvitsevat tarkempaa hallintaa skaalaamiseen. Näitä menetelmiä ei suositella mahdollisten visuaalisten häiriöiden vuoksi:

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- Tämän ympäristömuuttujan asettaminen voi poistaa pyöristyksen ja mahdollistaa tarkemman skaalaamisen.
- Huom: Tämä voi aiheuttaa visuaalisia häiriöitä, erityisesti aikajanalla, eikä sitä suositella.
QT_SCALE_FACTOR=1.25 (tai vastaava arvo)
- Skaalauskertoimen manuaalinen asettaminen voi tarjota tarkempia säätöjä fontin ja käyttöliittymän skaalaamiseen.
- Tämän voi myös asettaa asetuksista (Käyttöliittymän skaalaus), mutta Windowsissa voi esiintyä reunojen/viivojen ongelmia murtolukuskaaloilla.
- Huom: Tämä menetelmä voi myös aiheuttaa visuaalisia häiriöitä ja tehdä OpenShotin käytöstä vaikeampaa.

Lisätietoja näiden ympäristömuuttujien säätämisestä löytyy osoitteesta https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.