LSMASHSource/LWLibavVideoSource - Revision history

JamesJohnston: Add note stating that FPS must be explicitly set when working with AVI files that have null/drop frames

2024-08-04T04:35:20Z

Add note stating that FPS must be explicitly set when working with AVI files that have null/drop frames

← Older revision		Revision as of 06:35, 4 August 2024
Line 62:		Line 62:
	:::If frame rate is set to a positive value, output frame rate is forced to the specified value by padding and/or dropping frames.		:::If frame rate is set to a positive value, output frame rate is forced to the specified value by padding and/or dropping frames.
	:::Otherwise, output frame rate is set to a computed average frame rate and the output process is performed by actual frame-by-frame.		:::Otherwise, output frame rate is set to a computed average frame rate and the output process is performed by actual frame-by-frame.
			:::<br>
			:::NOTE: You must explicitly set this if the source is an AVI file that contains null/drop frames that you would like to keep. For example, AVI files captured using VirtualDub commonly contain null/drop frames that were inserted during the capture process. Unless you provide this parameter, these null frames will be discarded, commonly resulting in loss of audio/video sync.
	<br>		<br>
	::{{Par2\|fpsden\|int\|1}}		::{{Par2\|fpsden\|int\|1}}

Reel.Deal: Add colorspaces with alpha channel supported in version 20200726

2020-07-29T21:41:48Z

Add colorspaces with alpha channel supported in version 20200726

@@ Line 122: / Line 122: @@
 |-
 |"YUV420P12"
-|12-bit 4:2:0 planar - (ffmpeg only)
+|12-bit 4:2:0 planar
 |-
 |"YUV422P12"
-|12-bit 4:2:2 planar - (ffmpeg only)
+|12-bit 4:2:2 planar
 |-
 |"YUV444P12"
-|12-bit 4:4:4 planar - (ffmpeg only)
+|12-bit 4:4:4 planar
 |-
 |"YUV420P14"
-|14-bit 4:2:0 planar - (ffmpeg only)
+|14-bit 4:2:0 planar
 |-
 |"YUV422P14"
-|14-bit 4:2:2 planar - (ffmpeg only)
+|14-bit 4:2:2 planar
 |-
 |"YUV444P14"
-|14-bit 4:4:4 planar - (ffmpeg only)
+|14-bit 4:4:4 planar
 |-
 |"YUV420P16"
@@ Line 147: / Line 147: @@
 |"YUV444P16"
 |16-bit 4:4:4 planar
 |-
 |"Y8"
@@ Line 170: / Line 206: @@
 |-
 |"RGB48"
-|16-bit RGB / 4:4:4:4 interleaved
+|16-bit RGB / 4:4:4 interleaved
 |-
 ! colspan="2"| High bit depth is only supported in AviSynth+ and VapourSynth

Reel.Deal: Update docs to match latest version (20200322). Removed "stacked" parameter and add "cachefile", "prefer_hw", and "ff_loglevel" parameters.

2020-03-30T14:36:55Z

Update docs to match latest version (20200322). Removed "stacked" parameter and add "cachefile", "prefer_hw", and "ff_loglevel" parameters.

← Older revision		Revision as of 16:36, 30 March 2020
Line 5:		Line 5:
	<br>		<br>
	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\|LWLibavVideoSource (string source, int "stream_index", int "threads", bool "cache", int "seek_mode", int "seek_threshold", bool "dr", int "fpsnum", int "fpsden", bool "repeat", int "dominance", ~~bool~~ "~~stacked~~", string "~~format~~", ~~string~~ "~~decoder~~")}}		:{{Template:FuncDef\|LWLibavVideoSource (string source, int "stream_index", int "threads", bool "cache", string "cachefile", int "seek_mode", int "seek_threshold", bool "dr", int "fpsnum", int "fpsden", bool "repeat", int "dominance", string "format", string "decoder", int "prefer_hw", int "ff_loglevel")}}
	<br>		<br>
	::{{Par2\|source\|string\| }}		::{{Par2\|source\|string\| }}
Line 21:		Line 21:
	:::The index file avoids parsing all frames in the source file at the next or later access.		:::The index file avoids parsing all frames in the source file at the next or later access.
	:::Parsing all frames is very important for frame accurate seek.		:::Parsing all frames is very important for frame accurate seek.
			<br>
			::{{Par2\|cachefile\|string\|source + ".lwi"}}
			:::The filename of the index file (where the indexing data is saved).
	<br>		<br>
	::{{Par2\|seek_mode\|int\|0}}		::{{Par2\|seek_mode\|int\|0}}
Line 66:		Line 69:
	::{{Par2\|repeat\|bool\|false}}		::{{Par2\|repeat\|bool\|false}}
	:::Reconstruct frames by the flags specified in video stream and then treat all frames as interlaced if set to true and usable.		:::Reconstruct frames by the flags specified in video stream and then treat all frames as interlaced if set to true and usable.
			:::Note that this option is ignored when VFR->CFR conversion is enabled.
	<br>		<br>
	::{{Par2\|dominance\|int\|0}}		::{{Par2\|dominance\|int\|0}}
Line 75:		Line 79:
	::::- 'repeat' is set to true.		::::- 'repeat' is set to true.
	::::- There is a video frame consisting of two separated field coded pictures		::::- There is a video frame consisting of two separated field coded pictures
	~~<br>~~
	~~::{{Par2\|stacked\|bool\|false}}~~
	~~:::Use the stacked format for a hack of AviSynth high bit-depth support if set to true.~~
	~~:::Note: direct rendering is not available at all if stacked format is used.~~
	~~:::The stacked format splits MSB and LSB vertically, and MSB comes on top of output image.~~
	~~:::(see [[#Examples\|Examples]] section below)~~
	<br>		<br>
	::{{Par2\|format\|string\|""}}		::{{Par2\|format\|string\|""}}
Line 152:		Line 150:
	\|"Y8"		\|"Y8"
	\|[[Y8]] / Grayscale		\|[[Y8]] / Grayscale
			\|-
			\|"Y10"
			\|10-bit grayscale (ffmpeg only)
			\|-
			\|"Y12"
			\|12-bit grayscale
			\|-
			\|"Y16"
			\|16-bit grayscale
	\|-		\|-
	\|"YUY2"		\|"YUY2"
Line 162:		Line 169:
	\|[[RGB32]] / 4:4:4:4 interleaved		\|[[RGB32]] / 4:4:4:4 interleaved
	\|-		\|-
	! colspan="2"\| *YV12, YV16 and ~~YV24 allow bit depths greater than 8.~~		\|"RGB48"
			\|16-bit RGB / 4:4:4:4 interleaved
			\|-
			! colspan="2"\| High bit depth is only supported in AviSynth+ and VapourSynth
	\|}		\|}
	:::Note: direct rendering is not available at all if pixel format is forced.		:::Note: direct rendering is not available at all if pixel format is forced.
Line 168:		Line 178:
	::{{Par2\|decoder\|string\|""}}		::{{Par2\|decoder\|string\|""}}
	:::Names of preferred decoder candidates, separated by comma. For instance, if you prefer to use the 'h264_qsv' and 'mpeg2_qsv' decoders instead of the generally used 'h264' and 'mpeg2video' decoder, then specify as "h264_qsv,mpeg2_qsv". The evaluations are done in the written order and the first matched decoder, if any, is used.		:::Names of preferred decoder candidates, separated by comma. For instance, if you prefer to use the 'h264_qsv' and 'mpeg2_qsv' decoders instead of the generally used 'h264' and 'mpeg2video' decoder, then specify as "h264_qsv,mpeg2_qsv". The evaluations are done in the written order and the first matched decoder, if any, is used.
			<br>
			::{{Par2\|ff_loglevel\|int\|0}}
			:::Set the log level in FFmpeg.
			:::* 0 : AV_LOG_QUIET - Print no output.
			:::* 1 : AV_LOG_PANIC - Something went really wrong and we will crash now.
			:::* 2 : AV_LOG_FATAL - Something went wrong and recovery is not possible.
			:::* 3 : AV_LOG_ERROR - Something went wrong and cannot losslessly be recovered. However, not all future data is affected.
			:::* 4 : AV_LOG_WARNING - Something somehow does not look correct. This may or may not lead to problems.
			:::* 5 : AV_LOG_INFO - Standard information.
			:::* 6 : AV_LOG_VERBOSE - Detailed information.
			:::* 7 : AV_LOG_DEBUG - Stuff which is only useful for libav* developers.
			:::* 8 : AV_LOG_TRACE - Extremely verbose debugging, useful for libav* development.
			<br>
	</div>		</div>

Line 175:		Line 198:
	## LWLibavVideoSource with default settings:		## LWLibavVideoSource with default settings:
	'''LWLibavVideoSource'''("source.m2ts", stream_index=-1, threads=0,		'''LWLibavVideoSource'''("source.m2ts", stream_index=-1, threads=0,
	\ cache=true, seek_mode=0, seek_threshold=10, dr=false,		\ cache=true, cachefile="source.lwi" seek_mode=0, seek_threshold=10,
	\ fpsnum=0, fpsden=1, repeat=false, dominance=0~~, stacked=false~~,		\ dr=false, fpsnum=0, fpsden=1, repeat=false, dominance=0,
	\ format="", decoder="")		\ format="", decoder="", prefer_hw=0, ff_loglevel=0)
	</div>		</div>
	<div {{BoxWidthIndent\|56\|1}} >		<div {{BoxWidthIndent\|56\|1}} >
	## Decoding 10bit, YUV 4:2:0 source		## Decoding 10bit, YUV 4:2:0 source and converting to 8-bit.
	'''LWLibavVideoSource'''(<''path''>~~, stacked=true~~, format="YUV420P10")		'''LWLibavVideoSource'''(<''path''>, format="YUV420P10")
	~~[[ConvertFromStacked]](bits=10~~)
	[[ConvertBits]](8, dither=0) ## '0' means on, '-1' means off		[[ConvertBits]](8, dither=0) ## '0' means on, '-1' means off
	</div>		</div>

Raffriff42: format example

2018-01-22T00:30:29Z

format example

← Older revision		Revision as of 02:30, 22 January 2018
Line 1:		Line 1:
			<div style="max-width:62em" >
	{{FilterCat\|External_filters\|Plugin_functions\|Source_filters}}		{{FilterCat\|External_filters\|Plugin_functions\|Source_filters}}
	This function uses [http://en.wikipedia.org/wiki/Libav#Video_codecs libavcodec] as a video decoder and libavformat as a demuxer.		This function uses [http://en.wikipedia.org/wiki/Libav#Video_codecs libavcodec] as a video decoder and libavformat as a demuxer.
Line 32:		Line 33:
	::::*2 : Aggressive		::::*2 : Aggressive
	:::::This mode returns the last returned frame when any fatal decoding error occurs.		:::::This mode returns the last returned frame when any fatal decoding error occurs.
	~~<br>~~
	::: * RAP is an abbreviation of random accessible point.		::: * RAP is an abbreviation of random accessible point.
	<br>		<br>
Line 80:		Line 80:
	:::Note: direct rendering is not available at all if stacked format is used.		:::Note: direct rendering is not available at all if stacked format is used.
	:::The stacked format splits MSB and LSB vertically, and MSB comes on top of output image.		:::The stacked format splits MSB and LSB vertically, and MSB comes on top of output image.
	~~<div {{BoxWidthIndent\|46\|6}} >~~		:::(see [[#Examples\|Examples]] section below)
	~~## Decoding 10bit, YUV 4~~:2:~~0 source~~
	~~'''LWLibavVideoSource'''~~(~~<''path''>, stacked=true, format="YUV420P10")~~
	[[~~ConvertFromStacked~~]]~~(bits=10~~)
	~~[[ConvertBits]](8, dither=0) ## '0' means on, '-1' means off~~
	~~</div>~~
	<br>		<br>
	::{{Par2\|format\|string\|""}}		::{{Par2\|format\|string\|""}}
Line 172:		Line 167:
	<br>		<br>
	::{{Par2\|decoder\|string\|""}}		::{{Par2\|decoder\|string\|""}}
	:::~~Same as~~ '~~decoder~~' of ~~[[LSMASHSource/LSMASHVideoSource\|LSMASHVideoSource]]~~.		:::Names of preferred decoder candidates, separated by comma. For instance, if you prefer to use the 'h264_qsv' and 'mpeg2_qsv' decoders instead of the generally used 'h264' and 'mpeg2video' decoder, then specify as "h264_qsv,mpeg2_qsv". The evaluations are done in the written order and the first matched decoder, if any, is used.
	<br>		</div>

	== Examples ==		== Examples ==
	LWLibavVideoSource with default settings:		<div style="max-width:62em" >
	LWLibavVideoSource(~~source=~~"source.m2ts", stream_index=-1, threads=0,		<div {{BoxWidthIndent\|56\|1}} >
			## LWLibavVideoSource with default settings:
			'''LWLibavVideoSource'''("source.m2ts", stream_index=-1, threads=0,
	\ cache=true, seek_mode=0, seek_threshold=10, dr=false,		\ cache=true, seek_mode=0, seek_threshold=10, dr=false,
	\ fpsnum=0, fpsden=1, repeat=false, dominance=0, stacked=false,		\ fpsnum=0, fpsden=1, repeat=false, dominance=0, stacked=false,
	\ format="", decoder="")		\ format="", decoder="")
	<br>		</div>
	<br>		<div {{BoxWidthIndent\|56\|1}} >
			## Decoding 10bit, YUV 4:2:0 source
			'''LWLibavVideoSource'''(<''path''>, stacked=true, format="YUV420P10")
			[[ConvertFromStacked]](bits=10)
			[[ConvertBits]](8, dither=0) ## '0' means on, '-1' means off
			</div>
			</div>

	-----------------------------------------------		-----------------------------------------------
	'''Back to [[LSMASHSource]] ←'''		'''Back to [[LSMASHSource]] ←'''

Raffriff42: "stacked" argument: add example

2018-01-22T00:19:18Z

"stacked" argument: add example

← Older revision		Revision as of 02:19, 22 January 2018
Line 78:		Line 78:
	::{{Par2\|stacked\|bool\|false}}		::{{Par2\|stacked\|bool\|false}}
	:::Use the stacked format for a hack of AviSynth high bit-depth support if set to true.		:::Use the stacked format for a hack of AviSynth high bit-depth support if set to true.
	~~:::The stacked format splits MSB and LSB into vertically, and MSB comes on top of output image.~~
	:::Note: direct rendering is not available at all if stacked format is used.		:::Note: direct rendering is not available at all if stacked format is used.
			:::The stacked format splits MSB and LSB vertically, and MSB comes on top of output image.
			<div {{BoxWidthIndent\|46\|6}} >
			## Decoding 10bit, YUV 4:2:0 source
			'''LWLibavVideoSource'''(<''path''>, stacked=true, format="YUV420P10")
			[[ConvertFromStacked]](bits=10)
			[[ConvertBits]](8, dither=0) ## '0' means on, '-1' means off
			</div>
	<br>		<br>
	::{{Par2\|format\|string\|""}}		::{{Par2\|format\|string\|""}}

Raffriff42: v901 changes

2016-08-15T01:12:25Z

v901 changes

← Older revision		Revision as of 03:12, 15 August 2016
Line 4:		Line 4:
	<br>		<br>
	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\|LWLibavVideoSource (string source, int "stream_index", int "threads", bool "cache", int "seek_mode", int "seek_threshold", bool "dr", int "fpsnum", int "fpsden", bool "repeat", int "dominance", bool "stacked", string "format")}}		:{{Template:FuncDef\|LWLibavVideoSource (string source, int "stream_index", int "threads", bool "cache", int "seek_mode", int "seek_threshold", bool "dr", int "fpsnum", int "fpsden", bool "repeat", int "dominance", bool "stacked", string "format", string "decoder")}}
	<br>		<br>
	::{{Par2\|source\|string\| }}		::{{Par2\|source\|string\| }}
Line 164:		Line 164:
	\|}		\|}
	:::Note: direct rendering is not available at all if pixel format is forced.		:::Note: direct rendering is not available at all if pixel format is forced.
			<br>
			::{{Par2\|decoder\|string\|""}}
			:::Same as 'decoder' of [[LSMASHSource/LSMASHVideoSource\|LSMASHVideoSource]].
	<br>		<br>

Line 170:		Line 173:
	LWLibavVideoSource(source="source.m2ts", stream_index=-1, threads=0,		LWLibavVideoSource(source="source.m2ts", stream_index=-1, threads=0,
	\ cache=true, seek_mode=0, seek_threshold=10, dr=false,		\ cache=true, seek_mode=0, seek_threshold=10, dr=false,
	\ fpsnum=0, fpsden=1, repeat=false, dominance=0, stacked=false, format="")		\ fpsnum=0, fpsden=1, repeat=false, dominance=0, stacked=false,
			\ format="", decoder="")
	<br>		<br>
	<br>		<br>
	-----------------------------------------------		-----------------------------------------------
	'''Back to [[LSMASHSource]] ←'''		'''Back to [[LSMASHSource]] ←'''

Reel.Deal: heading

2015-12-23T13:39:02Z

heading

← Older revision		Revision as of 15:39, 23 December 2015
Line 1:		Line 1:
	{{FilterCat\|External_filters\|Plugin_functions\|Source_filters}}		{{FilterCat\|External_filters\|Plugin_functions\|Source_filters}}

	~~'''Back to [[LSMASHSource]] ←'''~~
	~~-----------------------------------------------~~
	~~<br>~~
	~~== Description ==~~
	This function uses [http://en.wikipedia.org/wiki/Libav#Video_codecs libavcodec] as a video decoder and libavformat as a demuxer.		This function uses [http://en.wikipedia.org/wiki/Libav#Video_codecs libavcodec] as a video decoder and libavformat as a demuxer.
	<br>		<br>

Reel.Deal: update to coincide with r748

2014-12-25T00:38:11Z

update to coincide with r748

← Older revision		Revision as of 02:38, 25 December 2014
Line 9:		Line 9:
	<br>		<br>
	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\|LWLibavVideoSource (string source, int "stream_index", int "threads", bool "cache", int "seek_mode", int "seek_threshold", bool "dr", bool "repeat", int "dominance", bool "stacked", string "format")}}		:{{Template:FuncDef\|LWLibavVideoSource (string source, int "stream_index", int "threads", bool "cache", int "seek_mode", int "seek_threshold", bool "dr", int "fpsnum", int "fpsden", bool "repeat", int "dominance", bool "stacked", string "format")}}
	<br>		<br>
	::{{Par2\|source\|string\| }}		::{{Par2\|source\|string\| }}
Line 59:		Line 59:
	:::The output resolution will be aligned to be mod16-width and mod32-height by assuming two vertical 16x16 macroblock.		:::The output resolution will be aligned to be mod16-width and mod32-height by assuming two vertical 16x16 macroblock.
	:::For H.264 streams, in addition, 2 lines could be added because of the optimized chroma MC.		:::For H.264 streams, in addition, 2 lines could be added because of the optimized chroma MC.
			<br>
			::{{Par2\|fpsnum\|int\|0}}
			:::Forced frame rate numerator.
			:::If frame rate is set to a positive value, output frame rate is forced to the specified value by padding and/or dropping frames.
			:::Otherwise, output frame rate is set to a computed average frame rate and the output process is performed by actual frame-by-frame.
			<br>
			::{{Par2\|fpsden\|int\|1}}
			:::Forced frame rate denominator.
			:::See 'fpsnum' in details.
	<br>		<br>
	::{{Par2\|repeat\|bool\|false}}		::{{Par2\|repeat\|bool\|false}}
Line 166:		Line 175:
	LWLibavVideoSource(source="source.m2ts", stream_index=-1, threads=0,		LWLibavVideoSource(source="source.m2ts", stream_index=-1, threads=0,
	\ cache=true, seek_mode=0, seek_threshold=10, dr=false,		\ cache=true, seek_mode=0, seek_threshold=10, dr=false,
	\ repeat=false, dominance=0, stacked=false, format="")		\ fpsnum=0, fpsden=1, repeat=false, dominance=0, stacked=false, format="")
	<br>		<br>
	<br>		<br>
	-----------------------------------------------		-----------------------------------------------
	'''Back to [[LSMASHSource]] ←'''		'''Back to [[LSMASHSource]] ←'''

Reel.Deal: minor formatting

2014-09-21T08:45:08Z

minor formatting

← Older revision		Revision as of 10:45, 21 September 2014
Line 1:		Line 1:
	~~[[Category:Plugin_Filters]]~~		{{FilterCat\|External_filters\|Plugin_functions\|Source_filters}}
	~~[[Category:Source_filters]]~~
	'''Back to [[LSMASHSource]] ←'''		'''Back to [[LSMASHSource]] ←'''
	-----------------------------------------------		-----------------------------------------------
	<br>		<br>
			== Description ==
			This function uses [http://en.wikipedia.org/wiki/Libav#Video_codecs libavcodec] as a video decoder and libavformat as a demuxer.
	<br>		<br>
	~~== Description ==~~
	~~:This function uses [http://en.wikipedia.org/wiki/Libav#Video_codecs libavcodec] as a video decoder and libavformat as a demuxer.~~
	<br>		<br>

	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\|LWLibavVideoSource (string source, int "stream_index", int "threads", bool "cache", int "seek_mode", int "seek_threshold", bool "dr", bool "repeat", int "dominance", bool "stacked", string "format")}}		:{{Template:FuncDef\|LWLibavVideoSource (string source, int "stream_index", int "threads", bool "cache", int "seek_mode", int "seek_threshold", bool "dr", bool "repeat", int "dominance", bool "stacked", string "format")}}
Line 168:		Line 167:
	\ cache=true, seek_mode=0, seek_threshold=10, dr=false,		\ cache=true, seek_mode=0, seek_threshold=10, dr=false,
	\ repeat=false, dominance=0, stacked=false, format="")		\ repeat=false, dominance=0, stacked=false, format="")
	~~<br>~~
	<br>		<br>
	<br>		<br>
	-----------------------------------------------		-----------------------------------------------
	'''Back to [[LSMASHSource]] ←'''		'''Back to [[LSMASHSource]] ←'''

Reel.Deal: category

2014-08-23T16:08:40Z

← Older revision		Revision as of 18:08, 23 August 2014
Line 1:		Line 1:
			[[Category:Plugin_Filters]]
			[[Category:Source_filters]]
	'''Back to [[LSMASHSource]] ←'''		'''Back to [[LSMASHSource]] ←'''
	-----------------------------------------------		-----------------------------------------------