Vandræsing

Ef þú lendir í vandræðum með OpenShot, eins og að forritið frjósi, hrynni eða sýni villuskilaboð, eru margar aðferðir sem geta hjálpað við að greina og leysa vandamálið.

Að nota skráningar til að greina vandamál

Skráning er textaskrá sem skráir hvað OpenShot er að gera, ásamt viðvörunum og villum. Þessar skrár geta hjálpað stuðningsteyminu að skilja vandamál, jafnvel þegar þú sérð ekki villuskilaboð á skjánum.

OpenShot heldur tveimur skráningarskrám í möppunni .openshot_qt innan heimamöppu þinnar. Á Linux og macOS er þessi staðsetning skrifuð sem ~/.openshot_qt/. Mappan gæti verið falin í skráarstjóranum þínum.

Báðar skráningarskrárnar
Skrá	Hvað hún skráir
`openshot-qt.log`	Virkni í ritlinum: að ræsa OpenShot, hlaða verkefnum, breyta stillingum og nota viðmótið. Þetta er venjulega besti staðurinn til að byrja þegar verið er að rannsaka vandamál.
`libopenshot.log`	Virkni í mynd- og hljóðvél OpenShot, hlutanum sem les fjölmiðla og býr til myndir og hljóð sem notuð eru í forskoðunum og útfluttum myndböndum. Nákvæm skráning vélarinnar getur hjálpað við að rannsaka vandamál við spilun og útflutning.

Þessar skrár skrá ólíka hluta af sama forriti. Þegar þú tilkynnir vandamál, láttu báðar skrár fylgja með ef þær eru tiltækar. Þú þarft ekki að skilja hverja línu sjálfur.

Veldu hvaða hluta OpenShot á að skrá

Opnaðu Breyta → Stillingar → Ítarlegt til að finna þessar tvær stillingar:

Stillingar og samsvarandi valkostir í flugstöð
Stilling	Samsvarandi rök	Skráningarskrá
Villuleitarskráning notendaviðmóts	`--debug-ui`	`openshot-qt.log`
Villuleitarskráning mynd- og hljóðvélar	`--debug-engine`	`libopenshot.log`

Báðar stillingar eru af sjálfu sér, sem heldur venjulegum yfirlits skilaboðum. Að kveikja á annarri bætir tafarlaust við smáatriðum í skráningarskrá hennar. Það breytir ekki hinni skráningunni né bætir við skilaboðum í flugstöðina. Stillingarnar haldast virkar milli keyrslna þar til þú slærð þær af.

Villuleitarskráning notendaviðmóts er gott byrjunarstig fyrir vandamál við ræsingu, hleðslu verkefna, stillingar eða viðmót. Villuleitarskráning mynd- og hljóðvélar bætir við smáatriðum um mynd- og hljóðvinnslu, sem getur hjálpað við að rannsaka vandamál við spilun og útflutning. Skrár vélarinnar geta stækkað mjög hratt og hægt á OpenShot. Kveiktu á þessari stillingu stuttu áður en þú endurtekur vandamálið og slökktu svo á henni eftir á.

Vélastillingin hét áður Villuleitarhamur (Nákvæmur). Vistaða á/af stillingin flyst yfir á nýja nafnið.

Notaðu flugstöð fyrir eina keyrslu

Flugstöð er gluggi þar sem þú slærð inn skipanir. Samsvarandi rök virkja sömu aukasmáatriði og stillingarnar og sýna þau einnig í flugstöðinni:

openshot-qt --debug-ui

Þetta skráir smáatriði viðmóts fyrir eina keyrslu. Þekktu valkostirnir --debug og styttri -d þýða nákvæmlega það sama og --debug-ui. Fyrir smáatriði mynd- og hljóðvélar, notaðu:

openshot-qt --debug-engine

Til að safna báðum tegundum smáatriða saman:

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

Endurtaktu skrefin sem valda vandamálinu, lokaðu svo OpenShot og safnaðu skráningunum. Þessi rök breyta ekki vistaðri stillingu þinni. Að ræsa OpenShot venjulega fer aftur í venjulegar skráningarstillingar þínar.

openshot-qt.log byrjar á nýrri skrá þegar hún nær um 25 MB og heldur þremur eldri afritum. libopenshot.log vex stöðugt þegar skilaboð bætast við. Eftir að hafa vistað nauðsynlegar skráningar geturðu eytt gömlum skráningarskrám meðan OpenShot er lokað.

Aðrir valkostir í skipanalínu

Flestir notendur þurfa aðeins á tveimur stjórntækjum hér að ofan að halda. Eftirfarandi valkostir leyfa þér að velja hversu mikið smáatriði fer í skrárnar eða birtist í flugstöðinni. Hér þýðir console flugstöðvarútgang.

Skráningarvalkostir
Valmöguleiki	Hvað hann gerir
`--debug-ui`, `--debug`, eða `-d`	Virkjar villuleitarskráningu notendaviðmóts í skrá og flugstöð.
`--debug-engine`	Virkjar villuleitarskráningu mynd- og hljóðvélar í skrá og flugstöð.
`--debug-file`	Bætir við smáatriðum ritils í `openshot-qt.log` án þess að bæta við smáatriðum í flugstöð.
`--debug-console`	Bætir við smáatriðum ritils í flugstöð án þess að bæta við smáatriðum í skrá.
`--log-level LEVEL`	Stillir smáatriði fyrir báðar skráningar og flugstöðvarútgang þeirra.
`--log-file-level LEVEL`	Stillir smáatriði fyrir báðar skráningarskrár, án þess að breyta flugstöðvarstillingum.
`--log-console-level LEVEL`	Stillir nákvæmni í flugstöðinni fyrir bæði ritstjórann og vélina, án þess að breyta skráarstillingum.

Skiptu út LEVEL með debug fyrir nákvæmar skilaboð eða info fyrir venjulegt yfirlit. warning sýnir viðvaranir og villur; error sýnir villur og alvarlegar bilanir; critical sýnir aðeins alvarlegar bilanir. off stöðvar venjuleg skráarskilaboð, en núverandi bilanagreiningar geta enn verið skrifaðar. Stórar bókstafir eins og DEBUG virka líka.

Til dæmis, til að safna nákvæmum skilaboðum í báðum skrám á meðan flugstöðin er á venjulegu stigi:

openshot-qt --log-file-level debug

Þetta virkjar einnig stóran vélarskrá, svo notaðu það stutt. Eldri valkostirnir --debug-file og --debug-console virka enn þótt þeir séu ekki skráðir í --help.

Umhverfisbreytur

Umhverfisbreyta er nafngreind stilling sem er send forriti þegar það byrjar. Þær eru gagnlegar þegar OpenShot er ræst úr skriftu eða þegar stuðningsaðili biður þig um að prófa ákveðna stillingu. Þú þarft ekki að stilla þær fyrir venjulega notkun.

Valfrjálsar umhverfisstillingar
Breytan	Hvað hún stjórnar
`OPENSHOT_LOG_LEVEL`	Nákvæmni í báðum skrám og flugstöðinni.
`OPENSHOT_LOG_FILE_LEVEL`	Nákvæmni aðeins í báðum skrám.
`OPENSHOT_LOG_CONSOLE_LEVEL`	Nákvæmni aðeins í flugstöðinni, fyrir báða hluta OpenShot.
`LIBOPENSHOT_LOG_LEVEL`	Nákvæmni fyrir mynd- og hljóðvélina, í skránni sinni og flugstöðinni.
`LIBOPENSHOT_LOG_FILE_LEVEL`	Nákvæmni aðeins í `libopenshot.log`.
`LIBOPENSHOT_LOG_CONSOLE_LEVEL`	Nákvæmni vélarinnar aðeins í flugstöðinni.

Til dæmis, þessi Linux/macOS flugstöðvarskipun biður um nákvæma vélarskráningu í skránni sinni fyrir eina keyrslu:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

Ef stillingar skarast, hafa skipanalínuvalkostir forgang, síðan umhverfisbreytur, svo Valkostir, og að lokum venjulegar sjálfgefnar stillingar. Hver stjórn hefur áhrif aðeins á þann úttak sem hún lýsir: --debug yfirskrifar ekki vélavalkostinn. Bráðabirgðastillingar breyta ekki vistaðri stillingu þinni. Færðu bendilinn yfir hvaða gátreit sem er til að sjá hvort önnur stilling stjórnar þeirri skrá.

Innan umhverfisstillinga hafa LIBOPENSHOT_ gildi forgang fram yfir OPENSHOT_ gildi fyrir vélina. Innan hvors hóps fyrir sig hefur skrá-eða flugstöðvarstig forgang fram yfir almennt stig. Skipanalínuvalkostir fylgja sömu reglu um skrá/flugstöð. Árekstrarstig á skipanalínu fyrir sama úttak eru hafnað; ógild umhverfisstig eru tilkynnt og hunsuð.

Fyrir eldri skriftur virkjar LIBOPENSHOT_DEBUG enn nákvæm skilaboð vélarinnar í flugstöðinni þegar það er til staðar, jafnvel þótt gildið sé 0. Nýju stigastillingarnar hafa forgang yfir það. LIBOPENSHOT_LOG_FILE er ætlað fyrir forrit sem nota vélina sér; OpenShot sjálft notar loggmöppuna hér að ofan. Breyting á skráningarstillingum breytir ekki valinu þínu um villuskýrslu.

Windows 11 svarar ekki

Ef OpenShot frýs á Windows 11, er þetta þekkt vandamál tengt PyQt5 og aðgengisstillingum í Qt. Þetta gerist þegar ýtt er á Ctrl+C í OpenShot (aðeins á Windows 11). OpenShot hættir að svara og minni leka verður vart (þ.e. því lengur sem OpenShot svarar ekki, því stærri verður minni lekinn þar til forritið hrynur eða notandi lokar því).

Ein einföld lausn er að forðast Ctrl+C á Windows 11 og nota í staðinn hægri-smelltu afritunar/innsetningarvalmyndirnar. Önnur lausn er að endurúthluta „Afrita“ frá Ctrl+C í eitthvað annað, til dæmis Alt+C. Þú getur breytt lyklaborðsstillingum í OpenShot valkostunum. Sjá Lyklaborð.

Villuleit á Windows með GDB

Ef OpenShot hrynur eða frýs á Windows 10/11, munu eftirfarandi skref hjálpa þér að finna orsök hrunsins. Leiðbeiningarnar sýna stack trace úr kóðanum þar sem hrunið á sér stað. Þessar upplýsingar eru mjög gagnlegar fyrir þróunarteymið og mikilvægar til að fylgja með villuskýrslum (fyrir hraðari lausn).

Settu upp nýjustu daglegu útgáfuna

Áður en þú tengir villuleitarforrit, vinsamlegast sæktu nýjustu útgáfuna af OpenShot: https://www.openshot.org/download#daily. Settu upp þessa útgáfu á sjálfgefna staðsetningu: C:\Program Files\OpenShot Video Editor\. Fyrir nákvæmar leiðbeiningar um villuleit á Windows, sjáðu þessa wiki.

Settu upp MSYS2

Windows útgáfa OpenShot er þýdd með umhverfi sem kallast MSYS2. Til að tengja GDB villuleitarforritið við keyrsluskrána openshot-qt.exe, verður þú fyrst að setja upp MSYS2. Þessi aðgerð þarf aðeins að gera einu sinni.

Sæktu og settu upp MSYS2: http://www.msys2.org/
Keyrðu skipanalínu MSYS2 MinGW x64 (til dæmis: C:\msys64\msys2_shell.cmd -mingw64)
Uppfærðu öll pakkana (Afritaðu og límdu eftirfarandi skipun):
```
pacman -Syu
```

Settu upp GDB villuleitarforritið (Afritaðu og límdu eftirfarandi skipun):

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

Ræstu OpenShot með GDB villuleitarforriti

Keyrðu skipanalínu MSYS2 MinGW x64 (til dæmis: C:\msys64\msys2_shell.cmd -mingw64)

Uppfærðu PATH (Afritaðu og límdu eftirfarandi skipanir):

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

Hlaððu OpenShot inn í GDB villuleitarforritið (Afritaðu og límdu eftirfarandi skipanir):

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

Ræstu OpenShot úr GDB skipanalínu (Afritaðu og límdu eftirfarandi skipun):

run --debug

Prenta villuleitarupplýsingar

Þegar OpenShot hefur ræst með GDB tengt, þarftu bara að valda hruni eða frystingu í OpenShot. Þegar hrunið á sér stað, skaltu fara aftur í MSYS2 MinGW64 gluggann og keyra eina af eftirfarandi skipunum (sláðu inn og ýttu á ENTER). Venjulega er fyrsta skipunin bt, sem stendur fyrir backtrace. Fleiri skipanir eru taldar upp hér að neðan.

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

Háupxásar þéttleiki punkta / 4K skjáir

OpenShot Video Editor býður upp á traustan stuðning fyrir háupplausnar (DPI) skjái, sem tryggir að viðmótið sé skýrt og auðvelt að lesa á skjám með mismunandi DPI-stillingum. Þessi stuðningur er sérstaklega gagnlegur á 4K skjám og öðrum skjám með háa upplausn.

DPI meðvitund fyrir hvern skjá

OpenShot er meðvitaður um DPI fyrir hvern skjá fyrir sig, sem þýðir að hann getur stillt stærðarmælikvarða sína sjálfkrafa eftir DPI-stillingum hvers tengds skjás. Þetta hjálpar til við að veita samræmda upplifun á mismunandi skjám.

DPI-stærðarmælikvarði á Windows

Á Windows styttir OpenShot stærðarmælikvarðann í næsta heiltölu til að viðhalda sjónrænu heilindum. Þetta hjálpar til við að forðast sjónræna galla í viðmótinu og heldur viðmótsþáttum skörpum og vel raðað. Vegna þessarar styttingar geta sumar stærðarmælikvarða valdið stærri leturgerðum og viðmótsþáttum en búist var við.

125% stærðarmælikvarði styttist í 100%
150% stærðarmælikvarði styttist í 200%

Leiðir til að fínstilla nákvæmni

Þó að stytting hjálpi til við að viðhalda hreinu viðmóti, eru til leiðir fyrir notendur sem þurfa nákvæmari stjórn á stærðarmælikvarða. Þessar aðferðir eru ekki mælt með vegna mögulegra sjónrænna galla:

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- Að stilla þetta umhverfisbreytu getur slökkt á styttingu og leyft nákvæmari stærðarmælikvarða.
- Athugið: Þetta getur valdið sjónrænum göllum, sérstaklega í tímalínunni, og er ekki mælt með.
QT_SCALE_FACTOR=1.25 (eða svipað gildi)
- Handvirk stilling á stærðarmælikvarða getur veitt fínni stillingar á leturgerð og viðmótsstærð.
- Þetta má einnig stilla í Stillingum (Stærð notendaviðmóts), en búist er við vandamálum með ramma/línur á Windows við brotakennda stærðarmælikvarða.
- Athugið: Þessi aðferð getur einnig valdið sjónrænum göllum og gert OpenShot erfiðara í notkun.

Fyrir frekari upplýsingar um að stilla þessar umhverfisbreytur, vinsamlegast heimsækið https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.