AviSource - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-17T07:57:41Z

add link to avs+ documentation

← Older revision		Revision as of 09: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.

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

2020-03-26T18:03:52Z

10+ bit inputs: Clarify formats availability

← Older revision		Revision as of 20:03, 26 March 2020
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.		: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		'pixel_type' Avs+ Format FourCC(s) for ICDecompressQuery
	YV24 YV24 *YV24		YV24 YV24 *YV24

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

2018-12-19T12:01:33Z

Syntax and Parameters: Add utf8 parameter

← Older revision		Revision as of 14:01, 19 December 2018
Line 12:		Line 12:

	== Syntax and Parameters ==		== Syntax and Parameters ==
	<div style="max-width:~~62em~~" >		<div style="max-width:68em" >
	{{Func3Def		{{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		{{FuncDef
	\|WavSource(string ''filename'' [, ...])		\|WavSource(string ''filename'' [, ...][, {{AvsPluscon}} bool "''utf8''"])
	}}		}}

	:{{Par2\|filename\|string\|}}		:{{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}}		:{{Par2\|audio\|bool\|true}}
Line 70:		Line 70:
	:{{Par2\|atrack\|int\|0}}		:{{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.		::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.

			:{{AvsPluscon}}
			:{{Par2\|utf8\|bool\|false}}
			::If true, file name is treated as utf8. Since r2768.

	</div>		</div>


	== Notes ==		== Notes ==

Pinterf: /* 10+ bit bit depths */

2018-07-02T09:52:11Z

10+ bit bit depths

← Older revision		Revision as of 11:52, 2 July 2018
Line 107:		Line 107:
	:If that does not work, try [[FFmpegSource]], [[LSMASHSource]] or (if absolutely necessary) [[DirectShowSource]].		:If that does not work, try [[FFmpegSource]], [[LSMASHSource]] or (if absolutely necessary) [[DirectShowSource]].

	==== 10+ bit ~~bit depths~~ ====		==== 10+ bit inputs ====
	{{AvsPluscon}}		{{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.		: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.

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

2018-07-02T09:51:34Z

Notes: new section for avs+ 10+ bits

@@ 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 ==

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

2018-07-02T09:43:50Z

Changes: avs+ allow 10+ bits

← Older revision		Revision as of 11:43, 2 July 2018
Line 171:		Line 171:
	== Changes ==		== Changes ==
	{\| border="1"		{\| border="1"
			\|-
			\| {{AvsPluscon}} r2724
			\| Added 10+ bits new color formats
	\|-		\|-
	\| v2.60		\| v2.60

Raffriff42: one more touch-up

2016-02-28T01:11:48Z

one more touch-up

← Older revision		Revision as of 03:11, 28 February 2016
Line 1:		Line 1:
			<div style="max-width:62em" >
	'''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 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>.		'''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>.
			</div>

	== Syntax and Parameters ==		== Syntax and Parameters ==
	{{~~Template:~~Func3Def		<div style="max-width:62em" >
			{{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''"])
	\|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''"])
Line 16:		Line 19:
	}}		}}

	{{~~Template:~~FuncDef		{{FuncDef
	\|WavSource(string ''filename'' [, ...])		\|WavSource(string ''filename'' [, ...])
	}}		}}
Line 67:		Line 70:
	:{{Par2\|atrack\|int\|0}}		:{{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.		::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.
			</div>


	== Notes ==		== Notes ==
			<div style="max-width:62em" >
	==== Joining clips ====		==== Joining clips ====

Line 106:		Line 111:
	*[http://forum.doom9.org/showthread.php?s=&postid=330657 MJPEG codecs]		*[http://forum.doom9.org/showthread.php?s=&postid=330657 MJPEG codecs]
	*[http://forum.doom9.org/showthread.php?s=&threadid=58110 DV codecs]		*[http://forum.doom9.org/showthread.php?s=&threadid=58110 DV codecs]
			</div>


	== Examples ==		== 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
			<div {{BoxWidthIndent\|48\|1}} >
	AVISource("d:\capture.avi")		AVISource("d:\capture.avi")
	WAVSource("f:/soundtrack.wav")		WAVSource("f:/soundtrack.wav")
			</div>

	# Splice two clips together; the following statements do the same thing.		* Splice two clips together; the following statements do the same thing.
			<div {{BoxWidthIndent\|48\|1}} >
	AviSource("cap1.avi") + AviSource("cap2.avi")		AviSource("cap1.avi") + AviSource("cap2.avi")
	AVISource("cap1.avi", "cap2.avi")		AVISource("cap1.avi", "cap2.avi")
			</div>

	# Splice two clips together where frame rates do not match.		* Splice two clips together where frame rates do not match.
			<div {{BoxWidthIndent\|48\|1}} >
	A = AviSource("FileA.avi") # "29.97" fps (30000/1001)		A = AviSource("FileA.avi") # "29.97" fps (30000/1001)
	B = AviSource("FileB.avi") # 30.0000 fps		B = AviSource("FileB.avi") # 30.0000 fps
	A ++ B.[[AssumeFPS]](A)		A ++ B.[[AssumeFPS]](A)
			</div>

	# Splice two clips together where one of them contains no audio.		* Splice two clips together where one of them contains no audio.
			<div {{BoxWidthIndent\|48\|1}} >
	A = AviSource("FileA.avi") # with audio		A = AviSource("FileA.avi") # with audio
	B = AviSource("FileB.avi") # no audio stream		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
			</div>

	# Disable audio and request RGB32 decompression		* Disable audio and request RGB32 decompression
			<div {{BoxWidthIndent\|48\|1}} >
	AVISource("cap.avi", ''audio''=false, ''pixel_type''="RGB32")		AVISource("cap.avi", ''audio''=false, ''pixel_type''="RGB32")
			</div>

	# Open a DV, forcing the Canopus DV Codec		* Open a DV, forcing the Canopus DV Codec
			<div {{BoxWidthIndent\|48\|1}} >
	AviSource("cap.avi", ''fourCC''="CDVC")		AviSource("cap.avi", ''fourCC''="CDVC")
			</div>

	# Open a file, forcing the [[Xvid\|XviD]] Codec		* Open a file, forcing the [[Xvid\|XviD]] Codec
			<div {{BoxWidthIndent\|48\|1}} >
	AviSource("cap.avi", ''fourCC''="XVID")		AviSource("cap.avi", ''fourCC''="XVID")
			</div>

	# 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
			<div {{BoxWidthIndent\|48\|1}} >
	Avisource("D:\Projects\test.avi", ''pixel_type''="+YV12")		Avisource("D:\Projects\test.avi", ''pixel_type''="+YV12")
			</div>

	# opens the first video and second audio stream of a clip		* opens the first video and second audio stream of a clip
			<div {{BoxWidthIndent\|48\|1}} >
	AviSource("D:\Projects\test_multi10.avi", ''vtrack''=0, ''atrack''=1)		AviSource("D:\Projects\test_multi10.avi", ''vtrack''=0, ''atrack''=1)
			</div>
			</div>

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

← Older revision		Revision as of 23:56, 1 February 2016
Line 101:		Line 101:
	:*If the video was encoded as [[YUV]], try {{FuncArg\|pixel_type}}="YV12", "YUY2" or "YV24".		:*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]].		:If that does not work, try [[FFmpegSource]], [[LSMASHSource]] or (if absolutely necessary) [[DirectShowSource]].

	*Unfortunately, the problem may be ''[[Wikipedia:DirectShow#Codec_hell\|codec hell]]'': the installed decoder for a given {{FuncArg\|fourCC}} is incompatible with the encoder that created the video. [[MJPEG]] is particularly problematic in this regard.

	==== More on codecs ====		==== More on codecs ====

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

2016-01-25T01:21:33Z

Helpful hints: codec hell; MJPEG

← Older revision		Revision as of 03:21, 25 January 2016
Line 101:		Line 101:
	:*If the video was encoded as [[YUV]], try {{FuncArg\|pixel_type}}="YV12", "YUY2" or "YV24".		:*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]].		:If that does not work, try [[FFmpegSource]], [[LSMASHSource]] or (if absolutely necessary) [[DirectShowSource]].

			*Unfortunately, the problem may be ''[[Wikipedia:DirectShow#Codec_hell\|codec hell]]'': the installed decoder for a given {{FuncArg\|fourCC}} is incompatible with the encoder that created the video. [[MJPEG]] is particularly problematic in this regard.

	==== More on codecs ====		==== More on codecs ====

Admin at 21:25, 21 January 2016

2016-01-21T21:25:14Z

← Older revision		Revision as of 23:25, 21 January 2016
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 ...		::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)}}		:{{Par2\|fourCC\|string\|(auto from source)}}
Line 126:		Line 126:
	A = AviSource("FileA.avi") # with audio		A = AviSource("FileA.avi") # with audio
	B = AviSource("FileB.avi") # no audio stream		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		# Disable audio and request RGB32 decompression
Line 137:		Line 137:
	AviSource("cap.avi", ''fourCC''="XVID")		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")		Avisource("D:\Projects\test.avi", ''pixel_type''="+YV12")