AVISource / OpenDMLSource / AVIFileSource / WAVSource

AVISource (chaîne nom_de_fichier [, ...], booléen "audio" = vrai, chaîne "type_de_pixel" = YV12, [chaîne fourCC])
OpenDMLSource (chaîne nom_de_fichier [, ...], booléen "audio" = vrai, chaîne "type_de_pixel" = YV12, [chaîne fourCC])
AVIFileSource (chaîne nom_de_fichier [, ...], booléen "audio" = vrai, chaîne "type_de_pixel" = YV12, [chaîne fourCC])
WAVSource (chaîne nom_de_fichier [, ...])

Le filtre AVISource accepte comme argument un ou plusieurs noms de fichiers placés entre des guillemets. Il y accède en utilisant soit l'interface "AVIFile" VFW(Video for Windows) ou le code OpenDML interne d'AviSynth (importé de VirtualDub). Ce filtre peut lire n'importe quels fichiers dans lequel est inclus le processus de gestion (handler) AVIFile. Cela ne comprend pas seulement les fichiers AVI mais aussi les fichiers WAV, les fichiers AVS (scripts AviSynth), et les fichiers VDR (serveur d'images de VirtualDub). Si vous passez plusieurs noms de fichiers comme arguments, les clips seront assemblés avec le filtre UnalignedSplice. L'argument booléen audio est optionnel et par défaut à la valeur vrai.

Le filtre AVISource examine le fichier pour déterminer son type et le transmet au handler AVIFile ou OpenDML approprié. Au cas ou vous rencontriez un problème avec l'un ou l'autre gestionnaire de processus, vous pouvez alors utilisez les filtres OpenDMLSource et AVIFileSource qui forceront l'utilisation d'un des handlers. Chacun peut lire normalement des fichiers AVI (< 2Go), mais seul le handler OpenDML peut accéder à des fichiers de taille supérieure, et seul le handler AVIFile peut gérer d'autres types de fichiers tels que WAV, VDR et AVS.

Jusqu'à v2.04, WAVSource était un alias de AVIFileSource. Dans les version postérieures, WAVSource n'essaye plus d'ouvrir le flux video. Cela peut être utile si vous voulez récupérer le flux audio d'un fichier AVI dans le cas où le flux video est endommagé ou lorsque son type de compression n'est pas supporté par votre système.

Depuis v2.04, il y a un support pour les flux audio de type ACM (Audio Compression Manager); par exemple les fichiers AVI contenant une piste audio mp3. AVISource n'est plus capable d'ouvrir les fichier WAV, qui doivent être ouvert avec WAVSource.

Depuis v2.06, le paramètre type_de_pixel (par défaut YUY2) permet de choisir le format de couleur de sortie adapté au décompresseur. Les valeurs possibles sont "YUY2", "RGB32" and "RGB24". Si ce paramètre est omis, AviSynth utilise le premier format de couleur supporté par le décompresseur (dans l'ordre suivant: YUY2, RGB32, RGB24). Ce paramètre n'entre pas en compte si la video est dans un format non compressé (YUY2, RGB32 ou RGB24), puisqu'aucun décompresseur n'est utilisé dans ce cas.

Depuis v2.5 le type_de_pixel par défaut est YV12. Autrement dit, si vous ne spécifiez aucun type_de_pixel, il essayera de transmettre le fichier AVI sous le format YV12. Si ce n'est pas possible, il essayera le format YUY2, et si ce n'est toujours pas possible, il essayera le format RGB.

Quelquefois, les couleurs peuvent subir une distorsion quand vous chargez une video DivX dans AviSynth v2.5 (les canaux U et V sont inversés). Cela est dû à un bug dans le codec DivX (versions 5.02 et ultérieures). Vous pouvez corriger ce problème en utilisant le filtre  SwapUV.

Depuis v2.53 AVISource peut également ouvrir les fichiers video DV de type 1 (seulement la video, pas l'audio).

Depuis v2.55, l'option fourCC a été ajoutée. Le FourCC, est l'acronyme de FOUR Character Code (code à quatre caractères) qui est présent dans l'entête d'un fichier, et qui est principalement associé aux fichiers AVI.  Il dit quel codec de votre système doit décoder le fichier. Vous pouvez utiliser ce paramètre pour forcer AVISource à ouvrir le fichier AVI avec un codec différent de celui choisit par défaut. Une liste des FOURCC est disponible ici. Par défaut, c'est le  fourCC du fichier AVI ouvert qui sera utilisé.

Certains codecs MJPEG/DV ne fournissent pas une sortie comforme à la norme CCIR 601 en utilisant AVISource. Ce problème peut survenir si les formats de couleur en entrée et en sortie sont différents. Par exemple, si le format d'entrée est le YV12 alors que le format de sortie est le RGB, ou le contraire. Il y a deux manières de corriger cela:

1) Forcer le même format de couleur en sortie que celui en entrée. Par exemple (si le format de couleur d'entrée est le RGB):

AVISource("file.avi", type_de_pixel="RGB32")

2) Corriger avec le filtre ColorYUV:

AVISource("file.avi").ColorYUV(levels="PC->TV")

Voici deux liens(en anglais) qui font référence à ces problèmes:
MJPEG codecs
DV codecs

Exemples:

AVISource("d:\capture.avi")        # Note pour les programmeurs en C: les antislashs ne sont pas répétés deux fois
AVISource("c:/capture/00.avi")     # Les slashes marchent également
WAVSource("f:\soundtrack.wav")     # Cela marche
WAVSource("f:/soundtrack.wav")     # Cela aussi
AVISource("cap1.avi","cap2.avi")   # Identique à AVISource("cap1.avi")+AVISource("cap2.avi")
AVISource("cap.avi",false,"RGB32") # Désactive l'audio et demande une décompression dans le format de couleur RGB32
AVISource("cap.avi", false, fourCC="CDVC") # ouvre un fichier DV en utilisant le codec DV de Canopus
AVISource("cap.avi", false, fourCC="XVID") # ouvre un fichier AVI (par exemple DivX3) en utilisant le codec XviD

Changements:

v2.55 Ajout du paramètre fourCC.

$English date: 2005/08/11 21:11:50 $
First French translation by jernst. Last update: 2005/10/10 JasonFly macpaille@users.sourceforge.net