Scroll to navigation

oggenc(1) Outils Vorbis oggenc(1)

NOM

oggenc – Encodage d’audio au format Ogg Vorbis

SYNOPSIS

oggenc [ -hrQ ] [ -B taille d’échantillonnage d’entrée en mode raw ] [ -C nombre de canaux d’entrée en mode raw ] [ -R fréquence d’échantillonnage de l’entrée en mode raw ] [ -b débit binaire nominal ] [ -m débit binaire minimal ] [ -M débit binaire maximal ] [ -q qualité ] [ --resample fréquence ] [ --downmix ] [ -s numéro de série ] [ -o fichier_sortie ] [ -n motif ] [ -c commentaire_supplémentaire ] [ -a artiste ] [ -t titre ] [ -l album ] [ -G genre ] [ -L fichier_paroles ] [ -Y code_langue ] fichiers_entrée...

DESCRIPTION

oggenc lit des données audio au format raw, WAVE ou AIFF et les encode en un flux au format Ogg Vorbis. oggenc peut aussi lire des données audio de fichiers FLAC et FLAC d’Ogg selon les options de compilation. Si le fichier d’entrée spécifié est « - », les données audio sont lues sur l’entrée standard et le flux Vorbis est écrit sur la sortie standard à moins que l’option -o ne redirige la sortie. Par défaut, les fichiers sur le disque sont des fichiers Ogg Vorbis du même nom avec une extension changée en « .ogg » ou « .oga ». Cette convention de nommage peut être outrepassée avec l’option -o (dans le cas d’un seul fichier) ou l’option -n (dans le cas de plusieurs fichiers). En définitive, si aucune de ces options n’est spécifiée, le nom du fichier produit est le nom du fichier d’entrée avec l’extension (la partie après le point) remplacée par ogg, ainsi fichier.wav devient fichier.ogg.
Facultativement, des paroles peuvent être incorporées dans le fichier Ogg si la prise en charge de Kate (codec de superposition) a été compilée.
Remarquez que certains lecteurs anciens peuvent échouer à lire des flux composés de plus d’un flux Vorbis (ce qui est appelé le profil simple « Vorbis I »).

OPTIONS

Afficher une description des commandes
Afficher le numéro de version.
Assumer que les données d’entrée sont des données audio petit−boutistes sans information d’entête. Si d’autres options ne sont pas spécifiées, la valeur par défaut est stéréo 44,1 kHz 16 bits. Consultez les trois options suivantes pour savoir comment modifier cela.
Définir la taille d’échantillonnage en bits de l’entrée en mode raw. Par défaut 16.
Définir le nombre de canaux d’entrée en mode raw. Par défaut 2.
Définir la fréquence d’échantillonnage de l’entrée en mode raw. Par défaut 44100.
Définir le boutisme de l’entrée en mode raw à gros-boutisme (1) ou petit-boutisme (0). Par défaut, petit-boutisme.
Informer oggenc que les commentaires de Vorbis sont déjà encodés en UTF-8. C’est utile pour les cas où l’interpréteur de commandes utilise un autre encodage.
Ajouter un flux binaire Skeleton. C’est important si la sortie Ogg est destinée à transporter des flux multiplexés ou chainés. Les fichiers de sortie utilisent l’extension de fichier .oga.
Prendre en charge les fichiers WAVE de plus de 4 Go et les flux de données de l’entrée standard.
Mode silencieux. Aucun message n’est affiché.
Définir le débit binaire à n (en ko/s). L’encodeur essaie d’encoder approximativement à cette vitesse. Par défaut, cela demeure un encodage à vitesse variable (VBR). Consultez l’option --managed pour forcer un encodage au débit géré selon le débit choisi.
Définir le débit binaire minimal à n (en ko/s). Activation du mode de gestion du débit (voir l’option --managed).
Définir le débit binaire maximal à n (en ko/s). Activation du mode de gestion du débit (voir l’option --managed).
Définir le mode de gestion du débit binaire. Cela désactive l’encodage VBR normal, mais permet des contraintes de débit strictes ou approximatives forcées par l’encodeur. Ce mode est plus lent et peut être aussi de plus basse qualité. C’est utile principalement pour la création de fichiers à diffuser.
Définir la qualité d’encodage à n, entre -1 (très basse) et 10 (très haute). C’est le mode par défaut d’opération, avec un niveau de qualité réglé à 3. Des niveaux fractionnaires tels que 2,5 sont permis. L’utilisation de cette option permet à l’encodeur de choisir un débit binaire approprié au niveau de qualité désiré.
Rééchantillonner l’entrée à la vitesse d’échantillonnage spécifiée (en Hz) avant l’encodage. C’est utile principalement pour un encodage à un plus petit débit binaire.
Remixer de stéréo à mono (aucun effet sur les flux non stéréo). C’est utile pour un encodage à un plus petit débit binaire.
Définir une option avancée. Voir la section concernant les options avancées pour plus de détails.
Forcer un numéro de série spécifique dans le flux de sortie. C’est utile principalement pour des tests.
Empêcher les commentaires des fichiers FLAC et FLAC d’Ogg d’être copiés dans le fichier Ogg Vorbis de sortie.
Écrire le flux Ogg Vorbis dans le fichier_sortie (seulement valable si un seul fichier d’entrée est spécifié).

Produire des noms de fichier selon ce motif, avec %g, %a, %l, %n, %t, %d remplacés respectivement par les genre, artiste, album, numéro de piste, titre et date (voir ci-après leurs spécifications). %% produit un « % » littéral.
Retirer les caractères spécifiés des paramètres pour une chaine au format -n. C’est utile pour s’assurer que des noms de fichier autorisés seront générés.
Remplacer les caractères retirés avec l’option --name-remove par les caractères spécifiés. Si cette chaine est plus petite que la liste de l’option --name-remove, ou si celle-ci n’est pas spécifiée, les caractères supplémentaires sont simplement retirés. Les réglages par défaut pour cette option et l’option -X ci-avant sont spécifiques à la plateforme (et choisis pour que des noms de fichier autorisés soient créés pour chaque plateforme).

Ajouter la chaine commentaire comme commentaire supplémentaire. Cette option peut être utilisée plusieurs fois et toutes les instances sont ajoutées à chaque fichier d’entrée spécifié. Cet argument doit être de la forme « étiquette=valeur ».

Définir le champ de commentaire d’artiste à artiste.

Définir le champ de commentaire de genre à genre.

Définir le champ de commentaire de date à la valeur indiquée. Cela doit être la date de l’enregistrement.

Définir le champ de commentaire de numéro de piste à la valeur indiquée.

Définir le champ de commentaire de titre de piste à titre.

Définir le champ de commentaire d’album à album.

Charger les paroles à partir de fichier et les encoder dans un flux Kate multiplexé avec le flux Vorbis. Les paroles peuvent être au format LRC ou SRT, et doivent être encodées en UTF-8 ou en ASCII standard. Les autres encodages peuvent être convertis à l’aide d’outils tels que iconv(1) ou recode(1). Sinon, le même système que pour les commentaires sera utilisé pour la conversion entre les encodages. Les fichiers dits « LRC amélioré » sont pris en charge, et une simple modification de style karaoké sera enregistrée avec les paroles. Pour des configurations de karaoké plus complexes, il convient d’utiliser plutôt kateenc(1). Lors de l’intégration de paroles, l’extension par défaut du fichier de sortie est .oga. Remarquez que l’ajout de paroles à un flux active automatiquement Skeleton (voir l’option -k pour plus d’informations sur Skeleton).

Définir la langue du fichier de paroles correspondant à code_langue. Cela doit être un code de langue ISO 639-1 (par exemple, « fr ») ou une étiquette de langue selon la norme RFC 3066 (par exemple, « fr_FR »), pas un nom de langue de forme libre. Typiquement, les lecteurs de musique reconnaissent ces étiquettes standard et affichent le nom de langue dans votre propre langue. Remarquez que la longueur maximale de cette étiquette est de 15 caractères.

Remarquez que les options -a, -t, -l, -L et -Y peuvent être indiquées plusieurs fois. Elles seront appliquées, à raison d’une par fichier, selon l’ordre fourni. S’il y a moins de commentaires d’album, de titre ou d’artiste que de fichiers d’entrée, oggenc utilise la dernière pour les fichiers restants, et émet un avertissement dans le cas de titres répétés.

OPTIONS AVANCÉES D’ENCODEUR

oggenc permet de définir un certain nombre d’options avancées d’encodeur en utilisant l’option --advanced-encode-option. Elles sont destinées seulement aux utilisateurs très expérimentés et devraient être abordées précautionneusement. Mal utilisées, elles peuvent dégrader de manière significative la qualité audio. Ces options ne sont pas encore toutesdocumentées.

Définir la fréquence de coupure à N khz.

Définir un décalage du bruit de fond N (compris entre -15 et 0) pour les blocs d'impulsion. Un décalage négatif indique à l'encodeur d’accorder une attention particulière à la netteté des transitoires dans le signal audio encodé. L'amélioration de la réponse aux transitoires s'accompagne d'un débit binaire plus élevé.

Définir le débit binaire maximal pour le fichier encodé à N kilooctets par seconde. Ce débit binaire ne peut être dépassé que s’il existe des bits supplémentaires dans le réservoir de bits ; si celui-ci est vide, les trames seront conservées au-dessous de cette valeur. Ce réglage doit être utilisé avec l’option --managed pour avoir un effet.

Définir le débit binaire minimal pour le fichier encodé à N kilooctets par seconde. Ce débit binaire ne peut être « souspassé » que si le réservoir de bits n’est pas plein ; si celui-ci est plein, les trames seront conservées au-dessus de cette valeur ; s’il est impossible d’ajouter des bits constructivement, les trames seront complétées par des zéros. Ce réglage doit être utilisé avec l’option --managed pour avoir un effet.

Définir la taille totale du réservoir de bits à N bits ; la taille par défaut du réservoir est égale au nombre nominal de bits codés en une seconde (par exemple, un fichier de débit nominal de 128 kbps a un réservoir de 128 000 bits par défaut). Cette option doit être utilisée avec l’option --managed pour avoir un effet et n’affecte que la gestion des débits binaires minimal et maximal. Un encodage de débit normal sans limites strictes n’utilise pas de réservoir de bits.

Définir le comportement du décalage du réservoir de bits (plage de 0 à 1). Lorsqu’il est défini proche de 0, le gestionnaire de débit binaire essaie d’accumuler des bits pour une future utilisation lors d’un accroissement soudain du débit (privilégiant une meilleure restitution des transitoires). Lorsqu’il est défini proche de 1, le gestionnaire néglige les transitoires en faveur d’une utilisation des bits pour des passages homogènes. Au milieu, le gestionnaire adopte une approche équilibrée. La valeur par défaut est 0,2, ce qui privilégie légèrement la reproduction des transitoires.

Définir le débit binaire moyen pour le fichier à N kilobits par seconde. Lorsqu’elle est utilisée sans limites minimale ou maximale strictes, cette option sélectionne un encodage à débit binaire moyen (ABR) sans réservoir, pour lequel l’encodeur tente de suivre parfaitement le débit binaire souhaité, mais n’impose aucune limite stricte aux fluctuations momentanées. Lorsqu’elle est utilisée avec une limite minimale ou maximale, le débit binaire moyen définit toujours le débit binaire moyen global du fichier, mais fonctionne dans les limites fixées par le réservoir de bits. Lorsque les débits binaires minimal, maximal et moyen sont identiques, oggenc produit des données Vorbis à débit binaire constant (CBR).

Définir le temps de réaction pour le suivi de débit binaire moyen à N secondes. Ce nombre représente le temps de réaction le plus rapide permis pour le suivi pour que le débit binaire reste dans la moyenne choisie. Plus ce temps est court, plus les fluctuations momentanées du débit sont faibles, mais (généralement) la qualité de la sortie est plus faible. Plus le temps de réaction est long, plus les fluctuations momentanées sont importantes, mais (généralement) la qualité de la sortie audio est supérieure. Lorsqu’elle est utilisée avec des limites minimale et maximale de débit, cette option affecte directement l’importance et la vitesse avec lesquelles l’encodeur pioche dans son réservoir de bits ; plus le nombre est grand, plus la demande dans le réservoir est importante.

Le réglage doit être supérieur à zéro et la plage utile est approximativement 0,05 à 10. La valeur par défaut est 0,75 seconde.

Désactiver le couplage de canaux pour les encodages multicanaux. Actuellement, l’encodeur utilise normalement le couplage de canaux pour accroitre ensuite la compression pour les entrées stéréo et 5.1. Cette option oblige l’encodeur à encoder chaque canal de manière complètement indépendante en n’utilisant aucun couplage avec pertes ou sans pertes.

EXEMPLES

Version la plus simple produisant un fichier.ogg :

oggenc fichier.wav

Spécification de fichier de sortie :

oggenc fichier.wav -o sortie.ogg

Spécification d’un encodage de haute qualité de moyenne 256 kbps (mais toujours VBR) :

oggenc fichier.wav -b 256 -o sortie.ogg

Spécification et obligation d’un débit binaire moyen et maximal :

oggenc fichier.wav --managed -b 128 -M 160 -o sortie.ogg

Spécification de qualité au lieu du débit binaire (pour un mode de très haute qualité) :

oggenc fichier.wav -q 6 -o sortie.ogg

Réduction de l’échantillonnage et des canaux vers 11 khz mono avant encodage :

oggenc --resample 11025 --downmix fichier.wav -q 1 -o sortie.ogg

Ajout d’une information à propos de la piste :

oggenc somefile.wav -t "Titre de piste" -a "artiste concerné" -l "nom de l’album" -c "OTHERFIELD=contenu d’un autre champ non pris en charge explicitement"

Intégration des paroles :

oggenc fichier.wav --lyrics lyrics.lrc --lyrics-language fr -o sortie.oga

Le code qui suit encode trois fichiers, chacun avec les mêmes étiquettes d’artiste et d’album, mais avec des étiquettes de titre différentes. La chaine fournie comme argument à l’option -n est utilisée pour générer les noms de fichier, comme indiqué dans la section ci-avant. Cet exemple fournit des noms de fichier tels que « The Tea Party - Touch.ogg » :

oggenc -b 192 -a "The Tea Party" -l "Triptych" -t "Touch" track01.wav -t "Underground" track02.wav -t "Great Big Lie" track03.wav -n "%a - %t.ogg"

Encodage depuis l’entrée standard vers la sortie standard (les diverses options d’étiquetage peuvent être utilisées telles que -t, -a, -l, etc.) :

oggenc -

AUTEURS


Michael Smith <msmith@xiph.org>


Stan Seibert <indigo@aztec.asu.edu>

BOGUES

La lecture des fichiers WAVE de type 3 (échantillonnage en virgule flottante) ne fonctionnera probablement pas sur des plateformes autres que Intel (ou d'autres machines petit-boutistes 32 bits).

VOIR AUSSI

vorbiscomment(1), ogg123(1), oggdec(1), flac(1), speexenc(1), ffmpeg2theora(1), kateenc(1)

TRADUCTION

La traduction française de cette page de manuel a été créée par Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.

5 octobre 2008 Fondation Xiph.Org