VsTTempSmooth - Revision history

Asd: vsTTempSmooth 1.2.3

2023-05-18T09:52:48Z

vsTTempSmooth 1.2.3

← Older revision		Revision as of 11:52, 18 May 2023
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|1=[https://github.com/Asd-g Asd-g]		\|1=[https://github.com/Asd-g Asd-g]
	\|2=v1.1.2		\|2=v1.2.3
	\|3=[https://github.com/Asd-g/AviSynth-vsTTempSmooth/releases vsTTempSmooth-1.1.2.7z]		\|3=[https://github.com/Asd-g/AviSynth-vsTTempSmooth/releases vsTTempSmooth-1.2.3.7z]
	\|4=Temporal Denoisers		\|4=Temporal Denoisers
	\|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]		\|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
Line 26:		Line 26:
	<br>		<br>
	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\|vsTTempSmooth (clip, int "maxr", int "ythresh", int "uthresh", int "vthresh", int "ymdiff", int "umdiff", int "vmdiff", int "strength", float "scthresh", bool "fp", ~~bool~~ "y", ~~bool~~ "u", ~~bool~~ "v", clip "pfclip") }}		:{{Template:FuncDef\|vsTTempSmooth (clip, int "maxr", int "ythresh", int "uthresh", int "vthresh", int "ymdiff", int "umdiff", int "vmdiff", int "strength", float "scthresh", bool "fp", int "y", int "u", int "v", clip "pfclip", int "opt") }}
	<br>		<br>
	::{{Par2\| \|clip\| }}		::{{Par2\| \|clip\| }}
Line 78:		Line 78:
	:::When true will add any weight not given to the outer pixels back onto the center pixel when computing the final value and it's much better for reducing artifacts in motion areas and usually produces overall better results. When false will just do a normal weighted average.		:::When true will add any weight not given to the outer pixels back onto the center pixel when computing the final value and it's much better for reducing artifacts in motion areas and usually produces overall better results. When false will just do a normal weighted average.
	<br>		<br>
	::{{Par2\|y\|~~bool~~\|~~true~~}}		::{{Par2\|y\|int\|3}}
	::{{Par2\|u\|~~bool~~\|~~true~~}}		::{{Par2\|u\|int\|3}}
	::{{Par2\|v\|~~bool~~\|~~true~~}}		::{{Par2\|v\|int\|3}}
	:::Planes to process.		:::Planes to process.
			:::*1: Return garbage.
			:::*2: Copy plane.
			:::*3: Process plane.
	<br>		<br>
	::{{Par2\|pfclip\|clip\| }}		::{{Par2\|pfclip\|clip\| }}
	:::This allows you to specify a separate clip for vsTTempSmooth to use when calculating pixel differences. This applies to checking the motion thresholds, calculating inverse difference weights, and detecting scenechanges. Basically, the <code>pfclip</code> will be used to determine the weights in the average but the weights will be applied to the original input clip's pixel values.		:::This allows you to specify a separate clip for vsTTempSmooth to use when calculating pixel differences. This applies to checking the motion thresholds, calculating inverse difference weights, and detecting scenechanges. Basically, the <code>pfclip</code> will be used to determine the weights in the average but the weights will be applied to the original input clip's pixel values.
			<br>
			::{{Par2\|opt\|int\|-1}}
			:::Sets which cpu optimizations to use.
			:::*-1: Auto-detect.
			:::*0: Use C++ code.
			:::*1: Use SSE2 code.
			:::*2: Use AVX2 code.
			:::*3: Use AVX-512 code.
	<br>		<br>

Line 90:		Line 101:
	vsTTempSmooth with default settings:		vsTTempSmooth with default settings:
	[[AviSource]]("Blah.avi")		[[AviSource]]("Blah.avi")
	vsTTempSmooth(maxr=3, ythresh=4, uthresh=5, vthresh=5, ymdiff=2, umdiff=3, vmdiff=3, strength=2, scthresh=12.0, fp=true, y=~~true~~, u=~~true~~, v=~~true~~)		vsTTempSmooth(maxr=3, ythresh=4, uthresh=5, vthresh=5, ymdiff=2, umdiff=3, vmdiff=3, strength=2, scthresh=12.0, fp=true, y=3, u=3, v=3)
	<br>		<br>
	== Changelog ==		== Changelog ==
	Version Date Changes<br>		Version Date Changes<br>
			v1.2.3 2023/03/04 - Improved SIMD code. (@DTL2020).
			v1.2.2 2023/03/02 - Fixed used frames for scene change detection.
			- Fixed memory allocation for inverse pixel difference weighting.
			- Fixed inverse pixel difference weighting to work properly for every processed plane.
			v1.2.1 2023/02/28 - Fixed processing with float clips. (regression from 1.2.0)
			- Added parameter opt.
			- Added SSE2, AVX2, AVX-512 code.
			- Fixed earlier exit of the scene change detection.
			- Fixed memory misalignment.
			v1.2.0 2023/02/27 - Fixed crash when releasing memory.
			- Changed the type of parameters y, u, v to int.
			v1.1.3 2020/08/24 - Throw error for non-planar formats.
	v1.1.2 2020/06/11 - Fixed memory leak.		v1.1.2 2020/06/11 - Fixed memory leak.
	v1.1.1 2020/05/31 - Fixed memory misalignment for AviSynth 2.6.		v1.1.1 2020/05/31 - Fixed memory misalignment for AviSynth 2.6.

Reel.Deal: add Deep_color_tools category

2020-06-25T20:23:20Z

add Deep_color_tools category

← Older revision		Revision as of 22:23, 25 June 2020
Line 1:		Line 1:
	{{~~FilterCat5~~\|External_filters\|Plugins\|Plugins_x64\|Denoisers\|Temporal_denoisers}}		{{FilterCat6\|External_filters\|Plugins\|Plugins_x64\|Denoisers\|Temporal_denoisers\|Deep_color_tools}}
	{{Filter3		{{Filter3
	\|1=[https://github.com/Asd-g Asd-g]		\|1=[https://github.com/Asd-g Asd-g]
Line 19:		Line 19:
	* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F\|Progressive]] input only		* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F\|Progressive]] input only
	* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]]		* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]]
	**AviSynth+: all planar Y/YUV/YUVA formats (8/10/12/14/~~16bit and float~~) are supported.		**AviSynth+: all planar Y/YUV/YUVA formats (8/10/12/14/16/32-bit) are supported.
	<br>		<br>
	* [https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads Microsoft Visual C++ 2019 Redistributable Package (x86 / x64)]		* [https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads Microsoft Visual C++ 2019 Redistributable Package (x86 / x64)]

Asd: v1.1.2

2020-06-17T14:33:46Z

v1.1.2

← Older revision		Revision as of 16:33, 17 June 2020
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|1=[https://github.com/Asd-g Asd-g]		\|1=[https://github.com/Asd-g Asd-g]
	\|2=v1.1.1		\|2=v1.1.2
	\|3=[https://github.com/Asd-g/AviSynth-vsTTempSmooth/releases vsTTempSmooth-1.1.1.7z]		\|3=[https://github.com/Asd-g/AviSynth-vsTTempSmooth/releases vsTTempSmooth-1.1.2.7z]
	\|4=Temporal Denoisers		\|4=Temporal Denoisers
	\|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]		\|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
Line 94:		Line 94:
	== Changelog ==		== Changelog ==
	Version Date Changes<br>		Version Date Changes<br>
			v1.1.2 2020/06/11 - Fixed memory leak.
	v1.1.1 2020/05/31 - Fixed memory misalignment for AviSynth 2.6.		v1.1.1 2020/05/31 - Fixed memory misalignment for AviSynth 2.6.
	v1.1.0 2020/05/30 - Added scthresh paramter.		v1.1.0 2020/05/30 - Added scthresh paramter.

Reel.Deal: v1.1.1

2020-06-03T19:29:38Z

v1.1.1

← Older revision		Revision as of 21:29, 3 June 2020
Line 2:		Line 2:
	{{Filter3		{{Filter3
	\|1=[https://github.com/Asd-g Asd-g]		\|1=[https://github.com/Asd-g Asd-g]
	\|2=v1.0.0		\|2=v1.1.1
	\|3=[https://github.com/Asd-g/AviSynth-vsTTempSmooth/releases vsTTempSmooth-1.0.0.7z]		\|3=[https://github.com/Asd-g/AviSynth-vsTTempSmooth/releases vsTTempSmooth-1.1.1.7z]
	\|4=Temporal Denoisers		\|4=Temporal Denoisers
	\|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]		\|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
	\|6=~~[http://forum.doom9.org/showthread.php?t=78905 Doom9 Thread]~~}}		\|6=}}

	== Description ==		== Description ==
Line 26:		Line 26:
	<br>		<br>
	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\|vsTTempSmooth (clip, int "maxr", int "ythresh", int "uthresh", int "vthresh", int "ymdiff", int "umdiff", int "vmdiff", int "strength", bool "fp", bool "y", bool "u", bool "v", clip "pfclip") }}		:{{Template:FuncDef\|vsTTempSmooth (clip, int "maxr", int "ythresh", int "uthresh", int "vthresh", int "ymdiff", int "umdiff", int "vmdiff", int "strength", float "scthresh", bool "fp", bool "y", bool "u", bool "v", clip "pfclip") }}
	<br>		<br>
	::{{Par2\| \|clip\| }}		::{{Par2\| \|clip\| }}
Line 69:		Line 69:
	:::The values shown are for <code>maxr=7</code>, when using smaller radius values the weights outside of the range are simply dropped. Thus, setting strength to a value of <code>maxr+1</code> or higher will give you equal spatial weighting of all pixels in the kernel.		:::The values shown are for <code>maxr=7</code>, when using smaller radius values the weights outside of the range are simply dropped. Thus, setting strength to a value of <code>maxr+1</code> or higher will give you equal spatial weighting of all pixels in the kernel.
	:::Must be between 1 and 8.		:::Must be between 1 and 8.
			<br>
			::{{Par2\|scthresh\|float\|12.0}}
			:::The standard scenechange threshold as a percentage of maximum possible change of the luma plane. A good range of values is between 8 and 15.
			:::Set to 0 to disable scenechange detection.
			:::Must be between 0.0 and 100.0.
	<br>		<br>
	::{{Par2\|fp\|bool\|true}}		::{{Par2\|fp\|bool\|true}}
Line 85:		Line 90:
	vsTTempSmooth with default settings:		vsTTempSmooth with default settings:
	[[AviSource]]("Blah.avi")		[[AviSource]]("Blah.avi")
	vsTTempSmooth(maxr=3, ythresh=4, uthresh=5, vthresh=5, ymdiff=2, umdiff=3, vmdiff=3, strength=2, fp=true, y=true, u=true, v=true)		vsTTempSmooth(maxr=3, ythresh=4, uthresh=5, vthresh=5, ymdiff=2, umdiff=3, vmdiff=3, strength=2, scthresh=12.0, fp=true, y=true, u=true, v=true)
	<br>		<br>
	== Changelog ==		== Changelog ==
	Version Date Changes<br>		Version Date Changes<br>
			v1.1.1 2020/05/31 - Fixed memory misalignment for AviSynth 2.6.
			v1.1.0 2020/05/30 - Added scthresh paramter.
	v1.0.0 2020/05/28 - Initial release		v1.0.0 2020/05/28 - Initial release
	- Port of the VapourSynth plugin TTempSmooth.		- Port of the VapourSynth plugin TTempSmooth.

Reel.Deal: vsTTempSmooth: add documentation

2020-05-29T17:29:05Z

vsTTempSmooth: add documentation

New page

{{FilterCat5|External_filters|Plugins|Plugins_x64|Denoisers|Temporal_denoisers}}
{{Filter3
|1=[https://github.com/Asd-g Asd-g]
|2=v1.0.0
|3=[https://github.com/Asd-g/AviSynth-vsTTempSmooth/releases vsTTempSmooth-1.0.0.7z]
|4=Temporal Denoisers
|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=[http://forum.doom9.org/showthread.php?t=78905 Doom9 Thread]}}

== Description ==
[[vsTTempSmooth]] is a motion adaptive (it only works on stationary parts of the picture), temporal smoothing filter.

vsTTempSmooth is a port of the VapourSynth plugin TTempSmooth.
 
 
== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
* [x64]: [[AviSynth+]]
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]]
**AviSynth+: all planar Y/YUV/YUVA formats (8/10/12/14/16bit and float) are supported.
 
* [https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads Microsoft Visual C++ 2019 Redistributable Package (x86 / x64)]
:*** <tt>vcredist_x86.exe</tt> is required for <tt>vsTTempSmooth-x86</tt>
:*** <tt>vcredist_x64.exe</tt> is required for <tt>vsTTempSmooth-x64</tt>
 
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|vsTTempSmooth (clip, int "maxr", int "ythresh", int "uthresh", int "vthresh", int "ymdiff", int "umdiff", int "vmdiff", int "strength", bool "fp", bool "y", bool "u", bool "v", clip "pfclip") }}
 
::{{Par2| |clip| }}
:::A clip to process. It must be Y/YUV(A) 8..32-bit format.
 
::{{Par2|maxr|int|3}}
:::This sets the maximum temporal radius. By the way it works vsTTempSmooth automatically varies the radius used... This sets the maximum boundary.
:::Must be between 1 and 7. At 1 vsTTempSmooth will be (at max) including pixels from 1 frame away in the average (3 frames total will be considered counting the current frame). At 7 it would be including pixels from up to 7 frames away (15 frames total will be considered). With the way it checks motion there isn't much danger in setting this high, it's basically a quality vs. speed option. Lower settings are faster while larger values tend to create a more stable image.
 
::{{Par2|ythresh|int|4}}
:::Luma threshold for differences of pixels between frames. vsTTempSmooth checks 2 frame distance as well as single frame, so these can usually be set slightly higher than with most other temporal smoothers and still avoid artifacts.
:::Must be between 1 and 256.
:::Also important is the fact that as long as <code>ymdiff</code> is less than the threshold value then pixels with larger differences from the original will have less weight in the average. Thus, even with rather large thresholds pixels just under the threshold wont have much weight, helping to reduce artifacts.
 
::{{Par2|uthresh|int|5}}
::{{Par2|vthresh|int|5}}
:::Same as ythresh but for the chroma planes (u, v).
:::Must be between 1 and 256.
 
::{{Par2|ymdiff|int|2}}
:::Any pixels with differences less than or equal to <code>ymdiff</code> will be blurred at maximum. Usually, the larger the difference to the center pixel the smaller the weight in the average. <code>ymdiff</code> makes vsTTempSmooth treat pixels that have a difference of less than or equal to <code>ymdiff</code> as though they have a difference of 0. In other words, it shifts the zero difference point outwards. Set <code>ymdiff</code> to a value equal to or greater than <code>ythresh-1</code> to completely disable inverse pixel difference weighting.
:::Applied only to the luma plane.
:::Must be between 0 and 255.
 
::{{Par2|umdiff|int|3}}
::{{Par2|vmdiff|int|3}}
:::Same as <code>ymdiff</code> but for the chroma planes (u, v).
:::Must be between 0 and 255.
 
::{{Par2|strength|int|2}}
:::vsTTempSmooth uses inverse distance weighting when deciding how much weight to give to each pixel value. The strength option lets you shift the drop off point away from the center to give a stronger smoothing effect and add weight to the outer pixels. It does for the spatial weights what mdiff does for the difference weights.

:::*1 = 0.13 0.14 0.16 0.20 0.25 0.33 0.50 1.00 0.50 0.33 0.25 0.20 0.16 0.14 0.13
:::*2 = 0.14 0.16 0.20 0.25 0.33 0.50 1.00 1.00 1.00 0.50 0.33 0.25 0.20 0.16 0.14
:::*3 = 0.16 0.20 0.25 0.33 0.50 1.00 1.00 1.00 1.00 1.00 0.50 0.33 0.25 0.20 0.16
:::*4 = 0.20 0.25 0.33 0.50 1.00 1.00 1.00 1.00 1.00 1.00 1.00 0.50 0.33 0.25 0.20
:::*5 = 0.25 0.33 0.50 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 0.50 0.33 0.25
:::*6 = 0.33 0.50 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 0.50 0.33
:::*7 = 0.50 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 0.50
:::*8 = 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00

:::The values shown are for <code>maxr=7</code>, when using smaller radius values the weights outside of the range are simply dropped. Thus, setting strength to a value of <code>maxr+1</code> or higher will give you equal spatial weighting of all pixels in the kernel.
:::Must be between 1 and 8.
 
::{{Par2|fp|bool|true}}
:::When true will add any weight not given to the outer pixels back onto the center pixel when computing the final value and it's much better for reducing artifacts in motion areas and usually produces overall better results. When false will just do a normal weighted average.
 
::{{Par2|y|bool|true}}
::{{Par2|u|bool|true}}
::{{Par2|v|bool|true}}
:::Planes to process.
 
::{{Par2|pfclip|clip| }}
:::This allows you to specify a separate clip for vsTTempSmooth to use when calculating pixel differences. This applies to checking the motion thresholds, calculating inverse difference weights, and detecting scenechanges. Basically, the <code>pfclip</code> will be used to determine the weights in the average but the weights will be applied to the original input clip's pixel values.
 

== Examples ==
vsTTempSmooth with default settings:
[[AviSource]]("Blah.avi")
vsTTempSmooth(maxr=3, ythresh=4, uthresh=5, vthresh=5, ymdiff=2, umdiff=3, vmdiff=3, strength=2, fp=true, y=true, u=true, v=true)
 
== Changelog ==
Version Date Changes 
v1.0.0 2020/05/28 - Initial release
- Port of the VapourSynth plugin TTempSmooth.
 
==External Links ==
*[https://github.com/Asd-g/AviSynth-vsTTempSmooth GitHub] - Source code repository.
*[https://github.com/HomeOfVapourSynthEvolution/VapourSynth-TTempSmooth GitHub] - Source code repository (VapourSynth version).
 
 
-----------------------------------------------
'''Back to [[External_filters#Temporal_Denoisers|External Filters]] ←'''
-----------------------------------------------