oggenc(1) Vorbis Tools oggenc(1) NUME oggenc - codifica audio in formatul Ogg Vorbis SINOPSIS oggenc [ -hrQ ] [ -B dimensiunea eantionului brut de intrare ] [ -C numarul de canale de intrare brute ] [ -R eantionare de intrare bruta ] [ -b rata de bii nominala ] [ -m rata de bii minima ] [ -M rata de bii maxima ] [ -q calitate ] [ --resample frecvena ] [ --downmix ] [ -s serial ] [ -o fiier-ieire ] [ -n model ] [ -c comentariu-extra ] [ -a artist ] [ -t titlu ] [ -l album ] [ -G gen ] [ -L fiier versuri ] [ -Y ir-cod-limba ] fiiere-intrare ... DESCRIERE oggenc citete datele audio in format brut, Wave sau AIFF i le codifica intr-un flux Ogg Vorbis. oggenc poate citi, de asemenea, date audio din fiiere FLAC i Ogg FLAC, in funcie de opiunile din timpul compilarii. Daca este specificat fiierul de intrare ,,-", datele audio sunt citite de la stdin (intrarea standard), iar fluxul Vorbis este scris la stdout (ieirea standard), cu excepia cazului in care se utilizeaza opiunea -o pentru a redireciona ieirea. In mod implicit, fiierele de pe disc sunt furnizate la ieire in fiiere Ogg Vorbis cu acelai nume, cu extensia schimbata in ,,.ogg" sau ,,.oga". Aceasta convenie de denumire poate fi anulata prin opiunea -o (in cazul unui singur fiier) sau prin opiunea -n (in cazul mai multor fiiere). In cele din urma, in cazul in care niciuna dintre aceste opiuni nu este disponibila, numele fiierului de ieire va fi numele fiierului de intrare cu extensia (partea de dupa punctul final) inlocuita cu ogg, astfel incat fiier.wav va deveni fiier.ogg. Opional, versurile pot fi incorporate in fiierul Ogg, daca a fost compilat suportul pentru Kate. Reinei ca unele programe de redare vechi nu reuesc sa redea fluxuri cu mai mult de un singur flux Vorbis (aa-numitul profil simplu "Vorbis I"). OPIUNI -h, --help Afieaza mesajul de ajutor al comenzii. -V, --version Afieaza numarul de versiune. -r, --raw Presupune ca datele de intrare sunt date audio little-endian brute fara informaii de antet. Daca nu sunt specificate alte opiuni, valoarea implicita este de 44,1 kHz stereo pe 16 bii. Consultai urmatoarele trei opiuni pentru a vedea cum se poate modifica acest lucru. -B n, --raw-bits=n Stabilete dimensiunea in bii a eantioanelor de intrare in modul brut. Valoarea implicita este 16. -C n, --raw-chan=n Stabilete numarul de canale de intrare in modul brut. Valoarea implicita este 2. -R n, --raw-rate=n Stabilete rata de eantionare de intrare in modul brut. Valoarea implicita este 44100. --raw-endianness n Stabilete modul brut endianness la big endian (1) sau little endian (0). Valoarea implicita este little endian. --utf8 Informeaza <> ca comentariile Vorbis sunt deja codificate ca UTF-8. Util in situaiile in care shell-ul utilizeaza o alta codificare. -k, --skeleton Adauga un flux de bii schelet-Ogg. Important daca Ogg-ul de ieire este destinat sa transporte fluxuri multiplexate sau inlanuite. Fiierul de ieire utilizeaza .oga ca extensie de fiier. --ignorelength Suport pentru fiiere Wave de peste 4 GB i fluxuri de date de la intrarea standard. -Q, --quiet Modul silenios. Nu se afieaza niciun mesaj. -b n, --bitrate=n Stabilete rata de bii inta la n (in kb/s). Codificatorul va incerca sa codifice la aproximativ aceasta rata de bii. In mod implicit, aceasta ramane o codificare VBR. Consultai opiunea ,,--managed" pentru a fora o codificare cu rata de bii gestionata la rata de bii selectata. -m n, --min-bitrate=n Stabilete rata minima de bii la n (in kb/s). Activeaza modul de gestionare a ratei de bii (a se vedea opiunea ,,--managed"). -M n, --max-bitrate=n Stabilete rata maxima de bii la n (in kb/s). Activeaza modul de gestionare a ratei de bii (a se vedea opiunea ,,--managed"). --managed Stabilete modul de gestionare a ratei de bii. Aceasta dezactiveaza codificarea VBR normala, dar permite aplicarea de catre codificator a unor constrangeri de viteza de bii dure sau moi. Acest mod este mult mai lent i poate fi, de asemenea, de calitate inferioara. Este util in primul rand pentru crearea de fiiere pentru difuzare. -q n, --quality=n Stabilete calitatea codificarii la n, intre -1 (foarte scazuta) i 10 (foarte ridicata). Acesta este modul implicit de funcionare, cu un nivel de calitate implicit de 3. Sunt permise niveluri de calitate fracionare, cum ar fi 2,5. Utilizarea acestei opiuni permite codificatorului sa selecteze o rata de bii adecvata in funcie de nivelul de calitate dorit. --resample n Reeantioneaza intrarea la rata de eantionare data (in Hz) inainte de codificare. Util in principal pentru reducerea eantionarii pentru codificarea cu rata de bii mai mica. --downmix Reduce-mixeaza intrarea din stereo in mono (nu are efect asupra fluxurilor care nu sunt stereo). Util pentru codificarea cu rata de bii redusa. --advanced-encode-option optionname=valoare Stabilete o opiune avansata. Consultai seciunea Opiuni avansate pentru detalii. -s, --serial Foreaza un anumit numar de serie in fluxul de ieire. Acest lucru este util in primul rand pentru testare. --discard-comments Impiedica ca intrarile de comentarii din fiierele FLAC i Ogg FLAC sa fie copiate in fiierul Ogg Vorbis de ieire. -o fiier-ieire, --output=fiier-ieire Scrie fluxul Ogg Vorbis in fiier-ieire (valabil numai daca este specificat un singur fiier de intrare). -n model, --names=model Produce nume de fiiere sub forma acestui ir de caractere, cu %g, %a, %l, %n, %t, %d inlocuite de gen, artist, album, numar de piesa, titlu i, respectiv, data (a se vedea mai jos pentru specificarea acestora). De asemenea, %% da un % literal. -X, --name-remove=ir Elimina caracterele specificate din parametrii irului de format ,,-n". Acest lucru este util pentru a se asigura ca sunt generate nume de fiiere legale. -P, --name-replace=ir Inlocuiete caracterele eliminate prin ,,--name-remove" cu caracterele specificate. Daca acest ir este mai scurt decat lista ,,--name-remove" sau daca nu este specificat, caracterele in plus sunt doar eliminate. Valorile implicite ale acestei opiuni i ale opiunii ,,-X" de mai sus sunt specifice fiecarei platforme (i sunt alese pentru a asigura generarea unor nume de fiiere legale pentru fiecare platforma). -c comentariu, --comment comentariu Adauga irul comentariu ca un comentariu suplimentar. Acest lucru poate fi utilizat de mai multe ori, iar toate instanele vor fi adaugate la fiecare dintre fiierele de intrare specificate. Argumentul trebuie sa fie de forma ,,eticheta=valoare". -a artist, --artist artist Stabilete campul de comentariu al artistului din comentarii la artist. -G gen, --genre gen Stabilete campul de comentariu al genului din comentarii la gen. -d data, --date data Stabilete campul de comentarii privind data la valoarea data. Aceasta ar trebui sa fie data inregistrarii. -N numar, --tracknum numar Stabilete campul de comentarii pentru numarul piesei la valoarea data. -t titlu, --title titlu Stabilete campul de comentarii pentru titlul piesei la titlu. -l album, --album album Stabilete campul de comentarii pentru album la album. -L nume-fiier, --lyrics nume-fiier Incarca versurile din nume-fiier i le codifica intr-un flux Kate multiplexat cu fluxul Vorbis. Versurile pot fi in format LRC sau SRT i ar trebui sa fie codificate in UTF-8 sau ASCII simplu. Alte codificari pot fi convertite cu ajutorul unor instrumente precum <> sau <>. Alternativ, pentru conversia intre codificari se va utiliza acelai sistem ca i in cazul comentariilor. Sunt acceptate aa-numitele fiiere ,,enhanced LRC", iar o simpla modificare in stil karaoke va fi salvata impreuna cu versurile. Pentru configurari mai complexe de karaoke, ar trebui sa se utilizeze in schimb kateenc(1). La incorporarea versurilor, extensia implicita a fiierului de ieire este ,,.oga". Reinei ca adaugarea de versuri la un flux va activa automat ,,Skeleton" (consultai opiunea -k pentru mai multe informaii despre schelet (Skeleton)). -Y ir-limba, --lyrics-language ir-limba Definete limba pentru fiierul de versuri corespunzator la ir-limba. Acesta ar trebui sa fie un cod de limba ISO 639-1 (de exemplu, ,,en") sau o eticheta de limba RFC 3066 (de exemplu, ,,en_US"), nu un nume de limba de forma libera. In mod normal, programele de redare vor recunoate aceasta eticheta standard i vor afia numele limbii in propria dvs. limba. Reinei ca lungimea maxima a acestei etichete este de 15 caractere. Reinei ca opiunile -a, -t, -l, -L i -Y pot fi date de mai multe ori. Acestea vor fi aplicate, cate una pentru fiecare fiier, in ordinea data. In cazul in care sunt date mai puine comentarii privind albumul, titlul sau artistul decat numarul de fiiere de intrare, oggenc le va reutiliza pe cele din urma pentru fiierele ramase i va emite un avertisment in cazul titlurilor repetate. OPIUNI AVANSATE CODIFICATOR <> va permite sa configurai o serie de opiuni avansate de codificare folosind opiunea --advanced-encode-option. Acestea sunt destinate doar utilizatorilor foarte avansai i trebuie abordate cu precauie. Acestea pot degrada semnificativ calitatea audio daca sunt utilizate in mod greit. Nu toate aceste opiuni sunt documentate in prezent. lowpass_frequency=N Stabilete frecvena de trecere joasa la N kHz. impulse_noisetune=N Stabilete o deviaie a pragului de zgomot N (interval de la -15. la 0.) pentru blocurile de impulsuri. O deviaie negativa ii indica codificatorului sa acorde o atenie deosebita claritaii tranzienilor din audio codificat. Compromisul pentru un raspuns tranzitoriu mai bun este o rata de bii mai mare. bitrate_hard_max=N Stabilete rata maxima permisa pentru fiierul codificat la N kilobii pe secunda. Aceasta rata de bii poate fi depaita numai atunci cand exista bii de rezerva in rezervorul de bii; daca rezervorul de bii este epuizat, cadrele vor fi meninute sub aceasta valoare. Aceasta opiune trebuie sa fie utilizata cu opiunea ,,--managed" pentru a avea vreun efect. bitrate_hard_min=N Stabilete rata de bii minima permisa pentru fiierul codificat la N kilobii pe secunda. Aceasta rata de bii poate fi depaita numai atunci cand rezervorul de bii nu este plin; daca rezervorul de bii este plin, cadrele vor fi reinute peste aceasta valoare; daca este imposibil de adaugat bii in mod constructiv, cadrul va fi umplut cu zerouri. Aceasta opiune trebuie sa fie utilizata cu opiunea ,,--managed" pentru a avea vreun efect. bit_reservoir_bits=N Stabilete dimensiunea totala a rezervorului de bii la N bii; dimensiunea implicita a rezervorului este egala cu numarul nominal de bii codificai intr-o secunda (de exemplu, un fiier nominal de 128kbps va avea un rezervor de bii de 128000 bii in mod implicit). Aceasta opiune trebuie utilizata impreuna cu opiunea ,,--managed" pentru a avea vreun efect i afecteaza numai gestionarea ratei de bii minime i maxime. Codificarea ratei medii de bii fara limite stricte de rata de bii nu utilizeaza un rezervor de bii. bit_reservoir_bias=N Stabilete abaterea comportamentului rezervorului de bii (interval: 0. la 1.). Atunci cand este fixata mai aproape de 0, administratorul de viteza de bii incearca sa acumuleze bii pentru utilizare viitoare in cazul unor creteri brute ale vitezei de bii (inclinaie catre o reproducere mai buna a tranzienilor). Atunci cand este fixata mai aproape de 1, administratorul de rata de bii neglijeaza tranzienii in favoarea utilizarii de bii pentru pasaje omogene. La mijloc, administratorul folosete o abordare echilibrata. Valoarea implicita este de 0,2, ceea ce favorizeaza uor reproducerea tranzienilor. bitrate_average=N Stabilete rata medie de bii pentru fiier la N kilobii pe secunda. Atunci cand este utilizata fara limite minime sau maxime stricte, aceasta opiune selecteaza codificarea ratei medii de bii fara rezervor, in care codificatorul incearca sa urmareasca perfect o rata de bii dorita, dar nu impune limite stricte de fluctuaie momentana. Atunci cand este utilizata impreuna cu o limita minima sau maxima, rata medie de bii stabilete in continuare rata medie globala de bii a fiierului, dar va funciona in limitele stabilite de rezervorul de bii. Atunci cand rata de bii minima, maxima i medie sunt identice, <> produce date Vorbis ,,Constant Bit Rate" (la o rata de bii constanta). bitrate_average_damping=N Stabilete timpul de reacie pentru urmarirea vitezei medii de bii la N secunde. Acest numar reprezinta cea mai rapida reacie pe care monitorul de urmarire a vitezei de bii are voie sa o faca pentru a menine viteza de bii la media selectata. Cu cat timpul de reacie este mai rapid, cu atat mai mica este fluctuaia momentana a ratei de bii, dar (in general) cu atat mai scazuta este calitatea ieirii audio. Cu cat timpul de reacie este mai lent, cu atat mai mari sunt fluctuaiile ABR, dar (in general) cu atat mai buna este calitatea audio. Atunci cand este utilizata impreuna cu limitele min. sau max. ale ratei de bii, aceasta opiune afecteaza in mod direct cat de adanc i cat de repede va intra codificatorul in rezervorul sau de bii; cu cat numarul este mai mare, cu atat mai multa solicitare asupra rezervorului de bii. Valoarea stabilita trebuie sa fie mai mare decat zero, iar intervalul util este de aproximativ 0,05 pana la 10. Valoarea implicita este de 0,75 secunde. disable_coupling Dezactiveaza utilizarea cuplarii canalelor pentru codificarea multicanal. In prezent, codificatorul va utiliza in mod normal cuplarea canalelor pentru a crete i mai mult comprimarea cu intrarile stereo i 5.1. Aceasta opiune foreaza codificatorul sa codifice fiecare canal in mod complet independent, fara a utiliza nici cuplarea cu pierderi, nici cea fara pierderi. EXEMPLE Cea mai simpla versiune. Produce ieirea sub forma vreun-fiier.ogg: oggenc vreun-fiier.wav Se specifica un nume de fiier de ieire: oggenc vreun-fiier.wav -o ieire.ogg Se specifica o codificare de inalta calitate, cu o medie de 256 kbps (dar tot VBR): oggenc fiier-intrare.wav -b 256 -o fiier-ieire.ogg Se specifica o rata de bii maxima i una medie i se impune respectarea acestora: oggenc fiier-intrare.wav --managed -b 128 -M 160 -o fiier-ieire.ogg Se specifica mai degraba calitatea decat rata de bii (la un mod de calitate foarte ridicata): oggenc fiier-intrare.wav -q 6 -o fiier-ieire.ogg Se reduce eantionarea la 11 kHz i se face mixarea pe mono inainte de codificare: oggenc --resample 11025 --downmix fiier-intrare.wav -q 1 -o fiier-ieire.ogg Adaugarea unor informaii despre piesa: oggenc somefile.wav -t "Titlul piesei" -a "artistul ce canta" -l "numele albumului" -c "OTHERFIELD=coninutul vreunui alt camp ce nu este admis in mod explicit" Adaugarea de versuri incorporate: oggenc vreun-fiier.wav --lyrics versuri.lrc --lyrics-language en -o ieire.oga Acest lucru codifica cele trei fiiere, fiecare cu aceeai eticheta artist/album, dar cu etichete de titlu diferite pentru fiecare dintre ele. irul de caractere dat ca argument pentru ,,-n" este utilizat pentru a genera numele fiierelor, aa cum se arata in seciunea de mai sus. Acest exemplu ofera nume de fiiere precum ,,The Tea Party - Touch.ogg": oggenc -b 192 -a "The Tea Party" -l "Triptych" -t "Touch" piesa01.wav -t "Underground" piesa02.wav -t "Great Big Lie" piesa03.wav -n "%a - %t.ogg" Codificarea de la intrarea standard la ieirea standard (putei utiliza, de asemenea, diferitele opiuni de etichetare, cum ar fi -t, -a, -l, etc.): oggenc - AUTORI Autorul programului: Michael Smith Autorul paginilor de manual: Stan Seibert ERORI Citirea fiierelor Wave de tip 3 (eantioane in virgula mobila) probabil ca nu funcioneaza decat pe Intel (sau pe alte maini pe 32 de bii, little endian). CONSULTAI I vorbiscomment(1), ogg123(1), oggdec(1), flac(1), speexenc(1), ffmpeg2theora(1), kateenc(1) TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . Xiph.Org Foundation 5 octombrie 2008 oggenc(1)