Documentation du rééchantillonneur FFmpeg

1 Description

Le rééchantillonneur FFmpeg fournit une interface de haut niveau aux utilitaires de rééchantillonnage audio de la bibliothèque libswresample. Il permet notamment d'effectuer le rééchantillonnage audio, le remixage de la disposition des canaux audio, ainsi que la conversion du format audio et de la disposition d'empaquetage.

2 Options du rééchantillonneur

Le rééchantillonneur audio prend en charge les options nommées suivantes.

Les options peuvent être définies en spécifiant -option value dans les outils FFmpeg, option=value pour le filtre aresample, en définissant la valeur explicitement dans les options de SwrContext, ou via l'API libavutil/opt.h pour un usage programmatique.

uchl, used_chlayout

Définit la disposition des canaux d'entrée utilisée. Par défaut, elle n'est pas définie. Cette option n'est utilisée que pour un remappage spécial.

isr, in_sample_rate

Définit la fréquence d'échantillonnage d'entrée. La valeur par défaut est 0.

osr, out_sample_rate

Définit la fréquence d'échantillonnage de sortie. La valeur par défaut est 0.

isf, in_sample_fmt

Spécifie le sample format d'entrée. Il est défini par défaut sur none.

osf, out_sample_fmt

Spécifie le sample format de sortie. Il est défini par défaut sur none.

tsf, internal_sample_fmt

Définit le sample format interne. La valeur par défaut est none. Il est choisi automatiquement lorsqu'il n'est pas défini explicitement.

ichl, in_chlayout ochl, out_chlayout

Définit la disposition des canaux d'entrée/sortie.

Pour la syntaxe requise, voir (ffmpeg-utils)la section Channel Layout du manuel ffmpeg-utils(1).

clev, center_mix_level

Définit le niveau de mixage central. Il s'agit d'une valeur exprimée en décibels, qui doit être comprise dans l'intervalle [-32,32].

slev, surround_mix_level

Définit le niveau de mixage surround. Il s'agit d'une valeur exprimée en décibels, qui doit être comprise dans l'intervalle [-32,32].

lfe_mix_level

Définit le niveau de mixage du canal LFE vers les canaux non-LFE. Il est utilisé lorsqu'il y a une entrée LFE mais pas de sortie LFE. Il s'agit d'une valeur exprimée en décibels, qui doit être comprise dans l'intervalle [-32,32].

rmvol, rematrix_volume

Définit le volume de remixage. La valeur par défaut est 1.0.

rematrix_maxval

Définit la valeur de sortie maximale pour le remixage. Cela permet de choisir entre éviter l'écrêtage et éviter la réduction du volume. Une valeur de 1.0 évite l'écrêtage.

flags, swr_flags

Définit les indicateurs utilisés par le convertisseur. La valeur par défaut est 0.

Cette option prend en charge les indicateurs individuels suivants :

res

force le rééchantillonnage ; cet indicateur force l'utilisation du rééchantillonnage même lorsque les fréquences d'échantillonnage d'entrée et de sortie correspondent.

dither_scale

Définit l'échelle de tramage. La valeur par défaut est 1.

dither_method

Définit la méthode de tramage. La valeur par défaut est 0.

Valeurs prises en charge :

‘rectangular’

sélectionne un tramage rectangulaire

‘triangular’

sélectionne un tramage triangulaire

‘triangular_hp’

sélectionne un tramage triangulaire avec passe-haut

‘lipshitz’

sélectionne un tramage à mise en forme du bruit de Lipshitz.

‘shibata’

sélectionne un tramage à mise en forme du bruit de Shibata.

‘low_shibata’

sélectionne un tramage à mise en forme du bruit low Shibata.

‘high_shibata’

sélectionne un tramage à mise en forme du bruit high Shibata.

‘f_weighted’

sélectionne un tramage à mise en forme du bruit f-weighted

‘modified_e_weighted’

sélectionne un tramage à mise en forme du bruit modified-e-weighted

‘improved_e_weighted’

sélectionne un tramage à mise en forme du bruit improved-e-weighted

resampler

Définit le moteur de rééchantillonnage. La valeur par défaut est swr.

Valeurs prises en charge :

‘swr’

sélectionne le rééchantillonneur logiciel natif (SW Resampler) ; les options de filtre precision et cheby ne s'appliquent pas dans ce cas.

‘soxr’

sélectionne le rééchantillonneur SoX (SoX Resampler, si disponible) ; compensation, ainsi que les options de filtre filter_size, phase_shift, exact_rational, filter_type et kaiser_beta, ne s'appliquent pas dans ce cas.

filter_size

Pour swr uniquement, définit la taille du filtre de rééchantillonnage, la valeur par défaut est 32.

phase_shift

Pour swr uniquement, définit le déphasage de rééchantillonnage, la valeur par défaut est 10, et doit être comprise dans l'intervalle [0,30].

linear_interp

Utilise l'interpolation linéaire lorsqu'elle est activée (valeur par défaut). Désactivez-la si vous souhaitez privilégier la vitesse à la qualité lorsque exact_rational échoue.

exact_rational

Pour swr uniquement, lorsqu'elle est activée, tente d'utiliser un phase_count exact basé sur les fréquences d'échantillonnage d'entrée et de sortie. Cependant, si cette valeur est supérieure à 1 << phase_shift, le phase_count devient 1 << phase_shift par repli. Elle est activée par défaut.

cutoff

Définit le rapport de la fréquence de coupure (swr : point à 6dB ; soxr : point à 0dB) ; doit être une valeur à virgule flottante comprise entre 0 et 1. La valeur par défaut est 0.97 pour swr, et 0.91 pour soxr (qui, avec une fréquence d'échantillonnage de 44100, préserve toute la bande audio jusqu'à 20kHz).

precision

Pour soxr uniquement, précision en bits avec laquelle le signal rééchantillonné est calculé. La valeur par défaut de 20 (qui, avec un tramage adapté, convient à une profondeur de destination de 16 bits) correspond au ’High Quality’ de SoX ; une valeur de 28 correspond au ’Very High Quality’ de SoX.

cheby

Pour soxr uniquement, sélectionne l'absence de rolloff en bande passante (Chebyshev) et une approximation de plus haute précision pour les rapports ’irrationnels’. La valeur par défaut est 0.

async

Pour swr uniquement, synchronisation audio simple à un paramètre sur les horodatages, par étirement, compression, remplissage et découpe. Définir cette valeur à 1 active le remplissage et la découpe ; des valeurs plus élevées représentent la quantité maximale, en échantillons, dont les données peuvent être étirées ou compressées par seconde. La valeur par défaut est 0, si bien qu'aucune compensation n'est appliquée pour faire correspondre les échantillons aux horodatages audio.

first_pts

Pour swr uniquement, suppose que le premier pts devrait avoir cette valeur. L'unité de temps est 1 / fréquence d'échantillonnage. Cela permet le remplissage ou la découpe en début de flux. Par défaut, aucune hypothèse n'est faite sur le pts attendu de la première image, si bien qu'aucun remplissage ni découpe n'est effectué. Par exemple, cette valeur pourrait être définie à 0 pour remplir le début avec du silence si un flux audio démarre après le flux vidéo, ou pour découper les échantillons dont le pts est négatif en raison du délai de l'encoder.

min_comp

Pour swr uniquement, définit la différence minimale entre les horodatages et les données audio (en secondes) qui déclenche l'étirement, la compression, le remplissage ou la découpe des données pour les faire correspondre aux horodatages. Par défaut, l'étirement, la compression, le remplissage et la découpe sont désactivés (min_comp = FLT_MAX).

min_hard_comp

Pour swr uniquement, définit la différence minimale entre les horodatages et les données audio (en secondes) qui déclenche l'ajout ou la suppression d'échantillons pour les faire correspondre aux horodatages. Cette option constitue en pratique un seuil permettant de choisir entre une compensation dure (découpe/remplissage) et une compensation douce (compression/étirement). Notez que toute compensation est désactivée par défaut via min_comp. La valeur par défaut est 0.1.

comp_duration

Pour swr uniquement, définit la durée (en secondes) pendant laquelle les données sont étirées ou compressées pour les faire correspondre aux horodatages. Doit être une valeur à virgule flottante double précision non négative, la valeur par défaut est 1.0.

max_soft_comp

Pour swr uniquement, définit le facteur maximal par lequel les données sont étirées ou compressées pour les faire correspondre aux horodatages. Doit être une valeur à virgule flottante double précision non négative, la valeur par défaut est 0.

matrix_encoding

Sélectionne le codage stéréo matriciel.

Accepte les valeurs suivantes :

‘none’

n'en sélectionne aucun

‘dolby’

sélectionne Dolby

‘dplii’

sélectionne Dolby Pro Logic II

La valeur par défaut est none.

filter_type

Pour swr uniquement, sélectionne le type de filtre de rééchantillonnage. Cela n'affecte que les opérations de rééchantillonnage.

Accepte les valeurs suivantes :

‘cubic’

sélectionne cubique

‘blackman_nuttall’

sélectionne un sinc à fenêtre de Blackman Nuttall

‘kaiser’

sélectionne un sinc à fenêtre de Kaiser

kaiser_beta

Pour swr uniquement, définit la valeur bêta de la fenêtre de Kaiser. Doit être une valeur à virgule flottante double précision comprise dans l'intervalle [2,16], la valeur par défaut est 9.

output_sample_bits

Pour swr uniquement, définit le nombre de bits d'échantillon de sortie utilisés pour le tramage. Doit être un entier compris dans l'intervalle [0,64], la valeur par défaut est 0, ce qui signifie qu'il n'est pas utilisé.

3 Voir aussi

ffmpeg, ffplay, ffprobe, libswresample

4 Auteurs

Les développeurs de FFmpeg.

Pour plus de détails sur les auteurs, consultez l'historique Git du projet (https://git.ffmpeg.org/ffmpeg), par exemple en tapant la commande git log dans le répertoire source de FFmpeg, ou en consultant le dépôt en ligne à l'adresse https://git.ffmpeg.org/ffmpeg.

Les mainteneurs des composants spécifiques sont répertoriés dans le fichier MAINTAINERS de l'arborescence du code source.

Hébergement fourni par telepoint.bg