MVTools2/MShow - Revision history

Reel.Deal: cosmetics / category

2016-01-06T14:30:24Z

cosmetics / category

Reel.Deal: reformat and add some examples

2015-03-07T20:22:08Z

reformat and add some examples

Reel.Deal: category

2014-09-20T22:50:41Z

Reel.Deal: category

2014-08-23T22:00:21Z

Reel.Deal: /* Syntax and Parameters */

2014-06-14T22:08:34Z

‎Syntax and Parameters

Reel.Deal: /* Syntax and Parameters */

2014-06-12T13:17:31Z

‎Syntax and Parameters

Reel.Deal: MVTools2/MShow

2014-06-12T13:10:32Z

MVTools2/MShow

New page

'''Back to [[MVTools#Filters|MVTools2]] ←'''
-------------------------------------------------
 
 
== Description ==
:Shows the motion vectors on padded source by super clip opening.
 
== Syntax and Parameters ==
:{{Template:FuncDef|MShow (clip, clip, int "scale", int "sil", int "tol", bool "showsad", int "number", int "thSCD1", int "thSCD2", bool "isse", bool "planar")}}
 
::{{Par2| |clip| }}
:::Input clip.
 
::{{Par2| |clip| }}
:::Vector clip from [[MVTools2/MAnalyse|MAnalyse]].
 
::{{Par2|scale|int|1}}
:::Allows to enlarge the motion vectors, in order for example to gain in accuracy (when {{Template:FuncDef|pel}} > 1 and {{Template:FuncDef|scale}} = 1, you can't see a variation of less than one pixel).
 
::{{Par2|sil|int|0}}
:::Allows to see a different level of analysis (when searching for motion vectors, a hierarchical analysis is done, and it may be interesting to see what happens at higher levels).
 
::{{Par2|tol|int|20000}}
:::Tolerance threshold. If the distortion induced by the motion vector is over var>{{Template:FuncDef|tol}} the vector isn't shown.
 
::{{Par2|showsad|bool|false}}
:::Allows to show the mean (scaled to block 8x8) SAD after compensating the picture and quantity ({{Template:FuncDef|ThSCD1}}) of bad ({{Template:FuncDef|ThSCD1}}) blocks.
:::Default is false which shows all vectors.
 
::{{Par2|number|int|-1}}
:::Allows to mark given block (with this number) as white.
 
::{{Par2|thSCD1|int|400}}
:::Threshold which decides whether a block has changed between the previous frame and the current one. When a block has changed,
:::it means that motion estimation for it isn't relevant. It occurs for example at scene changes. So it is one of the thresholds used to
:::tweak the scene changes detection engine. Raising it will lower the number of blocks detected as changed. It may be useful for noisy
:::or flickered video. The threshold is compared to the SAD (Sum of Absolute Differences, a value which says how bad the motion
:::estimation was) value. For exactly identical blocks we have SAD=0. But real blocks are always different because of objects complex
:::movement (zoom, rotation, deformation), discrete pixels sampling, and noise. Suppose we have two compared 8x8 blocks with every
:::pixel different by 5. It this case SAD will be 8x8x5 = 320 (block will not detected as changed for thSCD1=400). If you use 4x4 blocks,
:::SAD will be 320/4. If you use 16x16 blocks, SAD will be 320*4. Really this parameter is scaled internally in MVTools, and you must
:::always use reduced to block size 8x8 value. Default is 400.
 
::{{Par2|thSCD2|int|130}}
:::Threshold which sets how many blocks have to change for the frame to be considered as a scene change.
:::It is ranged from 0 to 255, 0 meaning 0%, 255 meaning 100%. Default is 130 (which means 51%).
 
::{{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).
 
::{{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.
 

== Examples ==
MShow with default values:
[[AviSource]]("blah.avi")
 
 
------------------------------------------------
'''Back to [[MVTools#Filters|MVTools2]] ←'''

@@ Line 1: / Line 1: @@
-[[Category:Plugin_Filters]]
+{{FilterCat4|External_filters|Plugin_functions|Other_filters|Debugging/Diagnostic_filters}}
-[[Category:Debugging/Diagnostic_filters]]
+'''MShow''' can be used to view the backward/forward motion vectors produced by [[MVTools2/MAnalyse|MAnalyse]].
-This function can be used to view the backward/forward motion vectors produced by [[MVTools2/MAnalyse|MAnalyse]].
 <br>
 <br>

@@ Line 1: / Line 1: @@
 [[Category:Plugin_Filters]]
 [[Category:Debugging/Diagnostic_filters]]
-'''Back to [[MVTools#Filters|MVTools2]] &larr;'''
+This function can be used to view the backward/forward motion vectors produced by [[MVTools2/MAnalyse|MAnalyse]].
--------------------------------------------------
 <br>
 <br>
-== Description ==
+== [[Script variables|Syntax and Parameters]] ==
-:Shows the motion vectors on padded source by super clip opening.
-<br>
-== Syntax and Parameters ==
 :{{Template:FuncDef|MShow (clip, clip, int "scale", int "sil", int "tol", bool "showsad", int "number", int "thSCD1", int "thSCD2", bool "isse", bool "planar")}}
 <br>
@@ Line 34: / Line 30: @@
 <br>
 ::{{Par2|thSCD1|int|400}}
-:::Threshold which decides whether a block has changed between the previous frame and the current one. When a block
+:::Threshold which decides whether a block has changed between the previous frame and the current one. When a block has changed, it means that motion estimation for it isn't relevant. It occurs for example at scene changes. So it is one of the thresholds used to tweak the scene changes detection engine. Raising it will lower the number of blocks detected as changed. It may be useful for noisy or flickered video. The threshold is compared to the SAD (Sum of Absolute Differences, a value which says how bad the motion estimation was) value. For exactly identical blocks we have SAD=0. But real blocks are always different because of objects complex movement (zoom, rotation, deformation), discrete pixels sampling, and noise. Suppose we have two compared 8x8 blocks with every pixel different by 5. It this case SAD will be 8x8x5 = 320 (block will not detected as changed for thSCD1=400). If you use 4x4 blocks, SAD will be 320/4. If you use 16x16 blocks, SAD will be 320*4. Really this parameter is scaled internally in MVTools, and you must always use reduced to block size 8x8 value. Default is 400.
-:::has changed, it means that motion estimation for it isn't relevant. It occurs for example at scene changes. So it is one
-:::of the thresholds used to tweak the scene changes detection engine. Raising it will lower the number of blocks detected
-:::as changed. It may be useful for noisy or flickered video. The threshold is compared to the SAD (Sum of Absolute
-:::Differences, a value which says how bad the motion estimation was) value. For exactly identical blocks we have SAD=0.
-:::But real blocks are always different because of objects complex movement (zoom, rotation, deformation), discrete pixels
-:::sampling, and noise. Suppose we have two compared 8x8 blocks with every pixel different by 5. It this case SAD will be
-:::8x8x5 = 320 (block will not detected as changed for thSCD1=400). If you use 4x4 blocks, SAD will be 320/4. If you use
-:::16x16 blocks, SAD will be 320*4. Really this parameter is scaled internally in MVTools, and you must always use reduced
-:::to block size 8x8 value. Default is 400.
 <br>
 ::{{Par2|thSCD2|int|130}}
-:::Threshold which sets how many blocks have to change for the frame to be considered as a scene change.
+:::Threshold which sets how many blocks have to change for the frame to be considered as a scene change. It is ranged from 0 to 255, 0 meaning 0%, 255 meaning 100%. Default is 130 (which means 51%).
-:::It is ranged from 0 to 255, 0 meaning 0%, 255 meaning 100%. Default is 130 (which means 51%).
 <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).
+:::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
+:::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.
-:::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 ==
-MShow with default values:
+Show foward motion vectors.
   [[AviSource]]("blah.avi")
 <br>
 <br>
 ------------------------------------------------
 '''Back to [[MVTools#Filters|MVTools2]] &larr;'''

@@ Line 1: / Line 1: @@
 [[Category:Plugin_Filters]]
-[[Category:Debug]]
+[[Category:Debugging/Diagnostic_filters]]
 '''Back to [[MVTools#Filters|MVTools2]] &larr;'''
 -------------------------------------------------

← Older revision		Revision as of 22:00, 23 August 2014
Line 1:		Line 1:
		+	[[Category:Plugin_Filters]]
		+	[[Category:Debug]]
	'''Back to [[MVTools#Filters\|MVTools2]] ←'''		'''Back to [[MVTools#Filters\|MVTools2]] ←'''
	-------------------------------------------------		-------------------------------------------------

@@ Line 10: / Line 10: @@
 <br>
 ::{{Par2| |clip| }}
-:::Input clip.
+:::Super clip from [[MVTools2/MSuper|MSuper]].
 <br>
 ::{{Par2| |clip| }}