Forritarar

Ef þú ert forritari (eða vilt verða forritari) og hefur áhuga á að þróa nýja eiginleika, laga villur eða bæta notendaviðmót OpenShot, munu eftirfarandi kaflar útskýra hvernig á að byrja og taka þátt!

Heildarsýn

OpenShot Video Editor hefur þrjá aðalhluta, Python & PyQt notendaviðmót (openshot-qt), C++ hljóðbókasafn (libopenshot-audio) og C++ myndbókasafn (libopenshot). Ef þú þekkir ekki Python, PyQt eða C++, væri gott að kynna þér þau efni núna.

Margir villur má laga og nýja eiginleika bæta við með aðeins Python þekkingu, þar sem C++ hlutarnir taka ekki þátt í notendaviðmótinu. Python er frábært tungumál, mjög skemmtilegt að læra og eina forsendan til að verða OpenShot forritari!

Aðvörun

Leiðbeiningarnar hér á eftir eru fyrir Ubuntu Linux, sem er auðveldasta umhverfið til að stilla fyrir OpenShot þróun. Ef þú notar annað stýrikerfi, mæli ég með að keyra sýndarvél með Ubuntu LTS áður en þú heldur áfram.

Ef þú þarft að nota Windows eða Mac kerfi til þróunar, byrjaðu á að skoða byggingarleiðbeiningar í libopenshot wiki. Að byggja bókasafnið með öllum háðum hlutum er erfiðasti hluti ferlisins.

Sækja nýjustu kóðann

Áður en við getum lagað villur eða bætt við eiginleikum þurfum við að fá kóðann á tölvuna þína.

Notaðu git til að klóna þrjú geymslurnar okkar:

git clone https://github.com/OpenShot/libopenshot-audio.git
git clone https://github.com/OpenShot/libopenshot.git
git clone https://github.com/OpenShot/openshot-qt.git

Stilla þróunarumhverfið þitt

Til að geta þýtt eða keyrt OpenShot þurfum við að setja upp nokkrar háðar bókasöfn á kerfið þitt. Auðveldasta leiðin er með Daily PPA. PPA er óopinbert Ubuntu geymslusvæði með hugbúnaðarpökkum okkar til niðurhals og uppsetningar.

sudo add-apt-repository ppa:openshot.developers/libopenshot-daily
sudo apt-get update
sudo apt-get install openshot-qt \
                     build-essential \
                     cmake \
                     catch2 \
                     libx11-dev \
                     libasound2-dev \
                     libavcodec-dev \
                     libavdevice-dev \
                     libavfilter-dev \
                     libavformat-dev \
                     libavresample-dev \
                     libavutil-dev \
                     libfdk-aac-dev \
                     libfreetype6-dev \
                     libjsoncpp-dev \
                     libmagick++-dev \
                     libopenshot-audio-dev \
                     libprotobuf-dev \
                     libqt5svg5-dev \
                     libswscale-dev \
                     libunittest++-dev \
                     libxcursor-dev \
                     libxinerama-dev \
                     libxrandr-dev \
                     pkg-config \
                     python3-dev \
                     protobuf-compiler \
                     qtbase5-dev \
                     libqt5svg5-dev \
                     libxcb-xfixes0-dev \
                     qtmultimedia5-dev \
                     swig

OpenShot styður PyQt5, PyQt6 og PySide6. libopenshot verður að byggja á réttum Qt útgáfu fyrir bindinguna sem þú notar (Qt5: PyQt5, Qt6: PyQt6 eða PySide6).

Fyrir PySide6 (Qt6) bindingar, settu upp þessi pakkar:

sudo apt-get install \
                     python3-pyside6.qtcore \
                     python3-pyside6.qtgui \
                     python3-pyside6.qtwidgets \
                     python3-pyside6.qtstatemachine \
                     python3-pyside6.qtsvg \
                     python3-pyside6.qtuitools \
                     shiboken6

Fyrir PyQt6, settu upp þessa pakka:

sudo apt-get install \
                     qt6-base-dev \
                     qt6-base-dev-tools \
                     qt6-tools-dev \
                     qt6-svg-dev

PyQt6 keyrslutíminn verður að veita QtCore, QtGui, QtWidgets, QtSvg, QtStateMachine og uic. Sum dreifikerfi skipta þessum einingum í aðskilda pakka. Sérstaklega inniheldur python3-pyqt6 pakkinn í Ubuntu 24.04 ekki QtStateMachine. Í þeirri útgáfu, notaðu PySide6 pakkana hér að ofan eða settu upp fullkomna PyQt6 hjólið í Python sýndarumhverfi:

python3 -m venv .venv
.venv/bin/python -m pip install PyQt6

Staðfestu valda Qt bindingu og nauðsynlega eininga áður en OpenShot er ræst:

PYTHONPATH=src OPENSHOT_QT_API=pyqt6 .venv/bin/python -c \
    "from qt_api import QT_API, QStateMachine; print(QT_API, QStateMachine)"

Nú ættir þú að hafa klónað alla þrjá OpenShot hluta í möppur á tölvunni þinni, sett upp OpenShot daglega PPA og allar nauðsynlegar háðar bókasöfn fyrir þróun og keyrslu. Þetta er frábær byrjun og við erum tilbúin að byrja að þýða kóða!

libopenshot-audio (Byggingarleiðbeiningar)

Þetta bókasafn er nauðsynlegt fyrir hljóðspilun og hljóðáhrif. Það byggir á JUCE hljóðrammanum. Hér eru skipanirnar til að byggja það:

cd libopenshot-audio
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=dist ..
make
make install

Í raun skiptum við yfir í libopenshot-audio/build möppuna og keyrum cmake .. á yfirmöppunni. Þetta finnur háðar skrár og býr til Makefile skrár sem þarf til að þýða bókasafnið. Síðan notar make þessar Makefile skrár til að þýða bókasafnið og make install setur það upp á tilgreindan stað. Ef CMAKE_INSTALL_PREFIX er ekki stillt, verður uppsetningin í /usr/local/ (sjálfgefið) og make install krefst stjórnandaheimilda.

libopenshot (Byggingarleiðbeiningar)

Þetta bókasafn er nauðsynlegt fyrir myndbandsafkóðun, kóðun, hreyfimyndagerð og nánast allt annað. Það sér um alla þunga vinnu við myndbandsklippingu og spilun. Hér eru skipanirnar til að byggja það:

cd libopenshot
mkdir build
cd build
cmake -DLIBOPENSHOT_AUDIO_DIR=../../libopenshot-audio/build/dist ..
make

Í raun skiptum við yfir í libopenshot/build möppuna og keyrum cmake .. á yfirmöppunni. Þetta finnur háðar skrár og býr til Makefile skrár sem þarf til að þýða bókasafnið. Síðan notar make þessar Makefile skrár til að þýða bókasafnið. Þar sem við tilgreindum staðsetningu fyrir þýdda libopenshot-audio uppsetningu, verður sú útgáfa notuð í stað kerfisútgáfunnar (ef hún er til).

Við setjum ekki upp libopenshot eftir þýðingu því það er ekki nauðsynlegt. Fyrir prófanir getum við látið OpenShot nota libopenshot beint úr build möppunni okkar.

Tungumálatengingar

libopenshot API-ið er fáanlegt á nokkrum tungumálum í gegnum SWIG tengingar. Python er notað í OpenShot notendaviðmótinu, og við bjóðum einnig upp á Ruby og Java tengingar. Tilraunastyrkur fyrir Godot 4.4 er innifalinn fyrir forritara sem vilja samþætta myndbandsklippingu í Godot leikjavélina. Allar þessar tengingar vísa í sama C++ kóðagrunninn svo þú getur klippt myndbönd úr því umhverfi sem þér hentar best.

openshot-qt (Ræsingarleiðbeiningar)

Þetta er aðal PyQt Python forritið okkar. Þar sem það er skrifað í Python þarf það ekki að þýða til að keyra. Til að ræsa OpenShot úr kóðanum með nýbyggðu libopenshot-audio og libopenshot bókasöfnum, notaðu eftirfarandi skipanir:

cd openshot-qt
PYTHONPATH=../libopenshot/build/src/bindings/python
python3 src/launch.py

Þetta ætti að ræsa OpenShot notendaviðmótið. Öll breytingar sem þú hefur gert á upprunalegu kóðaskjölunum (*.py Python skrár, *.ui PyQt UI skrár, o.s.frv.) verða teknar með. Þetta krefst libopenshot-audio og libopenshot bókasafna, og ef eitthvað fór úrskeiðis í skrefunum hér að ofan, mun OpenShot líklega ekki ræsa.

Ef OpenShot ræsist núna, til hamingju! Þú ert með virka staðbundna útgáfu af OpenShot sem keyrir af þínum staðbundna upprunakóða. Prófaðu að gera nokkrar breytingar á upprunakóðanum og ræstu OpenShot aftur… þú ættir nú að sjá breytingarnar þínar!

Skipanalínurvalkostir

Þessir valkostir virka með uppsettri OpenShot-forritinu, þar með talið openshot-qt.exe á Windows. Þegar keyrt er úr kóða, notaðu python3 src/launch.py í stað forritsnafnsins. Settu valkosti fyrir framan allar skráarleiðir sem þú vilt að OpenShot opni.

Skipanalínuvalkostir OpenShot
Valmöguleiki	Hvað það gerir
`-h`, `--help`	Sýna tiltæka valkosti og hætta.
`-V`, `--version`	Prenta út útgáfu OpenShot og hætta.
`-l CODE`, `--lang CODE`	Notaðu valið viðmótsmál fyrir þessa keyrslu. Kóðinn verður að vera einn af þeim sem sýndir eru með `--list-languages`.
`--list-languages`	Skrá yfir studda málkóða og hætta.
`--path FOLDER`	Bæta möppu við leitarslóð Python eininga. Þú getur endurtekið þennan valkost til að bæta við fleiri möppum.
`--feedback-preview`	Sýna ábendingu um endurgjöf við ræsinguna án þess að merkja boð um sýningu í vistaðar stillingar.
`--update-preview`	Sýna tilkynningu um uppfærslu við ræsinguna. Báðir forskoðunarvalkostirnir má nota saman.
`--test-models`	Virkja gagnalíkanprófun Qt fyrir þróun (krefst Qt 5.11 eða nýrra).
`-d`, `--debug`, `--debug-ui`	Bæta við ítarlegum viðmótsboðum í skrá yfir atburði og í skipanalínu.
`--debug-engine`	Bæta við ítarlegum skilaboðum frá mynd- og hljóðvél í atburðaskrá og skipanalínu.
`--log-level LEVEL`	Stilla skráningarstig fyrir báða hluta OpenShot, í skrám og skipanalínu.
`--log-file-level LEVEL`	Stilla skráningarstig í báðum atburðaskrám.
`--log-console-level LEVEL`	Stilla skráningarstig í skipanalínu fyrir báða hluta OpenShot.
`--debug-file`	Bæta við ítarlegum viðmótsboðum aðeins í atburðaskrá. Þessi eldri valkostur er samþykktur en sýndur ekki með `--help`.
`--debug-console`	Bæta við ítarlegum viðmótsboðum aðeins í skipanalínu. Þessi eldri valkostur er samþykktur en sýndur ekki með `--help`.
`PROJECT.osp` eða slóðir að fjölmiðlaskrám	Opna verkefni þegar fyrsta skráarleiðin endar á `.osp`. Annars hefja nýtt verkefni og flytja inn gefnar fjölmiðlaskrár.

Fyrir LEVEL, notaðu debug, info, warning, error, critical eða off. Sjá Að nota skráningar til að greina vandamál fyrir staðsetningu atburðaskráa, dæmi og frekari upplýsingar um val á skráningarstillingum.

GitHub vandamál

Nú þegar þú hefur tekist að þýða og ræsa OpenShot Video Editor úr upprunakóða, skaltu skoða lista okkar yfir villuskýrslur á GitHub: OpenShot Issues. Einnig hvetjum við þig til að fylla út stutta framlagsskjalið og kynna þig!