Manual d'usuari de l'aplicació Resize Audio v0. 5 Índex Autor L'aplicació ha estat programada en C++ per Francisco Javier Rojas durant el mes d'agost de 2015. Correu electrònic per contactar: frojasg1@ hotmail.com Introducció L' aplicació Resize Audio permet transformar un fitxer d' àudio d' entrada en un fitxer d' àudio de sortida, la durada del qual és la durada original multiplicada per un factor que pot ser major o menor que 1. És una aplicació que s' executa des de la interfície d' ordres. Suporta els següents formats d' entrada i sortida: Entrada: wav, mp3, ac3, dts Sortida: mp3, ac3 De moment tan sols està disponible la versió Windows i no és probable que hi hagi versions per a altres plataformes. Llicència Aquesta aplicació té llicència GPL. Això vol dir que el seu codi està obert per a qualsevol que vulgui veure-ho, utilitzar-lo o modificar-lo, sempre que les noves aplicacions que en facin ús tinguin al seu torn llicència GPL. Per a més informació sobre aquest tipus de llicències, es pot consultar aquest enllaç: http: // www.gnu.org/licencs/gpl-3.0. en.html Com baixar el codi Per a baixar el codi de l' aplicació, així com de les llibreries que useu, consulteu aquest enllaç: https: // sourceforge.net/projects/audio- synchonization/ Inici ràpid Per a començar a usar l' aplicació, segueix els següents passos: Obre una finestra d' interfície d' ordres (Tecla de Windows + R i escriu "cmd" + Return). Mou-te al directori on hi ha el binari de Resize Audio (estarà en el directori on has descomprimit el.tar.gz de l'aplicació, en el subdirectorio _barro). S' està executant l' ordre: cd ruta.../ _binry. Executa l' ordre següent: PATH=% PATH%;lib Ara ja podem executar l' aplicació. L' aplicació accepta diversos paràmetres d' entrada, que permeten modificar el seu comportament i que seran explicats en punts posteriors d' aquest manual. Una manera senzilla d' invocar l' aplicació podria ser aquesta: resizeAudioFile. exe "Fichero_ de_ entrada" "Fichero_ de_ salida" -factor _factor_ Paràmetres En aquest capítol es veuran els paràmetres que pot prendre l' aplicació com a entrada, així com les possibilitats que hi ha per omplir- los. El format de l' ordre d' invocació a l' aplicació és aquest: resizeAudioFile.exe "Fichero_ de_ entrada" "Fichero_ de_ sortida" [-factor _factor_] [-lowQuality-highQuality] [-tb sencer_ inversDeLaBandaDeTransicion Total] [-br bitrat_ de_ la_ sortida_ en_ kbps] Els primers paràmetres són obligatoris i han d' aparèixer exactament en el mateix ordre en el que estan escrits en la línia anterior. Els claudàtors: [] indiquen que el paràmetre que hi ha al seu interior és opcional. La barra vertical indica que o bé apareix la possibilitat de l' esquerra, o bé apareix la possibilitat de la dreta, però no ambdues alhora. Els paràmetres opcionals no cal que estiguin ordenats tal com s' indica en la línia de format de l' ordre. Fitxer_ de_ entrada i Fitxer_ de_ sortida Aquests paràmetres són obligatoris i han d' anar en l' ordre indicat. Fitxer_ de_ entrada i Fitxer_ de_ salida poden estar entre cometes per incloure la possibilitat que s' incloguin espais en els noms del fitxer o les seves rutes. Poden incloure paths absoluts o paths relatius cap als fitxers. Es pot usar l' opció de completar de l' intèrpret d' ordres, escrivint part del nom del fitxer, i prement una o diverses vegades el tabulador. Això es pot repetir per a cada directori, i a més normalment l' intèrpret d' ordres afegeix automàticament les cometes en cas de ser necessari quan s' usa el tabulador. Els formats d' entrada que reconeix l' aplicació, són alguns dels que proporciona la llibreria ffmpeg. Per a cada format d' entrada, l' aplicació assigna un format de sortida i aquesta assignació no es pot modificar. Els formats dels fitxers d' entrada i de sortida s' aparellen d' aquesta manera: [- factor _ factor_] Aquest paràmetre és opcional. Si s' omet, es prendrà un factor 1 (l' àudio no es transforma). _factor_ s' ha de substituir pel factor que es vulgui aplicar a la durada. Deu estar en format anglosaxó, és a dir, utilitzant el. com separador entre la part sencera i la part decimal. Per exemple, per aplicar un factor del 101%, caldria posar com a _factor_ 1.01. La invocació a l' ordre quedaria així: resizeAudioFile. exe "Fichero_ de_ entrada" "Fichero_ de_ salida" -factor 1.01 L' aplicació permet una resolució màxima per al factor de 5 xifres decimals, i aproximarà el factor de l' entrada dins d' aquesta resolució (el factor aplicat normalment serà lleugerament diferent del factor d' entrada, però respectant la resolució de 5 dígits decimals). [-lowQuality- highQuality] Aquest paràmetre és opcional. Si no està present, l' aplicació es comporta com si s' hagués introduït - highQuality. Per a seleccionar la qualitat, s' ha d' introduir un i només un dels paràmetres. -lowQuality. Quan s' usa aquest paràmetre, la qualitat de la interpolació és menor per a les altes freqüències. Usa aquest paràmetre fa que per al filtratge d' interpolació s' usi el filtre passa baix ideal amb una finestra rectangular, que té menys qualitat que l' opció de - highQuality, però és el doble de ràpida que aquesta. - highQuality. Quan s' usa aquest paràmetre, la qualitat de la interpolació és més gran per a les altes freqüències. Usa aquest paràmetre fa que per al filtratge d' interpolació s' usi el filtre passa baix ideal amb una finestra de Hamming, que té més qualitat que l' opció de -lowQuality, però és el doble de lenta que aquesta. [- tb sencer_ inversDeLaBandaDeTransicion Total] Aquest paràmetre és opcional. En cas que no aparegui entre els paràmetres d' entrada de l' ordre d' invocació a l' aplicació es prendran els següents valors per defecte, en funció de la freqüència de mostreig del senyal d' àudio: En el cas que la freqüència de mostreig sigui diferent de 44100 Hz i diferent de 48000 Hz, en aquest cas s' ha suposat un valor per a aquest paràmetre igual a 6, encara que a cegues, i és possible que aquest valor no sigui apropiat. En cas que la freqüència sigui diferent de 44100 Hz i diferent de 48000 Hz, caldria incloure aquest paràmetre indicant un valor apropiat per a aquest paràmetre. Valors majors d' aquest paràmetre, donen bandes de transició menors per als filtres pas baix, i per tant donen millor qualitat. No obstant això, el temps emprat en el processament de les mostres d'àudio, és proporcional a aquest paràmetre, per la qual cosa si es dobla el valor d'aquest paràmetre, es doblega el temps de processament de les mostres d'àudio. Hi ha una fórmula per calcular un bon valor per aquest paràmetre: sencer_ inversDeLaBandaDeTransicion Total = Fm / 4 / ( Fm / 2 - AmpladaDeBandaSeñalDeAudio ) On Fm és la freqüència de mostreig. Recorda que l' aplicació espera un valor sencer per a aquest paràmetre. Per exemple: Audio sovint de mostreig = 8000 Hz amplada de banda del senyal = 3800 Hz Llavors sencer_ inversDeLaBandaDeTransicion Total =800 / 4 / ( 8000 / 2 - 3800 ) = 2000 / 200 = 10 Per a aquest exemple l' ordre d' invocació a l' aplicació quedaria així: resizeAudioFile.exe "Fichero_ de_ entrada" "Fichero_ de_ sortida" -factor 1.01 - tb 10 [- br bitrat_ de_ la_ salida_ en_ kbps] Aquest paràmetre és opcional, i si no s' especifica, s' usarà el valor per defecte. El valor per defecte per a aquest paràmetre dependrà del format del fitxer d' àudio d' entrada: Com podeu apreciar- se en la taula, quan el format de sortida és igual al d' entrada el bitrat per defecte de sortida és el bitrat d' entrada. Quan el format de sortida difereix de l' entrada, el bitrat per defecte és el màxim permès per al format de sortida. Si cal bitrats específics diferents dels de per defecte, caldrà usar aquest paràmetre. Com a exemple podem veure l' ordre d' invocació a l' aplicació per a transformar un fitxer.dts en un fitxer.ac3 amb bitrat de 384 kbps: resizeAudioFile.exe "entrada.dts" "sortida. ac3" - br 384 Teoria en la que es basa l' aplicació Per a veure la teoria en la que es basa l' aplicació, consultar el directori:...\ _ docs\ teory Agraïments - Als creadors de la llibreria ffmpeg. - Als creadors de les llibreries en les quals es basa ffmpeg. - Al creador de la llibreria FOBS4JMF (), recobriment de la llibreria ffmpeg que simplifica molt el seu ús. Sense aquestes llibreries (un treball monstruós), el desenvolupament de la petita aplicació de Resize Audio no hauria estat possible. Enllaços http: // frojasg1.com http: // fobs. sourceforge.net/index.html