AviSource - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-17T07:57:41Z

add link to avs+ documentation

Pinterf: /* 10+ bit inputs */ Clarify formats availability

2020-03-26T18:03:52Z

‎10+ bit inputs: Clarify formats availability

Pinterf: /* Syntax and Parameters */ Add utf8 parameter

2018-12-19T12:01:33Z

‎Syntax and Parameters: Add utf8 parameter

Pinterf: /* 10+ bit bit depths */

2018-07-02T09:52:11Z

‎10+ bit bit depths

Pinterf: /* Notes */ new section for avs+ 10+ bits

2018-07-02T09:51:34Z

‎Notes: new section for avs+ 10+ bits

Pinterf: /* Changes */ avs+ allow 10+ bits

2018-07-02T09:43:50Z

‎Changes: avs+ allow 10+ bits

Raffriff42: one more touch-up

2016-02-28T01:11:48Z

one more touch-up

Admin: Reverted edits by Raffriff42 (talk) to last revision by Admin

2016-02-01T21:56:58Z

Reverted edits by Raffriff42 (talk) to last revision by Admin

Raffriff42: /* Helpful hints */ codec hell; MJPEG

2016-01-25T01:21:33Z

‎Helpful hints: codec hell; MJPEG

Admin at 21:25, 21 January 2016

2016-01-21T21:25:14Z

← Older revision		Revision as of 07:57, 17 September 2022
Line 1:		Line 1:
	<div style="max-width:62em" >		<div style="max-width:62em" >
		+
		+	<div {{BlueBox2\|40\|0\|3px solid purple}} >
		+	{{AvsPlusFullname}}<br>
		+	Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/avisource.html https://avisynthplus.readthedocs.io]
		+	</div>
		+
	'''AviSource''' takes one or more files - not only [[AVI]] but also [[WAV]] (audio), [[AVS]] (AviSynth scripts), and [http://www.virtualdub.org/docs_frameserver.html VDR] ([[VirtualDub]] frameserver) files. There is built-in [http://en.wikipedia.org/wiki/Windows_legacy_audio_components#Audio_Compression_Manager ''Audio Compression Manager''] support for decoding compressed audio tracks (MP3, AAC, AC3, etc). If more than one file name is given, '''AviSource''' returns a clip with all files joined end to end. For the files to be joined, the media properties must be compatible - see [[#Notes\|Notes]] below.		'''AviSource''' takes one or more files - not only [[AVI]] but also [[WAV]] (audio), [[AVS]] (AviSynth scripts), and [http://www.virtualdub.org/docs_frameserver.html VDR] ([[VirtualDub]] frameserver) files. There is built-in [http://en.wikipedia.org/wiki/Windows_legacy_audio_components#Audio_Compression_Manager ''Audio Compression Manager''] support for decoding compressed audio tracks (MP3, AAC, AC3, etc). If more than one file name is given, '''AviSource''' returns a clip with all files joined end to end. For the files to be joined, the media properties must be compatible - see [[#Notes\|Notes]] below.

@@ Line 117: / Line 117: @@
 :The 'FourCCs for ICDecompressQuery' column means that when a codec supports the format, it will serve the frame in that one, Avisource then will convert it to the proper colorspace.
-   Full support list (* only supported prior to 2724):
+   Full support list. Non *-marked formats (FourCC column) are supported since r2724.
    'pixel_type' Avs+ Format   FourCC(s) for ICDecompressQuery
    YV24         YV24          *YV24

@@ Line 12: / Line 12: @@
 == Syntax and Parameters ==
-<div style="max-width:62em" >
+<div style="max-width:68em" >
 {{Func3Def
-|AviSource(string ''filename'' [, ...] [, bool "''audio''", string "''pixel_type''", string "''fourCC''", int "''vtrack''", int "''atrack''"])
+|AviSource(string ''filename'' [, ...] [, bool "''audio''", string "''pixel_type''", string "''fourCC''", int "''vtrack''", int "''atrack''", {{AvsPluscon}} bool "''utf8''"])
-|AviFileSource(string ''filename'' [, ...] [, bool "''audio''", string "''pixel_type''", string "''fourCC''", int "''vtrack''", int "''atrack''"])
+|AviFileSource(string ''filename'' [, ...] [, bool "''audio''", string "''pixel_type''", string "''fourCC''", int "''vtrack''", int "''atrack''", {{AvsPluscon}} bool "''utf8''"])
-|OpenDMLSource(string ''filename'' [, ...] [, bool "''audio''", string "''pixel_type''", string "''fourCC''", int "''vtrack''", int "''atrack''"])
+|OpenDMLSource(string ''filename'' [, ...] [, bool "''audio''", string "''pixel_type''", string "''fourCC''", int "''vtrack''", int "''atrack''", {{AvsPluscon}} bool "''utf8''"])
 }}
 {{FuncDef
-|WavSource(string ''filename'' [, ...])
+|WavSource(string ''filename'' [, ...][, {{AvsPluscon}} bool "''utf8''"])
 }}
 :{{Par2|filename|string|}}
-::One or more file names. The files will be joined into a single clip with [[Splice|UnalignedSplice]]. To join files, the media properties must be compatible - see [[#Notes|Notes]] below.
+::One or more file names. The files will be joined into a single clip with [[Splice|UnalignedSplice]]. To join files, the media properties must be compatible - see [[#Notes|Notes]] below. {{AvsPluscon}} utf8 file names are supported since Avs+r2768.
 :{{Par2|audio|bool|true}}
@@ Line 70: / Line 70: @@
 :{{Par2|atrack|int|0}}
 ::Specifies a numbered audio track. Track numbers start from zero, and are guaranteed to be continuous (i.e. there must be a track ''1'' if there is a track 0 and a track ''2''). If no audio stream numbered {{FuncArg|atrack}} exists, no error will be raised, and no audio will be returned.
 == Notes ==

@@ Line 107: / Line 107: @@
 :If that does not work, try [[FFmpegSource]], [[LSMASHSource]] or (if absolutely necessary) [[DirectShowSource]].
-==== 10+ bit bit depths ====
+==== 10+ bit inputs ====
 {{AvsPluscon}}
 :When a classic 'pixel_type' shares more internal formats (such as YUV422P10 first tries to request the v210 then P210 format) you can specify one of the specific format directly. Note that high bit-depth RGBP (Planar RGB) is prioritized against packed RGB48/64.

@@ Line 106: / Line 106: @@
 :*If the video was encoded as [[YUV]], try {{FuncArg|pixel_type}}="YV12", "YUY2" or "YV24".
 :If that does not work, try [[FFmpegSource]], [[LSMASHSource]] or (if absolutely necessary) [[DirectShowSource]].
 ==== More on codecs ====
@@ Line 112: / Line 158: @@
 *[http://forum.doom9.org/showthread.php?s=&threadid=58110 DV codecs]
 </div>
 == Examples ==

@@ Line 171: / Line 171: @@
 == Changes ==
 {| border="1"
 |-
 | v2.60

@@ Line 1: / Line 1: @@
 '''AviSource''' takes one or more files - not only [[AVI]] but also [[WAV]] (audio), [[AVS]] (AviSynth scripts), and [http://www.virtualdub.org/docs_frameserver.html VDR] ([[VirtualDub]] frameserver) files. There is built-in [http://en.wikipedia.org/wiki/Windows_legacy_audio_components#Audio_Compression_Manager ''Audio Compression Manager''] support for decoding compressed audio tracks (MP3, AAC, AC3, etc). If more than one file name is given, '''AviSource''' returns a clip with all files joined end to end. For the files to be joined, the media properties must be compatible - see [[#Notes|Notes]] below.
@@ Line 8: / Line 9: @@
 '''WavSource''' will open a [[WAV]] file, or an audio-only AVI file. It will also return the audio stream from a normal video+audio AVI. This might be useful if your video stream is damaged or unreadable, or simply as a shortcut for<tt> AviSource(</tt>...<tt>).[[KillVideo]]</tt>.
 == Syntax and Parameters ==
-{{Template:Func3Def
+<div style="max-width:62em" >
 |AviSource(string ''filename'' [, ...] [, bool "''audio''", string "''pixel_type''", string "''fourCC''", int "''vtrack''", int "''atrack''"])
 |AviFileSource(string ''filename'' [, ...] [, bool "''audio''", string "''pixel_type''", string "''fourCC''", int "''vtrack''", int "''atrack''"])
@@ Line 16: / Line 19: @@
 }}
-{{Template:FuncDef
+{{FuncDef
 |WavSource(string ''filename'' [, ...])
 }}
@@ Line 67: / Line 70: @@
 :{{Par2|atrack|int|0}}
 ::Specifies a numbered audio track. Track numbers start from zero, and are guaranteed to be continuous (i.e. there must be a track ''1'' if there is a track 0 and a track ''2''). If no audio stream numbered {{FuncArg|atrack}} exists, no error will be raised, and no audio will be returned.
 == Notes ==
 ==== Joining clips ====
@@ Line 106: / Line 111: @@
 *[http://forum.doom9.org/showthread.php?s=&postid=330657 MJPEG codecs]
 *[http://forum.doom9.org/showthread.php?s=&threadid=58110 DV codecs]
 == Examples ==
+<div style="max-width:62em" >
- # C programmers note: backslashes are not doubled; forward slashes work too
+* C programmers note: backslashes are not doubled; forward slashes work too
   AVISource("d:\capture.avi")
   WAVSource("f:/soundtrack.wav")
- # Splice two clips together; the following statements do the same thing.
+* Splice two clips together; the following statements do the same thing.
   AviSource("cap1.avi") + AviSource("cap2.avi")
   AVISource("cap1.avi", "cap2.avi")
- # Splice two clips together where frame rates do not match.
+* Splice two clips together where frame rates do not match.
   A = AviSource("FileA.avi") # "29.97" fps (30000/1001)
   B = AviSource("FileB.avi") # 30.0000 fps
   A ++ B.[[AssumeFPS]](A)
- # Splice two clips together where one of them contains no audio.
+* Splice two clips together where one of them contains no audio.
   A = AviSource("FileA.avi") # with audio
   B = AviSource("FileB.avi") # no audio stream
   A ++ [[AudioDub]](B, [[BlankClip]](A)) # insert silent audio with same format
- # Disable audio and request RGB32 decompression
+* Disable audio and request RGB32 decompression
   AVISource("cap.avi", ''audio''=false, ''pixel_type''="RGB32")
- # Open a DV, forcing the Canopus DV Codec
+* Open a DV, forcing the Canopus DV Codec
   AviSource("cap.avi", ''fourCC''="CDVC")
- # Open a file, forcing the [[Xvid|XviD]] Codec
+* Open a file, forcing the [[Xvid|XviD]] Codec
   AviSource("cap.avi", ''fourCC''="XVID")
- # Open a YV12 video with a bad codec where the width is not a multiple of four
+* Open a YV12 video with a bad codec where the width is not a multiple of four
   Avisource("D:\Projects\test.avi", ''pixel_type''="+YV12")
- # opens the first video and second audio stream of a clip
+* opens the first video and second audio stream of a clip
   AviSource("D:\Projects\test_multi10.avi", ''vtrack''=0, ''atrack''=1)

@@ Line 57: / Line 57: @@
 ::In other words, if you don't specify anything, it will try to output [[YV24]]; if that isn't possible it tries [[YV16]], and if that isn't possible it tries [[YV12]], etc ...
-::For [[Planar|planar]] color formats, adding a '''<tt>'+'</tt>''' prefix, ''e.g.'' <code>AviSource(..., pixel_type="'''+'''YV12")</code>, tells AviSynth the video rows are DWORD aligned in memory instead of packed. '''This can fix skew or tearing of the decoded video''' when the width of the picture is not divisible by 4.
+::For [[Planar|planar]] color formats, adding a '''<tt>'+'</tt>''' prefix, ''e.g.'' <code>AviSource(..., pixel_type="'''+'''YV12")</code>, tells AviSynth the video rows are DWORD aligned in memory instead of packed. '''This can fix skew or tearing of the decoded video''' with bad codecs when the width of the picture is not divisible by 4.
 :{{Par2|fourCC|string|(auto from source)}}
@@ Line 126: / Line 126: @@
   A = AviSource("FileA.avi") # with audio
   B = AviSource("FileB.avi") # no audio stream
-  A ++ [[AudioDub]]B, [[BlankClip]](A)) # insert silent audio with same format
+  A ++ [[AudioDub]](B, [[BlankClip]](A)) # insert silent audio with same format
   # Disable audio and request RGB32 decompression
@@ Line 137: / Line 137: @@
   AviSource("cap.avi", ''fourCC''="XVID")
-  # Open a YV12 video where the width is not a multiple of four
+  # Open a YV12 video with a bad codec where the width is not a multiple of four
   Avisource("D:\Projects\test.avi", ''pixel_type''="+YV12")