MVTools2/MSuper - Revision history

Kogarou: Fixing the Eedi3 link

2021-11-07T20:02:45Z

Fixing the Eedi3 link

← Older revision		Revision as of 22:02, 7 November 2021
Line 56:		Line 56:
	MSuper(..., pel=2, pelclip=LanczosResize(width2,height2,src_left=0.25, src_top=0.25))		MSuper(..., pel=2, pelclip=LanczosResize(width2,height2,src_left=0.25, src_top=0.25))
	</div>		</div>
	::Another useful filter for {{FuncArg\|pelclip}} is the [[~~EEDI3~~]] edge-directed resampler.		::Another useful filter for {{FuncArg\|pelclip}} is the [[Eedi3]] edge-directed resampler.
	::Recent note: it is true for luma, but is not exactly corresponded to chroma pixels positions of internal '''MVTools''' interpolation. Nevertheless, vectors and motion compensation are quite similar for usual clips, same chroma would be with ''src_left=0.5'' for YUY2 and additionally ''src_top=0.5'' for YV12.{{Clarify}}		::Recent note: it is true for luma, but is not exactly corresponded to chroma pixels positions of internal '''MVTools''' interpolation. Nevertheless, vectors and motion compensation are quite similar for usual clips, same chroma would be with ''src_left=0.5'' for YUY2 and additionally ''src_top=0.5'' for YV12.{{Clarify}}

Kogarou: Update to the description and parameters

2021-11-07T20:01:19Z

Update to the description and parameters

← Older revision		Revision as of 22:01, 7 November 2021
Line 6:		Line 6:

	== Description ==		== Description ==
	~~Get~~ source clip and ~~prepare~~ a special '''~~''super''~~''' clip with multilevel~~, hierarchically~~ scaled ~~frame~~ data. The ~~super~~ clip is used by both [[MAnalyse]] and ~~other~~ motion compensation client functions.		Gets a source clip and prepares a special '''Super''' clip with multilevel (hierarchical scaled) frames data. The Super clip is used by both [[MAnalyse]] and motion compensation (client) functions.<br>
			The audio properties of the Super clip are used to store and transfer its parameters (specifically ''num_audio_samples''), therefore any existing audio is killed in the Super clip. That is one of reasons why you can additionally use a source clip with client functions. You may have a look to the Super clip yourself (it has a normal format).<br>
	~~For storing and transferring metadata we use~~ audio properties of the ~~super~~ clip (specifically, ''num_audio_samples'') ~~as a trick. So~~, audio is killed in the ~~super~~ clip. That is one of ~~the~~ reasons ~~we require~~ a ~~separate~~ source clip with ~~'''MVTools'''~~ client functions. You may have a look at the ~~super~~ clip yourself; it has a normal format.		Supported formats: Y, YUV and planar RGB (8-32) bits, and YUY2. You can use a different Super clip to generate vectors with MAnalyze and a different Super clip format for the actual action. This enables support for planar RGB with MFlowFPS, and lets MDegrain work with 32 bit float input clips.

	== Syntax and Parameters ==		== Syntax and Parameters ==
Line 15:		Line 15:

	:{{Par2\|hpad\|int\|8}}		:{{Par2\|hpad\|int\|8}}
	::Horizontal padding added to source frame (both left and right), for more correct motion estimation near frame borders.		::Horizontal padding added to source frame (both left and right). A small padding is added for more correct motion estimation near frame borders.

	:{{Par2\|vpad\|int\|8}}		:{{Par2\|vpad\|int\|8}}
	::Vertical padding added to source frame (both top and bottom), for ~~more correct motion estimation near frame borders~~.		::Vertical padding added to source frame (both top and bottom), for the same reason as ''hpad''.

	:{{Par2\|pel\|int\|2}}		:{{Par2\|pel\|int\|2}}
	::~~Set motion~~ estimation accuracy. Value can only be 1, 2 or 4.		::Motion estimation accuracy. Value can only be 1, 2 or 4.
	:::*1 : means precision to the pixel.		:::*1 : means precision to the pixel.
	:::*2 : means precision to half a pixel.		:::*2 : means precision to half a pixel.
Line 27:		Line 27:

	:{{Par2\|levels\|int\|0}}		:{{Par2\|levels\|int\|0}}
	::~~Set the number~~ of hierarchical levels in super clip frames. [[MAnalyse]] needs all levels, but for other client functions a single, finest level is enough (~~courser~~ levels are not used). ~~Default =~~ 0 (~~auto,~~ all possible levels are produced).		::Number of hierarchical levels for super clip frames. [[MAnalyse]] needs all levels, but for other client functions a single, finest level is enough (coarser levels are not used). 0 is auto (all possible levels are produced).

	:{{Par2\|chroma\|bool\|true}}		:{{Par2\|chroma\|bool\|true}}
	::If true, ~~prepare~~ chroma planes ~~also~~. ~~(false =~~ luma only).		::When true, process chroma planes too. False for luma only.

	:{{Par2\|sharp\|int\|2}}		:{{Par2\|sharp\|int\|2}}
	::Sub-pixel interpolation method for {{FuncArg\|pel}} = 2 or 4.		::Sub-pixel interpolation method for when {{FuncArg\|pel}} == 2 \|\| 4.
	:::*0 : soft interpolation (bilinear).		:::*0 : soft interpolation (bilinear).
	:::*1 : bicubic interpolation (4 tap Catmull-Rom)		:::*1 : bicubic interpolation (4 tap Catmull-Rom)
Line 41:		Line 41:
	::Hierarchical levels smoothing and reducing (halving) filter.		::Hierarchical levels smoothing and reducing (halving) filter.
	:::* 0 : simple 4 pixels averaging like unfiltered [[SimpleResize]] (old method)		:::* 0 : simple 4 pixels averaging like unfiltered [[SimpleResize]] (old method)
	:::* 1 : triangle (shifted) filter like [[ReduceBy2]] for more smoothing (~~decrease~~ aliasing)		:::* 1 : triangle (shifted) filter like [[ReduceBy2]] for more smoothing (decreased aliasing)
	:::* 2 : triangle filter like [[BilinearResize]] for even more smoothing		:::* 2 : triangle filter like [[BilinearResize]] for even more smoothing
	:::* 3 : quadratic filter for even more smoothing		:::* 3 : quadratic filter for even more smoothing
	:::* 4 : cubic filter like [[BicubicResize]](b=1,c=0) for even more smoothing		:::* 4 : cubic filter like [[BicubicResize]](b=1,c=0) for even more smoothing

	:: You may also try to apply some external filter to ''superclip'' or its coarse bottom part (by appropriate crop and overlay).		:: You may also try to apply some external filter to the''superclip'' or its coarse bottom part (by appropriate crop and overlay).

	:{{Par2\|pelclip\|clip\| }}		:{{Par2\|pelclip\|clip\| }}
	::Optional upsampled source clip for using instead of internal sub-pixel interpolation (for {{FuncArg\|pel}}>1).		::Optional upsampled source clip for using instead of internal sub-pixel interpolation (for {{FuncArg\|pel}} > 1).
	::Pixels at rows and columns positions multiple to {{FuncArg\|pel}} (0,2,4,... for {{FuncArg\|pel}}=2) (without padding) must be original source pixels; other pixels must be interpolated.		::Pixels at rows and columns positions multiple to {{FuncArg\|pel}} (0,2,4,... for {{FuncArg\|pel}}=2) (without padding) must be original source pixels; other pixels must be interpolated.

Line 56:		Line 56:
	MSuper(..., pel=2, pelclip=LanczosResize(width2,height2,src_left=0.25, src_top=0.25))		MSuper(..., pel=2, pelclip=LanczosResize(width2,height2,src_left=0.25, src_top=0.25))
	</div>		</div>
	::Another useful {{FuncArg\|pelclip}} is the [[~~eedi3~~]] edge-directed resampler.		::Another useful filter for {{FuncArg\|pelclip}} is the [[EEDI3]] edge-directed resampler.
	::Recent note: it is true for luma, but is not exactly corresponded to chroma pixels positions of internal '''MVTools''' interpolation. Nevertheless, vectors and motion compensation are quite similar for usual clips, same chroma would be with ''src_left=0.5'' for YUY2 and additionally ''src_top=0.5'' for YV12.{{Clarify}}		::Recent note: it is true for luma, but is not exactly corresponded to chroma pixels positions of internal '''MVTools''' interpolation. Nevertheless, vectors and motion compensation are quite similar for usual clips, same chroma would be with ''src_left=0.5'' for YUY2 and additionally ''src_top=0.5'' for YV12.{{Clarify}}

	~~:{{Par2\|isse\|bool\|true}}~~
	::If true, enable ISSE, MMX and other CPU optimizations. You may want to disable them for for debugging. If your processor doesn't support CPU optimizations, it will be disabled anyway (and you won't be able to activate them). Default is True.

	~~:{{Par2\|planar\|bool\|false}}~~
	~~::If true, use special planar color format for [[YUY2]] clips both for input and output. '''Ignored for YV12 clips.'''~~
	:::'''MSuper''' uses a special trick for storing frames with [[planar]] color in an interleaved YUY2 container. This way we can avoid numerous internal interleaved to planar conversions and increase speed. You can convert normal interleaved YUY2 source clip to planar format with the ''Interleaved2planar'' function from [[RemoveGrain_v0.9/SSETools]] plugin by {{Author/kassandro}}, and convert final result by ''Planar2interleaved'' function. This special planar YUY2 format is also supported by [[RemoveGrain_v0.9\|Removegrain]] plugin by Kassandro, [[MaskTools2]] plugin by Manao and some others.
	~~::Note: super clip is always planar. Default is false.~~

	~~:{{Par2\|mt\|bool\|true}}~~
	~~::If true (the default), enables multi-threading. (v2.6.0.5)~~

Raffriff42: "mt" argument (v2.6.0.5)

2016-01-06T05:47:34Z

"mt" argument (v2.6.0.5)

← Older revision		Revision as of 07:47, 6 January 2016
Line 12:		Line 12:
	== Syntax and Parameters ==		== Syntax and Parameters ==
	{{FuncDef\|MSuper (clip, int "hpad", int "vpad", int "pel", int "levels", bool "chroma", <br>		{{FuncDef\|MSuper (clip, int "hpad", int "vpad", int "pel", int "levels", bool "chroma", <br>
	int "sharp", int "rfilter", clip "pelclip", bool "isse", bool "planar") }}		int "sharp", int "rfilter", clip "pelclip", bool "isse", bool "planar", bool "mt") }}

	:{{Par2\|hpad\|int\|8}}		:{{Par2\|hpad\|int\|8}}
Line 66:		Line 66:
	:::'''MSuper''' uses a special trick for storing frames with [[planar]] color in an interleaved YUY2 container. This way we can avoid numerous internal interleaved to planar conversions and increase speed. You can convert normal interleaved YUY2 source clip to planar format with the ''Interleaved2planar'' function from [[RemoveGrain_v0.9/SSETools]] plugin by {{Author/kassandro}}, and convert final result by ''Planar2interleaved'' function. This special planar YUY2 format is also supported by [[RemoveGrain_v0.9\|Removegrain]] plugin by Kassandro, [[MaskTools2]] plugin by Manao and some others.		:::'''MSuper''' uses a special trick for storing frames with [[planar]] color in an interleaved YUY2 container. This way we can avoid numerous internal interleaved to planar conversions and increase speed. You can convert normal interleaved YUY2 source clip to planar format with the ''Interleaved2planar'' function from [[RemoveGrain_v0.9/SSETools]] plugin by {{Author/kassandro}}, and convert final result by ''Planar2interleaved'' function. This special planar YUY2 format is also supported by [[RemoveGrain_v0.9\|Removegrain]] plugin by Kassandro, [[MaskTools2]] plugin by Manao and some others.
	::Note: super clip is always planar. Default is false.		::Note: super clip is always planar. Default is false.

			:{{Par2\|mt\|bool\|true}}
			::If true (the default), enables multi-threading. (v2.6.0.5)

Raffriff42: tweak grammar

2016-01-06T05:43:08Z

tweak grammar

← Older revision		Revision as of 07:43, 6 January 2016
Line 8:		Line 8:
	Get source clip and prepare a special '''''super''''' clip with multilevel, hierarchically scaled frame data. The super clip is used by both [[MAnalyse]] and other motion compensation client functions.		Get source clip and prepare a special '''''super''''' clip with multilevel, hierarchically scaled frame data. The super clip is used by both [[MAnalyse]] and other motion compensation client functions.

	For storing and transferring metadata we use audio properties of the super clip (specifically, ''num_audio_samples'') as a trick. So, audio is killed in the super clip. That is one of reasons ~~why~~ we require a separate source clip with '''MVTools''' client functions. You may have a look at the super clip yourself; it has a normal format.		For storing and transferring metadata we use audio properties of the super clip (specifically, ''num_audio_samples'') as a trick. So, audio is killed in the super clip. That is one of the reasons we require a separate source clip with '''MVTools''' client functions. You may have a look at the super clip yourself; it has a normal format.

	== Syntax and Parameters ==		== Syntax and Parameters ==
Line 15:		Line 15:

	:{{Par2\|hpad\|int\|8}}		:{{Par2\|hpad\|int\|8}}
	::Horizontal padding added to source frame (both left and right)~~. Small padding is added~~ for more correct motion estimation near frame borders.		::Horizontal padding added to source frame (both left and right), for more correct motion estimation near frame borders.

	:{{Par2\|vpad\|int\|8}}		:{{Par2\|vpad\|int\|8}}
	::Vertical padding added to source frame (both top and bottom)~~. Small padding is added~~ for more correct motion estimation near frame borders.		::Vertical padding added to source frame (both top and bottom), for more correct motion estimation near frame borders.

	:{{Par2\|pel\|int\|2}}		:{{Par2\|pel\|int\|2}}

Raffriff42: formatting, links, phrasing

2016-01-06T05:36:25Z

formatting, links, phrasing

Show changes

Reel.Deal: category

2014-08-23T22:02:26Z

Reel.Deal: /* Syntax and Parameters */

2014-06-11T17:20:05Z

Syntax and Parameters

← Older revision		Revision as of 19:20, 11 June 2014
Line 60:		Line 60:
	:::Other useful example is [[eedi3]] edge-directed resampler.		:::Other useful example is [[eedi3]] edge-directed resampler.
	<br>		<br>
			::{{Par2\|isse\|bool\|true}}
			:::Flag which allows to enable (if set to True) or disable (if set to False) ISSE, MMX and other CPU optimizations (for debugging).
			:::Default is True. If your processor doesn't support CPU optimizations, it will be disabled anyway (and you won't be able to activate them).
			<br>
			::{{Par2\|planar\|bool\|false}}
			:::Flag to use special planar color format for YUY2 clips both for input and output of function. It uses special trick for storing of frames with planar color data organization (separate Y, U, V planes in memory) in normal interleaved YUY2 frames format as a container. This way we can avoid numerous internal interleaved to planar conversions and increase speed. You can convert normal interleaved YUY2 source clip to planar format with Interleaved2planar function from RemoveGrain plugin by kassandro, and convert final result by Planar2interleaved function. This special planar YUY2 format is also supported by Removegrain plugin by Kassandro, MaskTools2 plugin by Manao and some others. This parameter is ignored for YV12 clips. Note: super clip is always planar. Default is planar=false.
			<br>

	== Examples ==		== Examples ==
	MSuper with default values.		MSuper with default values.

Reel.Deal: MVTools2/MSuper

2014-06-11T13:40:40Z

MVTools2/MSuper

New page

'''Back to [[MVTools#Filters|MVTools2]] ←'''
-------------------------------------------------
 
 
== Description ==
:Get source clip and prepare special "super" clip with multilevel (hierarchical scaled) frames data. The super clip is used by both MAnalyse and motion compensation (client) functions.
:For storing and transferring its parameters we use audio properties of super clip (specifically, num_audio_samples) as a trick. So, audio is killed in super clip.
:That is one of reasons why we additionally use a source clip with client functions. You may have a look at the super clip yourself (it has normal format).
 
 
== Syntax and Parameters ==
:{{Template:FuncDef|MSuper (clip, int "hpad", int "vpad", int "pel", int "levels", bool "chroma", int "sharp", int "rfilter", clip "pelclip", bool "isse", bool "planar") }}
 
::{{Par2|hpad|int|8}}
:::Horizontal padding added to source frame (both left and right). Small padding is added for more correct motion estimation near frame borders.
 
::{{Par2|vpad|int|8}}
::::Vertical padding added to source frame (both top and bottom). Small padding is added for more correct motion estimation near frame borders.
 
::{{Par2|pel|int|2}}
:::It is the accuracy of the motion estimation. Value can only be 1, 2 or 4.

::::*1 : means precision to the pixel.
::::*2 : means precision to half a pixel.
::::*4 : means precision to quarter of a pixel, produced by spatial interpolation (more accurate but slower and not always better due to big level scale step).
 
::{{Par2|levels|int|0}}
:::It is the number of hierarchical levels in super clip frames. MAnalyse needs all levels, but for other client functions single finest level is enough (courser levels are not used).
:::Default : 0 (auto, all possible levels are produced).
 
::{{Par2|chroma|bool|true}}
:::If set to true, it allows to prepare chroma planes too in superclip. (false - luma only).
 
::{{Par2|sharp|int|2}}
:::Subpixel interpolation method for pel=2,4.

::::*0 : use for soft interpolation (bilinear).
::::*1 : bicubic interpolation (4 tap Catmull-Rom)
::::*2 : 2 for sharper Wiener interpolation (6 tap, similar to Lanczos).
 
::{{Par2|rfilter|int|2}}
:::Hierarchical levels smoothing and reducing (halving) filter.

::::* 0 : simple 4 pixels averaging like unfiltered [[SimpleResize]] (old method)
::::* 1 : triangle (shifted) filter like [[ReduceBy2]] for more smoothing (decrease aliasing)
::::* 2 : triangle filter like [[BilinearResize]] for even more smoothing
::::* 3 : quadratic filter for even more smoothing
::::* 4 : cubic filter like [[BicubicResize]](b=1,c=0) for even more smoothing

::: You may also try to apply some external filter to superclip or its coarse bottom part (by appropriate crop and overlay).
 
::{{Par2|pelclip|clip| }}
:::Optional upsampled source clip for using instead of internal subpixel interpolation (for {{Template:FuncDef|pel}}>1).
:::Pixels at rows and colunms positions multiple to pel (0,2,4,... for {{Template:FuncDef|pel}}=2) (without padding) must be original source pixels, other pixels must be interpolated.

::::Example for {{Template:FuncDef|pel}}=2: LanczosResize(width*2,height*2,src_left=0.25, src_top=0.25).
::::Recent note: it is true for luma, but is not exactly corresponded to chroma pixels positions of internal MVTools interpolation.
::::Nevertheless vectors and motion compensation are quite similar for usual clips, same chroma would be with src_left=0.5 for YUY2 and additionally src_top=0.5 for YV12).

:::Other useful example is [[eedi3]] edge-directed resampler.
 
== Examples ==
MSuper with default values.
[[AviSource]]("blah.avi")
 
 
------------------------------------------------
'''Back to [[MVTools#Filters|MVTools2]] ←'''

← Older revision		Revision as of 00:02, 24 August 2014
Line 1:		Line 1:
			[[Category:Plugin_Filters]]
			[[Category:Support_filters]]
	'''Back to [[MVTools#Filters\|MVTools2]] ←'''		'''Back to [[MVTools#Filters\|MVTools2]] ←'''
	-------------------------------------------------		-------------------------------------------------