DirectShowSource - Revision history

172.56.152.236: mention how to use it with live capture

2024-07-17T00:09:54Z

mention how to use it with live capture

← Older revision		Revision as of 02:09, 17 July 2024
Line 7:		Line 7:


	'''DirectShowSource''' reads media files using Microsoft [[Wikipedia:DirectShow\|DirectShow]], the same multimedia playback system that WMP ''(Windows Media Player)'' uses. It can read most formats that WMP can, including MP4, MP3, most MOV (QuickTime) files, as well as AVI files that [[AviSource\|AVISource]] doesn't support (like DV type 1, or files using DirectShow-only codecs). There is also support for [[GraphEdit]] (grf) files.		'''DirectShowSource''' reads media files using Microsoft [[Wikipedia:DirectShow\|DirectShow]], the same multimedia playback system that WMP ''(Windows Media Player)'' uses. It can read most formats that WMP can, including MP4, MP3, most MOV (QuickTime) files, as well as AVI files that [[AviSource\|AVISource]] doesn't support (like DV type 1, or files using DirectShow-only codecs). There is also support for [[GraphEdit]] (grf) files, including live capture.

	There are some caveats:		There are some caveats:

Reel.Deal at 05:38, 18 September 2022

2022-09-18T05:38:41Z

← Older revision		Revision as of 07:38, 18 September 2022
Line 5:		Line 5:
	Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/directshowsource.html https://avisynthplus.readthedocs.io]		Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/directshowsource.html https://avisynthplus.readthedocs.io]
	</div>		</div>


	'''DirectShowSource''' reads media files using Microsoft [[Wikipedia:DirectShow\|DirectShow]], the same multimedia playback system that WMP ''(Windows Media Player)'' uses. It can read most formats that WMP can, including MP4, MP3, most MOV (QuickTime) files, as well as AVI files that [[AviSource\|AVISource]] doesn't support (like DV type 1, or files using DirectShow-only codecs). There is also support for [[GraphEdit]] (grf) files.		'''DirectShowSource''' reads media files using Microsoft [[Wikipedia:DirectShow\|DirectShow]], the same multimedia playback system that WMP ''(Windows Media Player)'' uses. It can read most formats that WMP can, including MP4, MP3, most MOV (QuickTime) files, as well as AVI files that [[AviSource\|AVISource]] doesn't support (like DV type 1, or files using DirectShow-only codecs). There is also support for [[GraphEdit]] (grf) files.

Reel.Deal: add link to avs+ documentation

2022-09-17T07:54:36Z

add link to avs+ documentation

← Older revision		Revision as of 09:54, 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/directshowsource.html https://avisynthplus.readthedocs.io]
			</div>

	'''DirectShowSource''' reads media files using Microsoft [[Wikipedia:DirectShow\|DirectShow]], the same multimedia playback system that WMP ''(Windows Media Player)'' uses. It can read most formats that WMP can, including MP4, MP3, most MOV (QuickTime) files, as well as AVI files that [[AviSource\|AVISource]] doesn't support (like DV type 1, or files using DirectShow-only codecs). There is also support for [[GraphEdit]] (grf) files.		'''DirectShowSource''' reads media files using Microsoft [[Wikipedia:DirectShow\|DirectShow]], the same multimedia playback system that WMP ''(Windows Media Player)'' uses. It can read most formats that WMP can, including MP4, MP3, most MOV (QuickTime) files, as well as AVI files that [[AviSource\|AVISource]] doesn't support (like DV type 1, or files using DirectShow-only codecs). There is also support for [[GraphEdit]] (grf) files.

Admin at 16:51, 24 July 2016

2016-07-24T16:51:30Z

← Older revision		Revision as of 18:51, 24 July 2016
Line 44:		Line 44:
	::If true, restrict backwards seeking only to the beginning, and seeking forwards is done the hard way (by reading all samples). Limited backwards seeking is allowed with non-indexed [http://en.wikipedia.org/wiki/Advanced_Systems_Format ASF].{{Dubious\|Talk:SegmentedAviSource}}		::If true, restrict backwards seeking only to the beginning, and seeking forwards is done the hard way (by reading all samples). Limited backwards seeking is allowed with non-indexed [http://en.wikipedia.org/wiki/Advanced_Systems_Format ASF].{{Dubious\|Talk:SegmentedAviSource}}

	:{{Par2\|timeout\|int~~\|2000~~}}		:{{Par2\|timeout\|int}}
	::For positive values DirectShowSource waits for up to {{FuncArg\|timeout}} milliseconds for the DirectShow graph to start. If the graph fails to start a compile time exception is thrown. Once the graph starts, each GetFrame/GetAudio call will wait for up to the timeout value and then return a grey frame or silence for the audio. No runtime exceptions are ever thrown because of time-outs.		::For positive values DirectShowSource waits for up to {{FuncArg\|timeout}} milliseconds for the DirectShow graph to start. {{FuncArg\|timeout}} is clamped between [5000,300000] milliseconds. If the graph fails to start a compile time exception is thrown. Once the graph starts, each GetFrame/GetAudio call will wait for up to the timeout value and then return a grey frame or silence for the audio. No runtime exceptions are ever thrown because of time-outs.
	::For negative values DirectShowSource waits for up to 2000 milliseconds for the DirectShow graph to start. If the graph fails to start it is ignored at that point and the initial graph start wait is deferred until the first GetFrame/GetAudio call. If any GetFrame/GetAudio call experiences a timeout a runtime exception is then thrown.		::For negative values DirectShowSource waits for up to 2000 milliseconds for the DirectShow graph to start. If the graph fails to start it is ignored at that point and the initial graph start wait is deferred until the first GetFrame/GetAudio call. If any GetFrame/GetAudio call experiences a timeout a runtime exception is then thrown.

Admin: timeout

2016-07-24T16:45:36Z

timeout

← Older revision		Revision as of 18:45, 24 July 2016
Line 45:		Line 45:

	:{{Par2\|timeout\|int\|2000}}		:{{Par2\|timeout\|int\|2000}}
	::~~Set time (in~~ milliseconds) to wait ~~when DirectShow refuses~~ to ~~render. When~~ the timeout ~~period has expired~~ and ~~the frame has not been rendered, AviSynth returns~~ a ~~blank~~ frame and/~~or silence~~. ~~Negative {{FuncArg\|~~timeout~~}} values will result in an error message~~.~~{{Dubious\|Talk:SegmentedAviSource}}~~		::For positive values DirectShowSource waits for up to {{FuncArg\|timeout}} milliseconds for the DirectShow graph to start. If the graph fails to start a compile time exception is thrown. Once the graph starts, each GetFrame/GetAudio call will wait for up to the timeout value and then return a grey frame or silence for the audio. No runtime exceptions are ever thrown because of time-outs.
			::For negative values DirectShowSource waits for up to 2000 milliseconds for the DirectShow graph to start. If the graph fails to start it is ignored at that point and the initial graph start wait is deferred until the first GetFrame/GetAudio call. If any GetFrame/GetAudio call experiences a timeout a runtime exception is then thrown.

	:{{Par2\|pixel_type\|string\|(auto)}}		:{{Par2\|pixel_type\|string\|(auto)}}

Raffriff42: one more touch-up

2016-02-28T01:47:30Z

one more touch-up

← Older revision		Revision as of 03:47, 28 February 2016
Line 1:		Line 1:
			<div style="max-width:62em" >
	'''DirectShowSource''' reads media files using Microsoft [[Wikipedia:DirectShow\|DirectShow]], the same multimedia playback system that WMP ''(Windows Media Player)'' uses. It can read most formats that WMP can, including MP4, MP3, most MOV (QuickTime) files, as well as AVI files that [[AviSource\|AVISource]] doesn't support (like DV type 1, or files using DirectShow-only codecs). There is also support for [[GraphEdit]] (grf) files.		'''DirectShowSource''' reads media files using Microsoft [[Wikipedia:DirectShow\|DirectShow]], the same multimedia playback system that WMP ''(Windows Media Player)'' uses. It can read most formats that WMP can, including MP4, MP3, most MOV (QuickTime) files, as well as AVI files that [[AviSource\|AVISource]] doesn't support (like DV type 1, or files using DirectShow-only codecs). There is also support for [[GraphEdit]] (grf) files.

Line 9:		Line 10:

	Try reading AVI files with [[AviSource]] first. For non-AVI files, try [[FFmpegSource]] or [[LSMASHSource]]. If that doesn't work then try this filter instead.		Try reading AVI files with [[AviSource]] first. For non-AVI files, try [[FFmpegSource]] or [[LSMASHSource]]. If that doesn't work then try this filter instead.
			</div>


Line 15:		Line 17:

	== Syntax and Parameters ==		== Syntax and Parameters ==
			<div style="max-width:62em" >
	{{Template:FuncDef		{{Template:FuncDef
	\|DirectShowSource(string ''filename'' [, float ''fps'', bool ''seek'', bool ''audio'', bool ''video'', <br>		\|DirectShowSource(string ''filename'' [, float ''fps'', bool ''seek'', bool ''audio'', bool ''video'', <br>
Line 126:		Line 129:
	::Add the values together of the data you need logged. Specify -1 to log everything.		::Add the values together of the data you need logged. Specify -1 to log everything.
	::The default, 35, logs 1+2+32, or Format Negotiation, Received samples and Errors.		::The default, 35, logs 1+2+32, or Format Negotiation, Received samples and Errors.
			</div>


	== Examples ==		== Examples ==
			<div style="max-width:62em" >
	Opens an AVI with the first available RGB format (without audio):		Opens an AVI with the first available RGB format (without audio):
	<div {{BoxWidthIndent\|56\|1}} >		<div {{BoxWidthIndent\|56\|1}} >
Line 157:		Line 162:

	See [[#Down-mixing_AC3_to_stereo\|below]] for an audio example.		See [[#Down-mixing_AC3_to_stereo\|below]] for an audio example.
			</div>


	== Troubleshooting video and audio problems ==		== Troubleshooting video and audio problems ==
			<div style="max-width:62em" >
	AviSynth will by default try to open only the media it can open without any problems. If one component cannot be opened it will simply not be added to the output. This will also mean that if there is a problem, you will not see the error. To get the error message to the missing component, use audio=false or video=false and disable the component that is actually working. This way AviSynth will print out the error message of the component that doesn't work.		AviSynth will by default try to open only the media it can open without any problems. If one component cannot be opened it will simply not be added to the output. This will also mean that if there is a problem, you will not see the error. To get the error message to the missing component, use audio=false or video=false and disable the component that is actually working. This way AviSynth will print out the error message of the component that doesn't work.

Line 197:		Line 203:

	Windows 7 forces its own DirectShow filters for decoding several audio and video formats. Changing their merits or physically removing those filters doesn't help. '''clsid''' made the tool "[http://forum.doom9.org/showthread.php?t=146910 Win7DSFilterTweaker]" to change the preferred filters. However new decoders need to be added each time so it's not the perfect solution.		Windows 7 forces its own DirectShow filters for decoding several audio and video formats. Changing their merits or physically removing those filters doesn't help. '''clsid''' made the tool "[http://forum.doom9.org/showthread.php?t=146910 Win7DSFilterTweaker]" to change the preferred filters. However new decoders need to be added each time so it's not the perfect solution.
			</div>


	== Common tasks ==		== Common tasks ==
			<div style="max-width:62em" >
	This section will describe various tasks that might not be 100% obvious. :)		This section will describe various tasks that might not be 100% obvious. :)

Line 264:		Line 271:

	For some reason, I {{Who}} can't get this to work with DTS streams :(		For some reason, I {{Who}} can't get this to work with DTS streams :(
			</div>


	== Changes ==		== Changes ==
			<div style="max-width:62em" >
	{\| border=1 cellspacing=1 cellpadding=4		{\| border=1 cellspacing=1 cellpadding=4
	\| v2.60		\| v2.60
Line 293:		Line 301:
	\| pixel_type specifies/restricts output video pixel format		\| pixel_type specifies/restricts output video pixel format
	\|}		\|}
			</div>


	== See also ==		== See also ==
			<div style="max-width:62em" >
	Haali media splitter also comes with an (unrelated) DirectShow input plugin [[External_filters#Source_Filters\|DirectShowSource2]], aka [[DSS2]]		Haali media splitter also comes with an (unrelated) DirectShow input plugin [[External_filters#Source_Filters\|DirectShowSource2]], aka [[DSS2]]
			</div>


	{{FilterCat\|Internal filters\|Media file filters\|Source_filters}}		{{FilterCat\|Internal filters\|Media file filters\|Source_filters}}

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

2016-02-01T21:52:02Z

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

← Older revision		Revision as of 23:52, 1 February 2016
Line 78:		Line 78:
	::In other words, if {{FuncArg\|pixel_type}}="AUTO", 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 {{FuncArg\|pixel_type}}="AUTO", 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>DirectShowSource(..., 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.		::For [[Planar\|planar]] color formats, adding a '''<tt>'+'</tt>''' prefix, ''e.g.'' <code>DirectShowSource(..., 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.

	:{{Par2\|framecount\|int\|(auto)}}		:{{Par2\|framecount\|int\|(auto)}}
Line 166:		Line 166:

	This is a common error that occurs when DirectShow isn't able to deliver any format that is readable to AviSynth. Try creating a filter graph manually and see if you are able to construct a filter graph that delivers any output AviSynth can open. If not, you might need to download additional DirectShow filters that can deliver correct material.		This is a common error that occurs when DirectShow isn't able to deliver any format that is readable to AviSynth. Try creating a filter graph manually and see if you are able to construct a filter graph that delivers any output AviSynth can open. If not, you might need to download additional DirectShow filters that can deliver correct material.

	~~=== The colors are wrong ===~~

	Unfortunately, the problem may be ''[[Wikipedia:DirectShow#Codec_hell\|codec hell]]'': the installed decoder for a given media type is incompatible with the encoder that created the video. [[MJPEG]] is particularly problematic in this regard. Try {{FuncArg\|pixel_type}}="RGB24" or "RGB32".

	=== The picture is skewed or torn and the colors are wrong ===		=== The picture is skewed or torn and the colors are wrong ===

Raffriff42: /* The colors are wrong */ codec hell

2016-01-25T01:39:08Z

The colors are wrong: codec hell

← Older revision		Revision as of 03:39, 25 January 2016
Line 166:		Line 166:

	This is a common error that occurs when DirectShow isn't able to deliver any format that is readable to AviSynth. Try creating a filter graph manually and see if you are able to construct a filter graph that delivers any output AviSynth can open. If not, you might need to download additional DirectShow filters that can deliver correct material.		This is a common error that occurs when DirectShow isn't able to deliver any format that is readable to AviSynth. Try creating a filter graph manually and see if you are able to construct a filter graph that delivers any output AviSynth can open. If not, you might need to download additional DirectShow filters that can deliver correct material.

			=== The colors are wrong ===

			Unfortunately, the problem may be ''[[Wikipedia:DirectShow#Codec_hell\|codec hell]]'': the installed decoder for a given media type is incompatible with the encoder that created the video. [[MJPEG]] is particularly problematic in this regard. Try {{FuncArg\|pixel_type}}="RGB24" or "RGB32".

	=== The picture is skewed or torn and the colors are wrong ===		=== The picture is skewed or torn and the colors are wrong ===

Raffriff42: bad codecs

2016-01-21T23:00:58Z

bad codecs

← Older revision		Revision as of 01:00, 22 January 2016
Line 78:		Line 78:
	::In other words, if {{FuncArg\|pixel_type}}="AUTO", 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 {{FuncArg\|pixel_type}}="AUTO", 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>DirectShowSource(..., 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>DirectShowSource(..., 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\|framecount\|int\|(auto)}}		:{{Par2\|framecount\|int\|(auto)}}

Admin at 21:56, 16 January 2016

2016-01-16T21:56:31Z

← Older revision		Revision as of 23:56, 16 January 2016
Line 66:		Line 66:
	\|}		\|}
	<div {{NotaBeneWidthIndent\|56\|5\|2px solid blue}} >		<div {{NotaBeneWidthIndent\|56\|5\|2px solid blue}} >
	By default, upstream DirectShow filters are free to bid all of their supported media types in the order of their choice. A few DirectShow filters get this wrong. The {{FuncArg\|pixel_type}} argument limits the acceptable video stream subformats for the [http://en.wikipedia.org/wiki/DirectShow#Architecture IPin negotiation]. Note the graph builder may add a format converter to satisfy your request, so make sure the codec in use can actually decode to your chosen format. The M$ format converter is just adequate. The "YUV" and "RGB" pseudo-types restrict the negotiation to all official supported YUV or RGB formats respectively. The "YUVex" also includes YV24, YV16, I420 and NV12 non-standard pixel types. The "AUTO" pseudo-type permits the negotiation to use all relevant official formats, YUV plus RGB. The "FULL" pseudo-type includes the non-standard pixel types in addition to those supported by "AUTO". The full order of preference is YV24, YV16, YV12, I420, NV12, YUY2, AYUV, Y41P, Y411, ARGB, RGB32, RGB24. Many DirectShow filters get this wrong, which is why it is not enabled by default. The option exists so you have enough control to encourage the maximum range of filters to serve your media. (See [http://forum.doom9.org/showthread.php?t=143321 discussion].)		By default, upstream DirectShow filters are free to bid all of their supported media types in the order of their choice. A few DirectShow filters get this wrong. The {{FuncArg\|pixel_type}} argument limits the acceptable video stream subformats for the [http://en.wikipedia.org/wiki/DirectShow#Architecture IPin negotiation]. Note the graph builder may add a format converter to satisfy your request, so make sure the codec in use can actually decode to your chosen format. The MS format converter is just adequate. The "YUV" and "RGB" pseudo-types restrict the negotiation to all official supported YUV or RGB formats respectively. The "YUVex" also includes YV24, YV16, I420 and NV12 non-standard pixel types. The "AUTO" pseudo-type permits the negotiation to use all relevant official formats, YUV plus RGB. The "FULL" pseudo-type includes the non-standard pixel types in addition to those supported by "AUTO". The full order of preference is YV24, YV16, YV12, I420, NV12, YUY2, AYUV, Y41P, Y411, ARGB, RGB32, RGB24. Many DirectShow filters get this wrong, which is why it is not enabled by default. The option exists so you have enough control to encourage the maximum range of filters to serve your media. (See [http://forum.doom9.org/showthread.php?t=143321 discussion].)

	The non-standard pixel types use the following GUID's respectively :-		The non-standard pixel types use the following GUID's respectively :-

← Older revision		Revision as of 18:45, 24 July 2016
Line 45:		Line 45:

	:{{Par2\|timeout\|int\|2000}}		:{{Par2\|timeout\|int\|2000}}
	::~~Set time (in~~ milliseconds) to wait ~~when DirectShow refuses~~ to ~~render. When~~ the timeout ~~period has expired~~ and ~~the frame has not been rendered, AviSynth returns~~ a ~~blank~~ frame and/~~or silence~~. ~~Negative {{FuncArg\|~~timeout~~}} values will result in an error message~~.~~{{Dubious\|Talk:SegmentedAviSource}}~~		::For positive values DirectShowSource waits for up to {{FuncArg\|timeout}} milliseconds for the DirectShow graph to start. If the graph fails to start a compile time exception is thrown. Once the graph starts, each GetFrame/GetAudio call will wait for up to the timeout value and then return a grey frame or silence for the audio. No runtime exceptions are ever thrown because of time-outs.
			::For negative values DirectShowSource waits for up to 2000 milliseconds for the DirectShow graph to start. If the graph fails to start it is ignored at that point and the initial graph start wait is deferred until the first GetFrame/GetAudio call. If any GetFrame/GetAudio call experiences a timeout a runtime exception is then thrown.

	:{{Par2\|pixel_type\|string\|(auto)}}		:{{Par2\|pixel_type\|string\|(auto)}}

← Older revision		Revision as of 01:00, 22 January 2016
Line 78:		Line 78:
	::In other words, if {{FuncArg\|pixel_type}}="AUTO", 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 {{FuncArg\|pixel_type}}="AUTO", 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>DirectShowSource(..., 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>DirectShowSource(..., 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\|framecount\|int\|(auto)}}		:{{Par2\|framecount\|int\|(auto)}}