Komentorivikäyttöliittymä

Ota OpenShot osaksi komentorivityötäsi. Tuo materiaalia, leikkaa ja järjestä leikkeitä, lisää tehosteita, animaoi ominaisuuksia avainkehyksillä ja vie videoita terminaalistasi. Käytä muutamaa komentoa automatisoidaksesi toistuvia muokkauksia, kirjoita skripti toistuvaan projektiin tai anna tekoälyagentin auttaa videon kokoamisessa ja hienosäädössä.

Komentorivi toimii samoilla projekteilla kuin editori. Voit hallita avointa editoria ja tarkastella muutoksia lennossa tai työskennellä päänettömässä istunnossa ilman ikkunan avaamista. Istunto pitää projektisi avoinna komentojen välillä, mukaan lukien muokkaukset, kumoamishistoria ja vientitehtävät. Tallenna se .osp-projektina, kun haluat jatkaa muokkaamista myöhemmin.

Aloittaminen

Käytä asennettua OpenShot-suoritustiedostoasi lisättynä --cli. Aloita komennolla intro saadaksesi lyhyen oppaan istunnoista, muokkauksesta, animaatiosta ja tallennuksesta, tai help saadaksesi yleiskatsauksen komennoista. Näissä komennoissa ei tarvita aktiivista istuntoa. Alla olevat esimerkit vaativat OpenShotin version, joka sisältää komentorivimuokkauksen.

Linux AppImage

Hakemistosta, joka sisältää ladatun AppImage-tiedostosi:

./OpenShot.AppImage --cli intro
./OpenShot.AppImage --cli help

Korvaa OpenShot.AppImage ladatun tiedostosi nimellä. Jos AppImageLauncher näyttää työpöydän integrointidialogit, aseta APPIMAGELAUNCHER_DISABLE=1 ennen komennon suorittamista:

APPIMAGELAUNCHER_DISABLE=1 ./OpenShot.AppImage --cli intro

Skriptejä tai toistuvia komentoja varten aseta se kerran nykyisessä kuoressasi:

export APPIMAGELAUNCHER_DISABLE=1
./OpenShot.AppImage --cli session start

Muuttuja on asetettava ennen AppImage:n käynnistämistä: AppImageLauncher voi siepata sen ennen kuin OpenShot saa --cli. Suhteelliset mediaradat ja @batch.json-tiedostot ratkaistaan työskentelyhakemistostasi. Pidä AppImage-tiedosto saatavilla, kun sen istunnot tai vientitehtävät ovat käynnissä.

Linux Snap

Käytä OpenShot Snap -versiota:

snap run openshot-qt --cli intro
snap run openshot-qt --cli help
snap run openshot-qt --cli session start

Snapin tiedostoluvat koskevat myös komentorivimuokkausta. Säilytä media, projektit ja vientitiedostot paikoissa, joihin Snapilla on pääsy, kuten kotikansiossasi. Salli pääsy ulkoisille asemille yhdistämällä removable-media-oikeus:

sudo snap connect openshot-qt:removable-media

Windows

Tärkeä

Käytä openshot-qt-cmd.exe komentorivimuokkaukseen Windowsilla. Tämä konsolisovellus näyttää komentojen tulokset, ohjeet ja virheet terminaalissasi. Työpöytäsovellus openshot-qt.exe ei näytä normaalia tulostetta interaktiivisessa terminaalissa, jolloin komennot eivät anna näkyvää palautetta ja CLI:n käyttö vaikeutuu.

PowerShellissä, OpenShotin asennushakemistosta:

& .\openshot-qt-cmd.exe --cli intro
& .\openshot-qt-cmd.exe --cli help
& .\openshot-qt-cmd.exe --cli session start

Jos olet eri hakemistossa, käytä koko polkua openshot-qt-cmd.exe-tiedostoon. Säilytä --cli suoritustiedoston nimen jälkeen.

macOS

Asennukselle Applications-kansioon:

"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli intro
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli help

Komentojen löytäminen

Tässä oppaassa openshot-cli on lyhenne asennuksesi komennolle, kuten snap run openshot-qt --cli tai ./OpenShot.AppImage --cli. Jotkut asennukset tarjoavat myös suoran openshot-cli-komennon. Lähdekoodista ajettaessa käytä komentoa python3 src/launch.py --cli OpenShotin Python-ympäristössä.

Pelkkä --cli, --cli help ja --cli --help näyttävät saman yleiskatsauksen. Ohje tarkentuu komentojen mukaan:

openshot-cli clip help
openshot-cli clip keyframe help
openshot-cli clip keyframe set help
openshot-cli edit help
openshot-cli text help
openshot-cli effects list
openshot-cli effects audiovisualization help
openshot-cli effects audiovisualization help --property background

Ryhmäohje selittää työnkulkuja esimerkkien avulla; toiminto-ohje kuvaa argumentit ja toiminnan. --help vastaa perässä olevaa help-komentoa. Kaikki ohjekomennot toimivat ilman muokkausistuntoa.

effects list näyttää saatavilla olevat tehosteet lyhyine kuvauksineen. Tehosteohje selittää niiden ominaisuudet, oletukset, valinnat ja arvovälit. effects instances listaa tehosteet, jotka on jo liitetty leikkeitä, sisältäen vanhemman leikkeen tunnukset. Luokkien nimet, näyttönimet ja alaviiva-aliakset tunnistavat saman tehosteen.

Työskentely skriptien ja tekoälyagenttien kanssa

Tekoälykoodausagentit kuten Codex ja Claude Code voivat käyttää CLI:tä tarkastellakseen ja muokatakseen OpenShot-projekteja terminaalikomennoilla. Anna agentillesi polku OpenShotin suoritustiedostoon, media tai projekti, jonka kanssa työskennellä, sekä haluttu lopputulos: kesto, mitat, animaatiotyyli ja vientipaikka. Pyydä sitä lukemaan --cli intro ennen aloittamista. Samat komennot toimivat, kun kirjoitat ne itse tai ajat ne skriptistä.

Aloita komennolla intro, ja käytä tarvittaessa komentokohtaista ohjetta. Hyödyllinen työnkulku on valita istunto, tarkastella projektia, tehdä pieni joukko muutoksia, tarkistaa tulos ja tallentaa. Komennot palauttavat jäsenneltyä JSONia, jotta skriptit ja agentit voivat käyttää objektitunnuksia ja tuloksia suoraan ilman ruutunäytön tulkintaa.

  • Tarkasta ennen muokkaamista. Käytä palautettuja tunnuksia ja ominaisuustietoja sen sijaan, että arvailet nimiä, raidenumeroita tai ajoitusta. Valitse istunto selkeästi, kun useampi projekti on avoinna.

  • Ryhmittele toistuvat muokkaukset. Käytä edit apply sarjaan muutoksia tai edit bulk soveltaaksesi mallia valittuihin leikkeitä. Vahvista --dry-run-komennolla ennen erän soveltamista.

  • Tarkista animaatio. Valitse koordinaatisto, aloita muutamilla avainkehyksillä ja käytä pehmennysohjelmia tutun liikkeen luomiseksi. keyframe preview ottaa näytteitä käyrästä, jotta voit havaita tauot tai hyppäykset ennen vientiä. Tarkista myös renderöity liike; pelkkä kontaktikuvakollaasi ei kerro, miltä animaatio tuntuu.

  • Tallenna ja seuraa vientiä. Tallenna projekti nimenomaisesti ja tarkista vientitehtävän tila ennen kuin pidät tulosta valmiina. Jos pyyntö aikakatkaistaan, tarkista sen tila ennen muokkauksen toistamista.

Alla olevat osiot selittävät nämä työnkulut ja niiden ajoituskäytännöt.

Istunnot ja tulosteet

Istunnon käynnistäminen tai löytäminen

Käynnistä yksi päänätön istunto (ilman editori-ikkunaa):

openshot-cli session start

Avaa olemassa oleva projekti käynnistyksen yhteydessä lisäämällä --project "/polku/projekti.osp". Onnistuneen JSON-vastauksen sisältää result.session_id. Kopioi tämä arvo. Jos OpenShot on jo käynnissä tai olet unohtanut tunnuksen, etsi käytettävissä olevat istunnot komennolla:

openshot-cli session list

Valitse istunto projektillesi, jota aiot muokata. Sinun ei tarvitse käynnistää uutta istuntoa jokaista komentoa varten.

Istunnon valinta

Vihje

Aseta OPENSHOT_SESSION kerran, sitten suorita komennot normaalisti. Päätteesi muistaa valitun istunnon, joten sinun ei tarvitse antaa --session joka komennossa. Käytä alla olevaa PowerShell- tai Bash-esimerkkiä.

Korvaa alla oleva SESSION_ID arvolla, jonka saat komennolla session start tai session list.

Windows PowerShell:

$env:OPENSHOT_SESSION = "SESSION_ID"
& .\openshot-qt-cmd.exe --cli timeline view
& .\openshot-qt-cmd.exe --cli export start "C:\path\test.mp4" --wait

Linux Bash:

export OPENSHOT_SESSION="SESSION_ID"
./OpenShot.AppImage --cli timeline view
./OpenShot.AppImage --cli export start "/path/test.mp4" --wait

macOS:ssä käytä samaa export-syntaksia. macOS- tai Snap-komentoja varten korvaa asennuksesi suoritettava tiedosto kohdasta Aloittaminen. Valinta pysyy voimassa tässä pääteikkunassa ja sen kautta käynnistetyissä komennoissa. Aseta se uudelleen uudessa pääteikkunassa tai päivitä se vaihtaessasi istuntoa.

Jäljellä olevat muokkaus- ja vientiesimerkit olettavat, että OPENSHOT_SESSION on asetettu. Seuraava alaluku näyttää, miten tunnus kaapataan automaattisesti skriptejä varten.

Kohdista eri istunto vain yhdelle komennolle käyttämällä --session. Se ohittaa OPENSHOT_SESSION muuttamatta päätteen valintaa:

openshot-cli --session OTHER_SESSION_ID project get

Pakatussa suoritettavassa tiedostossa aseta tämä ohitus --cli jälkeen ja komentoryhmän ennen: --cli --session MUU_ISTUNTO_ID project get.

Automaattinen valinta toimii vain, kun on olemassa täsmälleen yksi saavutettavissa oleva istunto. Jos näet session_required, suorita session list ja valitse tarkoitettu istunto nimenomaisesti. Jos sitä ei enää ole listattu, käynnistä se uudelleen ja käytä uutta tunnusta. Ohje, intro ja istuntojen haku eivät vaadi valittua istuntoa.

Istuntotunnuksen automaattinen kaappaus

Skriptit voivat lukea result.session_id suoraan JSON-vastauksesta, jonka antaa session start, ja asettaa OPENSHOT_SESSION seuraaville komennoille. Tunnusta ei tarvitse kopioida käsin tai lukea lokitiedostoa. Varmista, että käynnistys onnistui ennen palautetun tunnuksen käyttöä.

Windows PowerShell (aseta suoritettavan tiedoston polku asennuksellesi):

$openshot = "C:\Program Files\OpenShot Video Editor\openshot-qt-cmd.exe"
$reply = & $openshot --cli session start
if ($LASTEXITCODE -ne 0) { throw "OpenShot session startup failed" }
$session = $reply | ConvertFrom-Json
if (-not $session.ok -or -not $session.result.session_id) {
    throw "OpenShot did not return a session ID"
}
$env:OPENSHOT_SESSION = $session.result.session_id
& $openshot --cli timeline view

Linux Bash (vaatii jq JSON:n lukemiseen):

openshot="/full/path/to/OpenShot.AppImage"
export APPIMAGELAUNCHER_DISABLE=1
if reply=$("$openshot" --cli session start) &&
   session_id=$(printf '%s' "$reply" | jq -er 'select(.ok == true) | .result.session_id | strings | select(length > 0)'); then
    export OPENSHOT_SESSION="$session_id"
    "$openshot" --cli timeline view
else
    echo "OpenShot session startup failed" >&2
fi

Ympäristömuuttuja valitsee istunnon tämän päätteen kautta käynnistetyille komennoille; se ei muuta järjestelmätason asetusta. Istunnon käynnistäminen ei aseta muuttujaa automaattisesti. Istunnon lopettamisen jälkeen tyhjennä valinta komennolla Remove-Item Env:OPENSHOT_SESSION PowerShellissä tai unset OPENSHOT_SESSION Bashissa.

Istunnon näyttäminen ja lopettaminen

Näyttääksesi valitun istunnon editorissa:

openshot-cli session show

Työpöydällä session show luo editorin samaan prosessiin ja säilyttää käynnissä olevan projektin, tunnukset, historian, vientitehtävät ja yhteyden. Toistuvat kutsut tuovat olemassa olevan ikkunan esiin. session start --show avaa sen välittömästi. Näyttöä vailla käynnistetyt istunnot tai ne, jotka on käynnistetty QT_QPA_PLATFORM=offscreen/minimal-asetuksilla, eivät voi myöhemmin näyttää työpöytäikkunaa. Näille istunnoille tallenna ja avaa projekti uudessa työpöytäistunnossa. Kun se on näytetty, sulje istunto editori-ikkunan kautta.

Yleiset valinnat (--session, --timeout) tulevat komennon eteen. session serve pysyy etualalla valvojille; session start palautuu, kun taustapalvelin rekisteröityy. session stop kieltäytyy tallentamattomista muutoksista ja aktiivisista vienneistä. Käytä --discard vain tarkoituksellisesti hylätäksesi tallentamattomat muokkaukset.

Komennon tuloste

Tulokset ovat JSON-muodossa stdoutissa, paitsi oletustekstiaikajanassa. Virheet ovat JSON-muodossa stderrissä poistumistilalla 1; argumenttien jäsentäjän virheet poistuvat tilalla 2. Muutokset palauttavat tiiviit yhteenvedot inspect-komennolla. get palauttaa alkuperäisen objektin JSON-muodossa. Projektivastaukset sisältävät revision; efektikatalogin vastaukset eivät vaadi istuntoa. Päänättömien istuntojen lokit sijaitsevat rekisterimerkintöjensä vieressä. OPENSHOT_SESSION_DIR ohittaa oletuskansion ~/.openshot_qt/sessions.

Istunnot hyväksyvät komentoja paikallisesti tietokoneellasi. Pidä istuntorekisteri yksityisenä, koska se sisältää tunnistetiedot, joita käytetään muokkausistuntoihisi pääsemiseen. Vienti toimii tilannekuvasta, joten voit jatkaa muokkaamista työn suorittaessa.

Projektien avaaminen ja tallentaminen

OpenShot-projekti (.osp) tallentaa muokattavan aikajanan. Viennin avulla luodaan valmis video; projektin tallentaminen antaa sinun palata sen leikkeisiin, tehosteisiin ja avainkehyksiin myöhemmin. Tallenna projektisi erikseen, vaikka vietkin videon.

Projektin avaaminen

Käynnistä istunto olemassa olevan projektin kanssa:

openshot-cli session start --project "/home/me/Videos/My Project.osp"

Lisää --show avataksesi myös sen editori-ikkunan. Käyttääksesi jo käynnissä olevaa editoria, etsi se komennolla session list. Aseta OPENSHOT_SESSION sen palauttamaan istunnon tunnukseen, ja avaa tai tarkastele projektia:

openshot-cli project open "/home/me/Videos/My Project.osp"
openshot-cli project get

Korvaa esimerkkipolku omallasi ja lainaa polut, jotka sisältävät välilyöntejä. project open korvaa valitun istunnon nykyisen projektin. Se kieltäytyy hylkäämästä tallentamattomia muokkauksia, ellei erikseen lisätä --discard; tallenna muokkaukset ensin, jos haluat säilyttää ne. CLI:n kautta avaaminen ei näytä vuorovaikutteisia puuttuvan median valintaikkunoita, joten pidä projektin lähdemedia saatavilla.

Uutta, tyhjää projektia varten käytä session start ilman --project-valitsinta, tuo sitten media ja lisää leikkeet kuten kohdassa Muokkaus on kuvattu.

Projektin tai kopion tallentaminen

Tallenna uuteen tiedostoon tai luo erillinen versio ennen lisämuutosten tekemistä:

openshot-cli project save "/home/me/Videos/My Project v2.osp"

Päivittääksesi olemassa olevan tiedoston, salli korvaus nimenomaisesti:

openshot-cli project save "/home/me/Videos/My Project v2.osp" --overwrite

Anna aina kohdepolku. .osp-tiedoston tallentaminen ei pakkaa kaikkea lähdemateriaalia tiedostoon; pidä viitattu media saatavilla projektia siirrettäessä tai avattaessa uudelleen.

Videon vienti

Automatisoi renderöinti ja vienti skripteistä tai tekoälyagenttien avulla käyttämällä projektin asetuksia tai valitsemalla eri ulostuloprofiili jokaiselle renderöinnille. Vientitehtävät voivat toimia taustalla tai odottaa valmistumista ennen skriptisi jatkamista. Renderöidäksesi MP4:n projektin resoluutiolla ja kuvataajuudella:

openshot-cli export start "/home/me/Videos/video.mp4" --wait

Oletuksena OpenShot käyttää H.264-videota ja AAC-ääntä. Korvaa esimerkkipolku omalla kohteellasi, käyttäen olemassa olevaa kansiota ja uutta tiedostonimeä. Olemassa olevia tulosteita ei koskaan korvata. Vienti ei tallenna muokattavaa .osp-projektiasi; käytä project save-komentoa erikseen säilyttääksesi muokkaustyösi.

--wait-valitsin pitää komennon käynnissä, kunnes vienti valmistuu tai epäonnistumisesta ilmoitetaan. Tarkista valmis video ennen sen jakamista.

Viennin etenemisen tarkistaminen

Jätä pois --wait aloittaaksesi viennin taustalla. Vastaus sisältää työn tunnuksen, jota voit käyttää etenemisen tarkistamiseen:

openshot-cli export start "/home/me/Videos/video.mp4"
openshot-cli export status JOB_ID
openshot-cli export status JOB_ID --wait
openshot-cli export list

Korvaa JOB_ID palautetulla tunnuksella. Jos odotus aikakatkaistaan, vienti jatkuu; tarkista sama työ sen sijaan, että aloittaisit uuden viennin. Työn pysäyttämiseksi käytä komentoa export cancel JOB_ID. Jokainen työ tallentaa aikajanan käynnistyessään, joten myöhemmät muokkaukset eivät vaikuta jo käynnissä olevaan vientiin.

Odotusaika on oletuksena 600 sekuntia; säädä tätä --wait-timeout-valitsimella. Tämä on erillinen globaalista per-pyyntö --timeout-asetuksesta. Viennin epäonnistumiset, peruutukset ja odotusajan ylitykset päättyvät tilakoodilla 1 ja sisältävät työn tiedot.

Vienti useissa profiileissa

Vie sama aikajana eri resoluutioilla tai kuvasuhteilla valitsemalla vientiprofiili jokaiselle ulostulolle. Vientiprofiili koskee vain kyseistä työtä; se ei muuta muokkausprojektin profiilia. Profiili määrittää mitat, kuvataajuuden ja kuvasuhteen; vientiesiasetus valitsee koodausasetukset, kuten MP4/H.264.

Etsi käytettävissä olevat profiilit ja tarkastele niiden asetuksia:

openshot-cli profile list --search 720
openshot-cli profile list --search 1080
openshot-cli profile get builtin:01280x0720p0030_16-09

Esimerkiksi vie vaakasuorat versiot 720p- ja 1080p-resoluutiolla, sitten neliöversio 1080 x 1080. Nämä profiilit käyttävät kaikki 30 fps:

openshot-cli export start "/home/me/Videos/video-720p.mp4" --profile builtin:01280x0720p0030_16-09 --wait
openshot-cli export start "/home/me/Videos/video-1080p.mp4" --profile builtin:01920x1080p0030_16-09 --wait
openshot-cli export start "/home/me/Videos/video-square.mp4" --profile builtin:01080x1080p0030_01-01 --wait

Käytä eri ulostulotiedostonimeä jokaiselle versiolle. Säilytä muokkaukset muuttumattomina töiden välillä, kun haluat vastaavia versioita. Kuvasuhteen muuttaminen voi muuttaa rajauksia: tarkista jokainen ulostulo, erityisesti otsikot ja animoidut kohteet. Erillisesti koostettua neliö- tai pystysuuntaista versiota varten tallenna projektin kopio, muuta sen profiilia ja säädä leikkeet ennen vientiä. Katso Profiilit ja vientiasetukset alla mukautettuja profiileja ja koodausvaihtoehtoja varten.

Useiden projektien erävienti

Käytä samaa komentorivittömänä toimivaa istuntoa useiden tallennettujen projektien renderöintiin peräkkäin. Avaa projekti, vie se --wait-valitsimella, ja avaa sitten seuraava projekti. Alla olevat esimerkit käyttävät kunkin projektin omaa resoluutiota ja kuvataajuutta ja luovat MP4-tiedostot .osp-tiedostojen viereen. Lisää vientikomentoon --profile PROFILE_ID käyttääksesi yhtä ulostuloprofiilia kaikille projekteille.

Suorita ensin yllä oleva vastaava automaattinen istunnon tunnuksen esimerkki onnistuneesti samassa päätelaitteessa. Se määrittelee openshot ja valitsee uuden istunnon. Korvaa alla olevat projektipolut omillasi. Käytä erillisiä tulostiedostonimiä, joita ei vielä ole olemassa; esimerkit tarkistavat kaikki kohteet ennen erän aloittamista.

Windows PowerShell:

$projects = @(
    "C:\VideoProjects\First.osp",
    "C:\VideoProjects\Second.osp"
)
foreach ($project in $projects) {
    if (-not (Test-Path -LiteralPath $project -PathType Leaf)) {
        throw "Project not found: $project"
    }
    $output = [System.IO.Path]::ChangeExtension($project, ".mp4")
    if (Test-Path -LiteralPath $output) { throw "Output already exists: $output" }
}
foreach ($project in $projects) {
    $output = [System.IO.Path]::ChangeExtension($project, ".mp4")
    & $openshot --cli project open $project
    if ($LASTEXITCODE -ne 0) { throw "Could not open: $project" }
    & $openshot --cli export start $output --wait --wait-timeout 86400
    if ($LASTEXITCODE -ne 0) { throw "Export needs attention: $output" }
}
& $openshot --cli session stop
if ($LASTEXITCODE -ne 0) { throw "Could not stop the session" }
Remove-Item Env:OPENSHOT_SESSION

Linux Bash (sulkeet pitävät virheenkäsittelyn erän sisäisenä):

(
    set -e
    : "${OPENSHOT_SESSION:?Run the session startup example first}"
    projects=(
        "/home/me/VideoProjects/First.osp"
        "/home/me/VideoProjects/Second.osp"
    )
    for project in "${projects[@]}"; do
        test -f "$project" || { echo "Project not found: $project" >&2; exit 1; }
        output="${project%.osp}.mp4"
        test ! -e "$output" || { echo "Output already exists: $output" >&2; exit 1; }
    done
    for project in "${projects[@]}"; do
        "$openshot" --cli project open "$project"
        "$openshot" --cli export start "${project%.osp}.mp4" --wait --wait-timeout 86400
    done
    "$openshot" --cli session stop
) && unset OPENSHOT_SESSION

Molemmat ohjeet pysäyttävät erän komentovirheen sattuessa ja jättävät istunnon tarkasteltavaksi. Odotusraja on tässä 24 tuntia vientiä kohden. Odotusajan umpeutuessa renderöinti jatkuu: käytä export list ja export status JOB_ID --wait ennen uudelleenyrittämistä. Valmiit videot jäävät levylle; poista valmiit projektit erästä ennen jatkamista. Virheen korjauksen jälkeen pysäytä istunto ja tyhjennä sen ympäristömuuttuja, kun olet valmis.

Esiasetusten ja koodausasetusten valinta

Löydä asennetut vientiesiasetukset ja tuetut asetukset:

openshot-cli export preset list
openshot-cli export preset get builtin:format_mp4_x264
openshot-cli export capabilities
openshot-cli export start /tmp/reel.mp4 --preset builtin:format_mp4_x264 --quality med --wait

Vienti hyväksyy myös --from-file FILE_ID -valinnan valinnaisella --create-custom. Asetukset ratkaistaan tässä järjestyksessä: projektin oletukset, esiasetus, edistynyt JSON, eksplisiittiset profiili/laatu/alue-liput. Edistynyt JSON paljastaa video-/ääni-koodekit ja bittinopeuden, äänen asettelun/nopeuden/kanavat, natiivikoodekkiasetukset, laitteistolaitteiden asetukset ja säikeiden määrät.

Esimerkiksi valitse kooderin vaihtoehto edistyneen JSON:n kautta:

openshot-cli export start /tmp/small.mp4 --profile builtin:00640x0360p0030_16-09 --json '{"video_options":{"preset":"fast"}}' --wait

Vientiasetusten vahvistaminen

Tarkista asetukset ennen renderöinnin aloittamista:

openshot-cli export validate /tmp/reel.mp4 --preset builtin:format_mp4_x264

Ominaisuuksien raportti kokoaa koodekkien saatavuuden, ei fyysisen GPU:n saatavuutta. Vahvistus menee pidemmälle: se avaa kooderit (mukaan lukien laitteistokooderit) ja säiliön tarkkojen asetusten kanssa erillisessä prosessissa ilman tiedoston kirjoittamista. Säiliön kestämätön yhdistelmä epäonnistuu virheellä incompatible_export, FFmpeg:n oma selitys ja asetuksen muutos (details.cause.path):

openshot-cli export validate /tmp/song.mp3 --json '{"mode":"audio","format":"mp3","audio_codec":"aac"}'

Vientityöntekijä suorittaa saman tarkistuksen ennen renderöintiä.

Kehysalueen renderöinti

Käytä --start-frame ja --end-frame renderöidäksesi osan aikajanasta. Alueet ovat mukaan lukien ja yhden pohjaisia vientiprofiilin FPS:n mukaan. Esimerkiksi renderöi ensimmäiset 90 kehystä 30 fps:llä (kolme sekuntia):

openshot-cli export start /tmp/excerpt.mp4 --profile builtin:01280x0720p0030_16-09 --start-frame 1 --end-frame 90 --wait

Vain äänen vienti ja kuvajonot

Valitse tulostustila edistyneen JSON:n avulla:

openshot-cli export start /tmp/music.wav --json '{"mode":"audio","format":"wav","audio_codec":"pcm_s16le"}' --wait
openshot-cli export start /tmp/frames --json '{"mode":"image_sequence","format":"png"}' --end-frame 3 --wait

Kuvajonot vaativat uuden tulostuskansion. Olemassa olevia tulosteita ei koskaan korvata.

Muokkaus

Leikkeiden ja efektien lisääminen

Käytä import/add/list-komentojen palauttamia tunnuksia ja selvitä kerrosten numerot komennolla project get:

openshot-cli file import /absolute/path/video.mp4
openshot-cli clip add FILE_ID --layer 2000000 --position 3 --start 10 --end 17 --volume 0
openshot-cli clip set CLIP_ID --json '{"volume":0.5}'
openshot-cli clip keyframe set CLIP_ID --property volume --frame 301 --value 0
openshot-cli clip keyframe set CLIP_ID --property volume --frame 331 --value 1
openshot-cli effects add CLIP_ID saturation
openshot-cli effects set EFFECT_ID --json '{"saturation":1.2}'
openshot-cli project save /absolute/path/edit.osp

Valitse projektiprofiili mahdollisimman aikaisin; täytetyt projektit tukevat myös profiilin vaihtoa olemassa olevan FPS-muunnoksen ja kumoamisjärjestelmän kautta. --audio-only leikkeen luomisessa poistaa videon, mukaan lukien musiikkitiedostojen upotetun kansikuvan. Käyttääksesi kyseistä leikkeen äänen visualisointiin, ota sen video ja ääni käyttöön ja seuraa efektin ohjeita läpinäkyville päällekkäisille kerroksille ja sijoittelulle.

Leikkeen ajoituksen ymmärtäminen

Esimerkin avainkehykset olettavat 30 fps projektin ja leikkeen, joka on rajattu lähteestä 10 sekunnista. Sijainti on aikajanan sekunneissa; alku/loppu ovat lähteen sekunteja, loppu ei sisälly. Kehykset alkavat numerosta 1. Tiedoston pikkukuvan kehykset käyttävät lähteen FPS:ää. Aikajanan kehykset käyttävät projektin FPS:ää. Leikkeen avainkehykset käyttävät lähdekoordinaatteja projektin FPS:llä, joten leikkeen rajaaminen ei siirrä sen ensimmäistä näkyvää avainkehystä kehykseen 1.

Ominaisuuksien muuttaminen

set yhdistää ylimmän tason ominaisuudet. Skalaarit muuttavat avainkehystetyt ominaisuudet vakioiksi. Toimitettu sisäkkäinen käyrä korvaa kyseisen käyrän; käytä keyframe set muuttaaksesi vain yhtä pistettä. JSON-argumentit hyväksyvät rivin JSON:n, @file.json tai - stdin:stä. Ominaisuuksien nimet, tyypit, enumit, avainkehykset, viitteet ja ajoitus validoidaan ennen projektin muokkausta. Virheet tunnistavat kentän, odotetun arvon, vastaanotetun arvon ja korjauksen, jos mahdollista. Käyttöliittymän liukusäätimien alueet ovat ohjeellisia, jos moottori tukee arvoja niiden ulkopuolella.

Häivytysten lisääminen

clip fade ID --in 0.5 --out 0.5 laskee lähteen rajauksen avainkehyskoordinaatit automaattisesti. Se korvaa alfakäyrän; --property volume --value 0.25 luo sen sijaan äänihäivytyksen, jonka huippuvahvistus on 0,25. Kestojen on mahtuttava ensimmäisen ja viimeisen näkyvän kehyksen väliin; häivytys loppuu nollaan viimeisessä kehyksessä.

Leikkeiden jakaminen

clip split ID --at 6.5 käyttää aikajanan sekunteja, napsauttaa lähimpään projektikehykseen ja säilyttää molemmat puolet. Se säilyttää lähdekoordinaattikäyrät ja kopioi efektit uusilla tunnuksilla oikealle puolelle, noudattaen editorin leikkauskäyttäytymistä. Vasemman puolen tunnus säilyy. Vastaus raportoi pyydetyt/toteutuneet jakamisajat ja molemmat yhteenvedot; nimetty erätulos tukee {"$ref":"cut.right.id"}. Jakamiset hylkäävät päätepisteet ja lukitut raidat. Kumoa palauttaa alkuperäisen leikkeen yhtenä tapahtumana.

Leikkeen valikon esiasetukset

Editorissa leikkeiden valikon esiasetukset käyttävät samaa koodia kuin komentorivillä. Jokainen komento listaa esiasetuksensa ohjeissaan, ja kukin on yksi kumoa-toiminto:

openshot-cli clip motion CLIP_ID --preset slide-in-left
openshot-cli clip motion CLIP_ID --preset pulse --at 4.5
openshot-cli clip look CLIP_ID --effect ColorGrade --preset warm_up
openshot-cli clip look CLIP_ID --effect all --preset none
openshot-cli clip speed CLIP_ID --mode forward --factor 2
openshot-cli clip speed CLIP_ID --mode freeze --at 3 --duration 2
openshot-cli clip repeat CLIP_ID --passes 3 --pattern pingpong
openshot-cli clip waveform CLIP_ID

Liike-esiasetukset ovat suhteessa leikkeen nykyiseen muunnokseen. Look-esiasetukset lisäävät tai korvaavat yhden efektin, ja none poistaa sen. Nopeus ja toisto muuttavat jokaisen avainkehyksen ajoitusta ja leikkeen pituutta; clip speed --mode reset palauttaa normaalin nopeuden. Muut valikon toiminnot ovat tavallisia muokkauksia: kierrä ja asettelu clip set -komennolla, rajaus effects add Crop -komennolla. Komennot toimivat myös komennoissa edit apply ja edit bulk.

Tekstin lisääminen ja tyylittäminen

text add luo tekstin ja sijoittaa sen leikkeeksi, käyttäen samaa tekstiä kuin editorin Teksti-työkalu. Jättämällä pois vaihtoehtoja käytetään editorin oletustyyliä:

openshot-cli text add --text "Opening Night" --layer 5000000 --position 2 --duration 4 \
    --place lower-third --font "Noto Sans" --size 72 --bold --color "#ffffff" \
    --background "#80000000" --background-padding 16 --background-corner 12
openshot-cli text get CLIP_ID
openshot-cli text set CLIP_ID --stroke black --stroke-width 3
openshot-cli text set CLIP_ID --text $'Two\nlines' --line-spacing 1.4
openshot-cli text fonts --search noto
openshot-cli text list --search opening

Sanat, fontti, koko, tasaus, laatikon leveys ja oletusvärit kuuluvat projektiin tallennettuun tekstiin ja ovat jaettuja kaikille sitä käyttävillä leikkeille, kuten editorissakin. text set yhdellä leikkeellä muuttaa kaikkia ja listaa ne changed_clip_ids; --this-clip-only antaa leikkeelle ensin oman kopion. clip add FILE_ID lisää toisen tekstileikkeen text list -komennosta. Koot ovat pikseleinä projektin resoluutiossa, ja värit ovat #RRGGBB, #AARRGGBB (läpinäkyvyys mukana), CSS-nimi tai transparent. --place asettaa laatikon keskelle, reunalle, kulmaan tai alalohkoon. --line-spacing on monikerta normaalista rivivälistä (1 on normaali), ja --background-corner pyöristää taustan ja reunuksen kulmat niin monella pikselillä.

Tekstileike on tavallinen leike. Sijainti, skaalaus, kierto, läpinäkyvyys, ajoitus, häivytykset, liike-esiasetukset ja efektit käyttävät kaikkia normaaleja clip-komentoja. Fonttikoko, täyte, laatikon leveys sekä kirjainten ja rivien väli määrittävät tekstilaatikon koon, joten niitä ei voi avainkehystää; tekstin koon animaatioon avainkehystä leikkeen skaalausta. Jokainen leike voi animoida omia tekstivärejään sekä ääriviivojen ja reunusten leveyksiä samoilla avainkehyskomennoilla kuin muita ominaisuuksia:

openshot-cli clip keyframe list CLIP_ID
openshot-cli clip keyframe set CLIP_ID --property text_color.alpha --space clip --unit seconds --at 0 --value 0
openshot-cli clip keyframe set CLIP_ID --property text_color.alpha --space clip --unit seconds --at 1 --value 255

Animoidut ominaisuudet ovat text_color, text_background, text_stroke ja text_border (värit, joissa .red, .green, .blue ja .alpha arvot 0–255), sekä text_stroke_width, text_border_width ja text_background_corner. Leikkeen oma animaatio voittaa jaetun tyylin, ja text get listaa, mitä tyylejä leike animoituu. text reset CLIP_ID palauttaa leikkeen oletustyyliin, kuten Teksti → Palauta tyyli; --keyframes-only poistaa vain leikkeen oman animaation. Useiden tekstien tyylittämiseen valitse ne {"text":true} avulla:

openshot-cli edit bulk --select '{"text":true}' --json '[{"method":"text.set","params":{"font_family":"Noto Sans","stroke_width":2}}]'

Muokkauserän soveltaminen

edit apply --json @edits.json --expect-revision 12 hyväksyy enintään 256 järjestettyä muokkauskäskyä, käyttäen pisteellä erotettuja komentojen nimiä kuten clip.set ja effects.add (vanhempi effect.add-kirjoitusasu toimii myös):

[
  {"method":"project.profile.set","params":{"id":"builtin:01280x0720p0024_16-09"}},
  {"method":"file.import","as":"media","params":{"path":"/tmp/video.mp4"}},
  {"method":"clip.add","as":"shot","params":{"file_id":{"$ref":"media.id"},"layer":1000000,"start":10,"end":15}},
  {"method":"clip.fade","params":{"id":{"$ref":"shot.id"},"fade_in":0.5,"fade_out":0.5}}
]

Valinnainen as sitoo tuloksen myöhempiä komentoja varten samassa erässä. {"$ref":"shot.id"} -objekti korvaa kyseisen tuloksen kentän. Viittaukset ratkaisevat vain aiemmat nimet; kirjoitusvirheet, etuviittaukset ja kaksoisnimet epäonnistuvat ennen live-päivityksiä. Vastaus sisältää järjestetyt tiiviit tulokset ja refs-kartoituksen todellisista tunnisteista. Kaikki onnistuneen erän muutokset muodostavat yhden kumoa/toista-toiminnon. project.profile.set tukee myös täytettyjä aikajanoja. Avaus-, tallennus-, vienti- ja tarkastelukomennot pysyvät muokkauserien ulkopuolella. Jokaisen komennon ohje listaa JSON-parametrien nimet, mukaan lukien alaviivalla kirjoitetut komentoriviliput (esim. --fps-num muuttuu fps_num).

Erien validointi ja virheiden käsittely

Kaikki muokkauserien komennot tarkistetaan irrotettua projektia vastaan ennen live-päivityksiä. Virheellinen syöte jättää live-projektin ja revision muuttumattomaksi. Kelvolliset erät muodostavat yhden kumoa-ryhmän. Odottamattomat suorituksen virheet voivat silti aiheuttaa osittaisia muutoksia; virheet raportoivat suoritetut toiminnot. Aikakatkaisu ei tarkoita peruutusta, joten tarkista tila ennen muokkausten uudelleenyritystä.

Tarkka avainkehysten muokkaus

clip, transition ja effects tukevat komentoja keyframe list, set, remove, clear, transform, copy ja paste. Ominaisuuksien polut voivat osoittaa sisäkkäisiin käyriin, kuten color.red Chroma Key -efektissä. Sisäkkäisen käyrän muokkaus säilyttää sisar-kanavat. Suorita keyframe list ID ilman ominaisuutta löytääksesi käyrien polut ja pisteiden määrät. Löytö ja pisteiden listaus sisältävät trimmaus/sijaintiajan kontekstin; pisteiden listaus raportoi myös alkuperäiset kehyskoordinaatit. get ja properties paljastavat koko alkuperäisen objektin ja ominaisuustiedot. Virheet tunnistavat virheelliset kentät, ehdottavat lähellä olevia ominaisuuksien nimiä ja selittävät koordinaattikorjaukset.

Valitse koordinaatit selkeästi käyttämällä --space native|clip|timeline ja --unit frames|seconds. Kaikki kehykset käyttävät projektin FPS:ää ja ovat 1-pohjaisia; sekunnit alkavat nollasta ja napsahtavat lähimpään kehykseen. Native on olemassa oleva moottorin avainkehyskoordinaatti (sisältäen lähdeleikkauksen). Leikkeen koordinaatit alkavat näkyvän leikkeen alusta; aikajanan koordinaatit alkavat projektin ajan nollasta. Liitetyt efektit käyttävät emoleikkeensä ajoitusta. Nämä koordinaatit osoittavat animaation aikaa, eivät media-kehyksiä, joita aika-muunnoskäyrä valitsee.

Leikkeelle, joka on sijoitettu 5 sekuntiin ja rajattu 2 sekuntiin 30 fps projektissa, leikkeen kehys 1, aikajanan kehys 151 ja natiivikehys 61 osoittavat samaan pisteeseen. Sijainti ja rajaus napsahtavat itsenäisesti projektin kehysruudukkoon. Koko käyrän listaaminen voi sisältää piilotettuja pisteitä, joiden leike-/aikajana-koordinaatit eivät ole positiivisia. Perinteinen --frame tarkoittaa edelleen natiivikehystä eikä sitä voi yhdistää --at kanssa.

Esimerkkejä:

openshot-cli clip keyframe set CLIP --property location_x --space clip --unit seconds --at 0 --value -1
openshot-cli clip keyframe set CLIP --property location_x --space clip --unit seconds --at 1 --value 0 --interpolation bezier --handles '{"handle_left":{"X":0.2,"Y":0.9}}'
openshot-cli effects keyframe set EFFECT --property color.red --space clip --at 31 --value 200
openshot-cli clip keyframe list CLIP --property location_x --space clip --unit seconds
openshot-cli clip keyframe transform CLIP --property location_x --space clip --start 1 --end 31 --scale 2 --offset 15
openshot-cli clip keyframe copy TARGET --property location_x --source-id SOURCE --space clip --start 1 --end 31 --at 1 --mode merge
openshot-cli clip keyframe remove CLIP --property location_x --space clip --at 31
openshot-cli clip keyframe clear CLIP --property location_x --value 0

Interpolointi, pehmennys ja esikatselu

Interpolointi kuvaa segmenttiä kohdepisteeseen. Lineaarinen antaa tasaisen nopeuden pisteiden välillä. Vakio pitää edellisen arvon kohteeseen asti ja hyppää sitten. Natiivin oletus Bezier-kahvat pehmentävät molemmissa päissä kutakin segmenttiä. Väliin lisätty piste voi siksi aiheuttaa tahattoman hidastuksen; yhden pehmennetyn liikkeen tekemiseen aloita kahdella päätepisteellä. Tavallisesti jätä kahvat koskematta ja valitse nimetty esiasetus tiettyä tyyliä varten.

Tutustu samoihin pehmennysesiasetuksiin, joita editorin valikot käyttävät, ilman istuntoa:

openshot-cli clip keyframe presets

Käytä esiasetusta saapuvaan segmenttiin asettamalla sen kohde:

openshot-cli clip keyframe set CLIP --property scale_x --space clip --unit seconds --at 0 --value 1
openshot-cli clip keyframe set CLIP --property scale_x --space clip --unit seconds --at 4 --value 1.2 --easing ease-in-out

Pehmennysvaihtoehto tarkoittaa Bezieriä. Se asettaa edellisen pisteen lähtevän kahvan ja kohdepisteen tulevan kahvan yhdessä, säilyttäen muut kahvat ja pistearvot. Aiemman pisteen on oltava olemassa. Älä yhdistä sitä mukautettuihin kahvoihin tai eri interpolointiin. Esiasetukset toimivat erissä ja massamalleissa. Käyttöliittymän esiasetus ease (”Ease (Default)”) eroaa natiivikahvoista, joita tavallinen Bezier-interpolointi käyttää. Takaisin-esiasetukset voivat ylittää päätepisteiden arvot.

Tarkastele liikettä ennen renderöintiä käyttäen natiivikäyrän arvioijaa:

openshot-cli clip keyframe preview CLIP --property scale_x --space clip --unit seconds --start 0 --end 4
openshot-cli clip keyframe preview CLIP --property scale_x --space clip --unit seconds --at 2

Esikatselu on vain luku -tila ja toimii identtisesti efekteille ja siirtymille. Se palauttaa arvot ja allekirjoitetut tulonopeuden / lähtönopeuden ominaisuuden yksiköissä sekunnissa, laskettuna välittömästi vierekkäisistä kehyksistä. Nämä ovat äärellisiä eroja, eivät analyyttisiä derivaattoja. Natiivikehyksessä 1 tulonopeus on nolla. Vierekkäisten kehysten nopeudet voivat tarkastella pyydetyn alueen ulkopuolella. Lähellä nollaa olevat nopeudet sisäisen pisteen ympärillä paljastavat tauon; erilaiset nopeudet paljastavat nopeuden muutoksen. Vakiointerpolointi paljastaa hypyn kohteessa.

Ilman aluetta esikatselu kattaa käyrän ensimmäisen ja viimeisen pisteen. Alueet ovat mukaan lukien, oletuksena 17 tasaisesti jakautunutta näytettä (–count: 2–256). Avainkehykset ja niiden välittömät naapurit alueen sisällä sisältyvät myös, joten harva näytemäärä ei piilota avainkehysjumiutta. Maksimi on 1024 näytettä; suuremmat pyynnöt vaativat kapeamman alueen. –at näyttelee yhden kehyksen. Esikatselu raportoi pyydetyn tilan koordinaatit ja todelliset natiivikehykset; sekunnit napsahtavat projektikehyksiin kuten editoinnissa.

Edistyneissä mukautetuissa kahvoissa sekä X että Y normalisoidaan segmenttiin: X on osa sen kehyksen laajuudesta; Y on osa sen arvon muutoksesta. Ensimmäinen ohjaus tulee edellisen pisteen handle_rightista, toinen kohdepisteen handle_leftista. Natiivioletukset ovat oikea=(0.5, 0), vasen=(0.5, 1), tasaisilla päätepisteen tangentteilla. Pelkkä handle_type:n muuttaminen ei laske uudelleen jatkuvaa tangenttia ympäröivien pisteiden läpi. Olemassa olevat kahvat säilyvät pisteen siirron yhteydessä.

Avainkehysalueet ovat sisällyttäviä, toisin kuin leikkeen valinta-aika-alueet. Lista tuottaa points joiden co.X arvot käyttävät pyydettyä koordinaattitilaa/yksikköä. Lähetä tämä taulukko komennolle keyframe paste --json @points.json samalla tilalla/yksiköllä, valiten --mode merge (korvaa vastaavat kehykset, säilytä muut) tai --mode replace (korvaa koko käyrä). copy hyväksyy lähteen samantyyppisestä objektista, valinnaisen --source-property ja kiinnittää ensimmäisen valitun lähdepisteen kohteeseen --at. Muut käyrät ja lähdeobjektit pysyvät muuttumattomina.

transform soveltaa positiivista aikaskaalautumista ensimmäisen valitun pisteen tai --pivot ympärille, jota seuraa allekirjoitettu --offset valitussa yksikössä. Kehyksen napsautus, joka luo kaksoiskoordinaatteja, hylätään, mukaan lukien törmäykset pisteisiin valitun alueen ulkopuolella. Natiivikoordinaattien on pysyttävä vähintään 1:ssä. Natiivinormalisoidut Bézier-kahvat ja interpolointi kulkevat jokaisen pisteen mukana; kahvat eivät ole absoluuttisia kehyskoordinaatteja. set --handles muuttaa vain annettuja kahvoja. Interpolointi kuuluu kohdepisteelle.

clear säilyttää vakaan peruspisteen natiivikehyksessä 1: määritä --value tai ota näyte olemassa olevasta käyrästä --at (oletuksena natiivikehys 1). Viimeisen pisteen poistaminen säilyttää myös vakaan peruspisteen, joten myöhemmät avainkehysten lisäykset pysyvät voimassa.

Monien leikkeiden valinta ja muokkaus

Käytä edit apply --dry-run validoidaksesi erän muuttamatta projektia. Käytä edit bulk toistaaksesi pienen komentopohjan jokaiselle valitulle leikkeelle, kaikki muutokset ryhmiteltynä yhdeksi kumoamistoimeksi.

Esikatsele ensin valinta:

openshot-cli edit select --json '{"layer":1000000,"start":5,"end":20,"effect":"Saturation"}'

Valitsimet tukevat ids (ainutlaatuinen leikkeen tunnisteiden taulukko), layer, start/end (aikajanalla sekunteina), file_id, effect (luokan nimi tai alias) ja text (true valitsee tekstileikkeet). Suodattimet yhdistyvät JA-operaatiolla. Aikavälit valitsevat leikkeet, jotka leikkaavat aikaväliä [start, end); ne eivät rajaa näitä leikkeitä. Tulokset järjestetään sijainnin, kerroksen ja sitten tunnisteen mukaan, ja ne sisältävät tunnisteet, yhteenvedot, lukitustilan ja nykyisen revision. Tuntemattomat tunnisteet ovat virheitä. Tyhjä valitsin hylätään; käytä {"all":true} nimenomaisesti jokaiselle leikkeelle. Valinnat rajoitetaan 256 leikkeeseen, eikä niitä koskaan katkaista hiljaisesti.

Esimerkiksi tallenna tämä taulukko tiedostoksi templates.json:

[
  {"method":"clip.adjust","params":{"values":{"position":{"add":2},"volume":{"multiply":0.5}}}},
  {"method":"effects.add","as":"look","params":{"type":"Saturation"}},
  {"method":"effects.keyframe.set","params":{"id":{"$ref":"look.id"},"property":"saturation","space":"clip","at":1,"value":0}},
  {"method":"effects.keyframe.set","params":{"id":{"$ref":"look.id"},"property":"saturation","space":"clip","at":31,"value":1.2}}
]

Vahvista se, ja käytä sitten valinnan palauttamaa revisiota vastaan:

openshot-cli edit bulk --select '{"ids":["CLIP_A","CLIP_B"]}' --json @templates.json --dry-run
openshot-cli edit bulk --select '{"ids":["CLIP_A","CLIP_B"]}' --json @templates.json --expect-revision 42

Olemassa olevat leikkeiden komennot perivät id; effects.add perii clip_id. Jätä nämä kohdeparametrit pois malleista. Efektimuokkaukset on viitattava aiemmin nimettyyn tulokseen. Nimet ovat paikallisia jokaiselle valitulle leikkeelle, joten look.id viittaa eri efektiin jokaisessa leikkeessä. Muuttaaksesi olemassa olevia efektiesimerkkejä eksplisiittisellä tunnisteella, jatka käyttämällä edit apply. Valittu tunnistesarja on kiinteä ennen laajennusta; sijainnin tai efektien muutokset eivät muuta jäljellä olevia kohteita.

clip set asettaa absoluuttiset ominaisuudet; clip adjust soveltaa ensin multiply ja sitten add numeeriseen ominaisuuteen tai jokaiseen käyrän arvoon säilyttäen pisteiden ajoituksen, interpolaation ja normalisoidut kahvat. Se validoi tuloksena olevat arvot, mukaan lukien ei-negatiiviset sijainnit ja äänenvoimakkuuden. Rakenteelliset kentät pysyvät suojattuina.

Massatoiminnot hylkäävät tyhjät valinnat, lukitut kohderaidat ja yli 256 laajennetun komennon määrän. Jokainen laajennettu toiminto käy läpi irrotetun esivalidoinnin ennen live-muokkausta. Kuivakäynnit eivät varaa generoituja tunnisteita. Käytä --expect-revision hylätäksesi vanhentuneet valinnat. Onnistuneet erät ovat yksi kumoamistoiminto, myös tallennuksen/jälleenavaamisen jälkeen. Käyttöliittymän päivitykset ryhmitellään. Odottamattomat ajo-/kuuntelijavirheet voivat silti jättää osittaisen transaktion; virheilmoitus raportoi suoritetut toiminnot ja kumoaminen palauttaa kyseisen ryhmän, kuten edit apply.

Profiilit

Löydä profiilit ja yhdistä tuotu video ilman tunnisteiden arvailua:

openshot-cli profile list --search 720
openshot-cli profile get builtin:01280x0720p0024_16-09
openshot-cli profile match --file FILE_ID
openshot-cli project profile get
openshot-cli project profile set --from-file FILE_ID
openshot-cli project profile set builtin:01280x0720p0024_16-09
openshot-cli project profile set --json '{"width":640,"height":352,"display_ratio":{"num":20,"den":11},"fps":{"num":24000,"den":1001}}'

Luettelon merkinnät sisältävät vakaita tunnisteita, kuvauksia, mittoja, rationaalisen FPS:n, kuvasuhteet ja skannausasetukset. Lista/haku on sivutettu. Lähteen yhdistäminen palauttaa tarkat tunnisteet ja järjestetyt vaihtoehdot eksplisiittisillä eroilla. Asetus tiedostosta vaatii tarkan osuman, ellei --create-custom ole määritetty; se ei koskaan hiljaisesti valitse lähialueen profiilia. Staattiset kuvat ja pelkät äänilähteet eivät voi määrittää videoprofiilia. Yhdistäminen käyttää ilmoitettua lähteen FPS:ää.

Mukautetut asetukset ovat upotettu tallennettuun projektiin, mukaan lukien rationaaliset nopeudet, joten uudelleenavaus ei vaadi erillisen profiilitiedoston asentamista. Projektin profiilin muutokset käyttävät olemassa olevaa kuvanopeuden muunnosta ja yhtä kumoamistransaktiota. Kumoa/toista palauttaa leikkeen ajoituksen ja avainkehykset, mukaan lukien pyöristysherkät sijainnit. Vienti voi valita profiilin itsenäisesti muuttamatta projektia.

Tallennettu kumohistoria noudattaa editorin historia-rajoitusasetusta. Rajoitus on pehmeä toimintabudjetti: kaikki säilytettävien transaktioiden tiedot pidetään, joten tallennus ei voi katkaista suurta erää osittaiseksi kumoamistoiminnoksi. Nolla poistaa tallennetun historian käytöstä. Erillinen 256-komennon eräpyyntöraja on edelleen voimassa.

Median ja aikajanojen tarkastelu

Tarkastele leikkeen ajoitusta ja raidanjärjestystä tekstinä tai JSON-muodossa, tai renderöi kuvia tarkistaaksesi sommittelun ja rajauksen ennen vientiä.

Aikajanan yhteenvedot

Käytä tekstinäkymää nopeaan yleiskatsaukseen tai jäsenneltyä JSONia skripteihin ja agenteille:

openshot-cli timeline view --start 5 --end 12
openshot-cli timeline view --start 5 --end 12 --format json
openshot-cli timeline overview --start 5 --end 12

timeline view oletuksena tiivis teksti käytetyillä raidoilla, objektien tunnisteilla, aikajana/lähdeväleillä, virran tilalla, vahvistuksella sekä aukkojen/ylitysten tiedoilla. Käytä --detail summary|clips|full valitaksesi yksityiskohdan, --format json jäsenneltyyn kontekstiin, ja --start/--end, --layer sekä sivutusta tuloksen kohdistamiseen.

timeline overview tarjoaa tiiviin jäsennellyn kontekstin ilman kuvatietoja: järjestetyt tunnisteet, raidan sekvenssi, aikajana/lähdevälit, näkyvät rajausalueet, kehyksen koordinaatit, ääni/video-tila, efektit sekä viereiset aukot tai ylitykset. Välit ja kehyssarjat ovat loppueksklusiivisia; kehyksen numerot ovat yhden pohjaisia. Lähdekehykset käyttävät lähteen FPS:ää; aikajana- ja avainkehyskoordinaatit käyttävät projektin FPS:ää. Käytä --layer ja --start/--end kohdistamiseen, sekä --limit/--offset sivutukseen (oletus 100, enintään 500 kohdetta). Aikamuunnellut leikkeet pidättävät eksplisiittisesti päätellyt lähdemääritykset. Käytä palautettua revisiota komennolla edit apply --expect-revision.

Kehyksen esikatselut ja kontaktikuvat

Renderöi yksittäinen kehys komennolla thumbnail tai ota näyte alueelta komennolla strip. Käytä file lähdemedian tarkasteluun ja timeline koostetun videon tarkasteluun, mukaan lukien efektit ja kerrostetut leikkeet:

openshot-cli file thumbnail FILE_ID --frame 301 --output /tmp/source.png
openshot-cli file strip FILE_ID --start 10 --end 20 --count 12 --output /tmp/source-strip.png
openshot-cli timeline thumbnail --frame 91 --output /tmp/timeline-frame.png
openshot-cli timeline strip --start 0 --end 20 --count 12 --output /tmp/timeline-strip.png

Kehyskuvat oletuksena 320x180 pikseliä; kontaktikuvat oletuksena 160x90 per ruutu, plus aikakoodin tunnisteet. Käytä --width ja --height valitaksesi ulostulon pikselit. Vastaukset sisältävät tarkat näyte/kehysmetatiedot. Kontaktikuvat auttavat tarkastelemaan sommittelua sarjan yli; käytä avainkehysten esikatseluja ja renderöityä videota arvioidaksesi liikettä näiden näytteiden välillä.

Aikajanan kuvat

Kaappaa editorin raidat, mukaan lukien viivain, pikkukuvat, efektit, siirtymät ja aaltomuodot:

openshot-cli timeline view --start 0 --end 20 --pixels-per-second 80 --output /tmp/tracks.png

Määrittämällä --output valitaan kuvatiedoston muoto; --format image valitsee sen myös nimenomaisesti. Kaappaus ei muuta editorin näkymää tai projektia. Vastaukset sisältävät leikkeiden tunnisteet ja ajoituksen pikselirajojen lisäksi.

Kuvat ovat oletuksena 1280 pikseliä leveitä, ja korkeus sovitetaan käytettyihin ratoihin. Käytä --width, --height tai --all-tracks säätääksesi asettelua, ja --track-size tai --track-label-width säätääksesi ratoja ja niiden nimiä. Alku- ja loppuväli määrää zoomauksen; --pixels-per-second määrittää leveyden aikavälin perusteella.

Äänen aaltomuodon näkymät

Valitse --mode waveforms tarkastellaksesi äänen käyriä aikajanalla:

openshot-cli timeline view --start 5 --end 12 --mode waveforms --output /tmp/waves.png

--mode auto käyttää olemassa olevaa välimuistissa olevaa aaltomuodon näyttöä; --mode thumbnails näyttää sen sijaan pikkukuvat. Aaltomuodot kuvaavat lähteen huippu- ja RMS-tasoja leikkeen äänenvoimakkuuden ja ajoituksen säädöillä ennen ääni-efektejä tai miksauksia.

Välimuistittoman aaltomuodon purku dekoodaa koko lähteen, rajoitettuna 600 sekuntiin per lähde ja 1200 lähdesekuntiin per pyyntö. Näkyvän alueen kaventaminen ei vähennä tätä purkutyötä. Pidemmille lähteille luo aaltomuodot ensin editorissa tai käytä pikkukuvatilaa. Seuraavat pyynnöt voivat käyttää välimuistissa olevia aaltomuotoja uudelleen.

Kuvien vienti ja rajoitukset

Kuvapolkujen on oltava uusia PNG-tiedostoja olemassa olevissa hakemistoissa. Kuvien koko on rajoitettu 4096 pikseliin per akseli, yhteensä 8 388 608 pikseliin ja 64 kontaktikuvamalliin. Näiden rajojen ylittävät pyynnöt epäonnistuvat ennen renderöintiä.

Kuvat tallennetaan tiedostoihin; JSON-vastaukset sisältävät niiden polut ja image_bytes-koot. Tarkastus odottaa kuvan valmistumista, ja suuret pyynnöt voivat hetkellisesti kuormittaa editoria.

Komentojen aikakatkaisujen käsittely

Pyynnön aikakatkaisu ei tarkoita, että muutos epäonnistui. Käytä virheilmoituksessa olevaa toiminnon tunnusta komennolla operation get ID ennen uudelleenyritystä. Komento operation list näyttää viimeisimmät muutokset niiden tilat, revisiot ja tulokset. Valmiit toiminnot säilyttävät tuloksensa, jos ne ovat tarpeeksi pieniä, mukaan lukien palautetut objektitunnukset. Tallennustila on rajattu 100 toimintaan ja 4 MiB:iin, ja yksittäiset tulokset jätetään pois yli 256 KiB:n kohdalla. Nämä tiedot säilyvät vain käynnissä olevan istunnon ajan. Ne eivät palauta projekteja kaatumisen jälkeen eivätkä estä saman muokkauksen toistamista. Vientitehtävillä on omat tila- ja listauskomennot.