Komentorivin työkalu oggResize voi muuttaa ogg-tiedoston (ogg, oga tai ogv) leveyttä ja korkeutta eri tavoilla. Kuitenkin se käsittelee vain Ogg Theora ja Vorbis -striimejä. oggResizen etu muihin työkaluihin verrattuna on, että se muokkaa vain striimit, joita täytyy muuttaa. Striimit, jotka eivät tarvitse muunnosta, jäävät vaille vaikutuksia.
oggResize voi muuttaa videoruudun kokoa, videon tai audion datataajuutta tai videon kuvataajuutta tai äänen näytetaajuutta.
Se voi myös lisätä kommentteja mihin tahansa striimiin ja voi sisältää PNG-kuvia,joissa on alfa-kanava, joten ne renderöidään videoon milloin tahansa ennen tai jälkeen koon muuttamisen.
Komento:
oggResize [optiot] inputfile.ogv outputfile.ogv
Mahdolliset optiot ovat:
-s ⁞ asettaa videoruudun koon. Koko annetaan muodossa <levets>x<korkeus>. Oletuskoko on 480x320.
Oletuksena videoruudun suhteet pidetään samoina, joten jos uuden videoruudun koko ei sovi suhteisiin, oggResize lisää mustat rajay ylös, alas, oikealle ja vasemmalle, jotta se sopii uusiin kokosuhteisiin.
jos tahdot venyttäää videoruudut uuteen kokoon, käytä -t -optiota.
Esimerkki: -s 320x240
-d asettaa bittinopeuden bitteinä sekunneissa videokoodaajaa (theora) varten. Tämän on tarkoitus olla ylempi sietokynnys. Tiedosto voi siis olla oletettua pienempi. Jos sitä ei ole asetettu, alkuperäisen striimin bittinopeutta käytetään.
Esimerkki: -d 1024000
-D asettaa bittinopeuden bitteinä sekunnissa audiokoodaajaa (vorbis) varten. Jos sitä ei ole asetettu, alkuperäisen striimin bittinopeutta käytetään.
Esimerkki: -D 64000
-f asettaa videon ruutunopeuden numeraattorilla ja denominaattorilla, ja on ruutuja sekunnissa. Jos vain yhtä numeroa käytetään, denominaattori on 1. Jos tätä ei aseteta, alkuperäisen videon ruutunopeutta käytetään.
Esimerkki: -f 25:2
-F asettaa audiodatan näytetaajuuden Hertzeinä. Jos näytetaajuus ei sovi alkuperäiseen tiedostoon, uudelleensämpläystä käytetään.
Esimerkki: -F 32000
-t jos tämä optio on asetettu, kuvaa venytetään ulostulokokoon. Tässä tapauksessa ulos tulevan videon kuvasuhde ei välttämättä vastaa alkuperäisen videon ruudun kuvasuhdetta. Tämä optio auttaa poistamaan mustat reunat, jotka ilmestyvät, jos alkuperäisen videon ja uuden videon kuvasuhteet eivät sovi yhteen.
Esimerkki: -t
-c lisää kommentteja videon (theora) striimiin. Kommentit ovat muodossa 'tyyppi=arvo'. Useampi kuin yksi kommentti voidaan liittää yhteen puolipisteellä. Suositellaan, että heittomerkkejä (') käytetään, sillä komentorivi voi käyttää puolipistettä jakomerkkinä.
Esimerkki: -c 'AUTHOR=yorn;DATE=03.07.09'
-C lisää kommentteja audion (vorbis) striimiin. Kommentit ovat muodossa 'tyyppi=arvo'. Useampi kuin yksi kommentti voidaan yhdistää puolipisteellä. On suositeltavaa, että heittomerkkejä (') käytetään, sillä komentorivi voi pitää puolipistettä välimerkkinä.
Esimerkki: -C 'AUTHOR=yorn;DATE=03.07.09'
-q asettaa laadun. Arvot voivat olla väliltä 1 (paras laatu, hieman epätarkkuutta) ja 6 (huonoin laatu). Oletusarvo on 2.
Esimerkki: -q1
-p luo esikatselufilmin. Tälle optiolle annettu numero valitsee väliajan valittujen ruutujen välillä, esimerkiksi -p24 merkitsee, että joka 24:s ruutu on valittu, näytetty. Uudelleen luotu video toistuu siis 24 kertaa nopeammin. Tämä optio voidaan yhdistää -f -optioon, joka kontrolloi ruutunopeutta. Molemmilla optiolla voidaan luoda miellyttäviä videoesikatseluita. Jos -p on käytössä, audiostriimi jätetään huomiotta.
Esimerkki: -p 24
-a lisää kuvan videoruutuun ennen sen koon muuttamista. Kuvan ei tarvitse sopia videoruutuun. Se sijoitetaan aina videoruudun vasempaan yläkulmaan.
Esimerkki: <picture1.png>[,<startTime>[,<endTime>[,s]]]
Oletusarvoinen aloitusaika on 0. Oletusarvoinen lopetusaika on -1. Oletusarvoisesti s ei aseteta. Tässä tapauksessa kuva ei häivy pimeyteen. Jos s on asetettu, kuva häipyy pimeyteen.
On mahdollista asettaa enemmän kuin yksi kuva videoruutuun. Käytä kaksoispistettä (:) yhdistääksesi ilmaukset. Jos aikajanat ovat päällekkäin, kuvat asetetaan toistensa päälle, jolloin viimeinen kuva on etualan taso.
Esimerkki: -a etwas.png,2,7,s:etwasneues.png,5,10
-A lisää kuvan videoruutuun sen koon muuttamisen jälkeen.
Syntaksi on sama kuin ilmaisussa -a -option kanssa.
Esimerkkejä
Videoruudun koon ja bittinopeuden muutos:
oggResize -s320x240 -d512000 orig.ogv new.ogv
Tämä komento muuttaa videotiedoston orig.ogv uudeksi videotiedostoksi new.ogv. Uuden videon ruutukoko on asetettu 320x240 pikseliin ja bittinopeus on asetettu 512 kByte/s. Jos alkuperäisen tiedoston parametrit sopivat uusiin parametreihin, videostriimi on vain kopioitu, ilman datan muuttamista. Jos videon ruutukoko on muuttunut, se on muutettu uuteen kokoon sopivien algoritmien avulla.
Jos tiedostossa orig.ogv oli audiostriimi, se on kopioitu uuteen tiedostoon.
Audion bittinopeuden, näytenopeuden ja kanavien määrän muuttaminen:
oggResize -D64000 -F16000 -N1 orig.ogv new.ogv
Tämä komento muuttaa vain äänistriimin tiedostosta orig.ogv näytenopeuteen, joka on 16kHz, bittinopeuteen, joka on 64 kBytes/s, ja yksikanavaiseksi. Kuten videon kanssa, äänistriimi koodataan uudelleen, jos annetut parametrit eivät sovi niihin, jotka ovat vorbis-äänistriimissä. Videostriimi kopioidaan sellaisena kuin se on.
Tämä on hyvin nopea tapa koodata ainoastaan audiostriimi uudelleen, ilman muita proseduureja, kuten ogg-tiedoston striimien jakamista ja uudelleen liittämistä.
Videoruudun koon muuttaminen, äänen bittinopeuden muuttaminen, kahden kuvan lisääminen videon päälle tietyksi ajanjaksoksi:
oggResize -s300x200 -D32000 -d1024000 -A etwas.png,2,7,s:etwasneues.png,5,10 \ orig.ogv new.ogv
Tämä komentorivi muuttaa ääni- ja videostriimin, kuten kuvattu yllä aiemmin mainituissa esimerkeissä.
Lisäksi se lisää kuvan PNG-muodossa ja alfa-kanavan etwas.png videoon kohdasta 2 sekuntia kohtaan 7 sekuntia, pehmeällä sisään- ja uloshäivytyksellä, ja kuva etwasneues.png on sijoitettu videoruudun päälle sekunnista 5 sekuntiin 10 ilman mitään feidausta.