Soften - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-17T17:15:13Z

add link to avs+ documentation

← Older revision		Revision as of 19:15, 17 September 2022
Line 1:		Line 1:
	<div style="max-width:68em" >		<div style="max-width:68em" >

			<div {{BlueBox2\|40\|0\|3px solid purple}} >
			{{AvsPlusFullname}}<br>
			Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/soften.html https://avisynthplus.readthedocs.io]
			</div>


	'''SpatialSoften''' and '''TemporalSoften''' remove noise from a video clip by selectively blending pixels.		'''SpatialSoften''' and '''TemporalSoften''' remove noise from a video clip by selectively blending pixels.

Raffriff42: /* TemporalSoften */ note AVS+ differences

2017-10-21T13:00:26Z

TemporalSoften: note AVS+ differences

← Older revision		Revision as of 15:00, 21 October 2017
Line 28:		Line 28:
	}}		}}

	Blends corresponding pixels in neighboring frames. All frames no more than {{FuncArg\|radius}} away are examined. Blending occurs only if corresponding pixels are within {{FuncArg\|luma_threshold}} or {{FuncArg\|chroma_threshold}}, as explained below.		Blends corresponding pixels in neighboring frames. All frames no more than {{FuncArg\|radius}} away are examined. Blending occurs only if corresponding pixels are within {{FuncArg\|luma_threshold}} or {{FuncArg\|chroma_threshold}}, as explained below.

			{{AvsPluscon}} arguments are [[Autoscale_parameter\|autoscaling]] – they are always 0-255 at all bit depths.

	:{{Par2\|clip\|clip\|}}		:{{Par2\|clip\|clip\|}}
	:: Source clip. Supported color formats: all except [[RGB24]].		:: Source clip. Supported color formats: all except [[RGB24]] and [[Avisynthplus_color_formats\|RGB48]]

	:{{Par2\|radius\|int\|}}		:{{Par2\|radius\|int\|}}
Line 50:		Line 52:
	::Defines the maximum average pixel change between frames; set properly, this will avoid blending across scene changes.		::Defines the maximum average pixel change between frames; set properly, this will avoid blending across scene changes.
	::*Good values are between 5 and 30, somewhat higher than {{FuncArg\|luma_threshold}}.		::*Good values are between 5 and 30, somewhat higher than {{FuncArg\|luma_threshold}}.
			::*{{FuncArg\|scenechange}} not supported in RGB modes.

	:{{Par2\|mode\|int\|1}}		:{{Par2\|mode\|int\|1}}

Raffriff42: formatting, links, phrasing

2016-02-14T18:43:31Z

formatting, links, phrasing

@@ Line 1: / Line 1: @@
-{{Template:Func2Def|SpatialSoften(clip ''clip'', int ''radius'', int ''luma_threshold'', int ''chroma_threshold'')|TemporalSoften(clip ''clip'', int ''radius'', int ''luma_threshold'', int ''chroma_threshold'' [, int ''scenechange''] [, int ''mode''])}}
+<div style="max-width:68em" >
-The SpatialSoften and TemporalSoften filters remove noise from a video clip by selectively blending pixels. These filters can work miracles, and I highly encourage you to try them. But they can also wipe out fine detail if set too high, so don't go overboard. And they are very slow, especially with a large value of radius, so don't turn them on until you've got everything else ready.
+== Syntax and Parameters ==
-TemporalSoften is similar to SpatialSoften, except that it looks at the same pixel in nearby frames, instead of nearby pixels in the same frame. All frames no more than radius away are examined. This filter doesn't seem to be as effective as SpatialSoften.
+Like '''[[Blur]]''', '''SpatialSoften''' blends neighboring pixels in the frame &ndash; but with a wider possible {{FuncArg|radius}}, and only if neighboring pixels are within {{FuncArg|luma_threshold}} and {{FuncArg|chroma_threshold}}, as explained below.
-I encourage you to play around with the parameters for these filters to get an idea of what they do--for example, try setting one of the three parameters to a very high value while leaving the others low, and see what happens. Note that setting any of the three parameters to zero will cause the filter to become a very slow no-op.
+:{{Par2|clip|clip|}}
-TemporalSoften smooths luma and chroma separately, but SpatialSoften smooths only if both luma and chroma have passed the threshold.
+:{{Par2|radius|int|}}
-The SpatialSoften filter work only with YUY2 input. You can use the [[ConvertToYUY2]] filter if your input is not in YUY2 format. Note that large values for radius (>32) will cause AviSynth to crash.
+:{{Par2|luma_threshold, chroma_threshold|int|}}
-*Added ''scenechange=n'' parameter: Using this parameter will avoid blending across scene changes. 'n' defines the maximum average pixel change between frames. Good values for 'n' are between 5 and 30. Requires [[ISSE]].
+{{FuncDefH4|TemporalSoften}}
-*An optional ''mode=2'' parameter: It has a new and better way of blending frame and provides better quality. It is also much faster.  ''mode=1'' is default operation, and works as always.
+{{FuncDef
-[Good initial values: TemporalSoften(4,4,8,15,2)]
+Blends corresponding pixels in neighboring frames. All frames no more than {{FuncArg|radius}} away are examined. Blending occurs only if corresponding pixels are within {{FuncArg|luma_threshold}} or {{FuncArg|chroma_threshold}}, as explained below.
-'''Changes:'''
+:{{Par2|clip|clip|}}
 {| border="1"
 |-

Raffriff42: added category

2015-11-08T15:06:18Z

added category

← Older revision		Revision as of 17:06, 8 November 2015
Line 28:		Line 28:

	[[Category:Internal filters]]		[[Category:Internal filters]]
			[[Category:Spatial-Temporal_Denoisers]]

Admin: 1 revision

2013-05-09T15:02:23Z

1 revision

New page

{{Template:Func2Def|SpatialSoften(clip ''clip'', int ''radius'', int ''luma_threshold'', int ''chroma_threshold'')|TemporalSoften(clip ''clip'', int ''radius'', int ''luma_threshold'', int ''chroma_threshold'' [, int ''scenechange''] [, int ''mode''])}}

The SpatialSoften and TemporalSoften filters remove noise from a video clip by selectively blending pixels. These filters can work miracles, and I highly encourage you to try them. But they can also wipe out fine detail if set too high, so don't go overboard. And they are very slow, especially with a large value of radius, so don't turn them on until you've got everything else ready.

TemporalSoften is similar to SpatialSoften, except that it looks at the same pixel in nearby frames, instead of nearby pixels in the same frame. All frames no more than radius away are examined. This filter doesn't seem to be as effective as SpatialSoften.

I encourage you to play around with the parameters for these filters to get an idea of what they do--for example, try setting one of the three parameters to a very high value while leaving the others low, and see what happens. Note that setting any of the three parameters to zero will cause the filter to become a very slow no-op.

TemporalSoften smooths luma and chroma separately, but SpatialSoften smooths only if both luma and chroma have passed the threshold.

The SpatialSoften filter work only with YUY2 input. You can use the [[ConvertToYUY2]] filter if your input is not in YUY2 format. Note that large values for radius (>32) will cause AviSynth to crash.

Starting from v2.5 two options are added to TemporalSoften:

*Added ''scenechange=n'' parameter: Using this parameter will avoid blending across scene changes. 'n' defines the maximum average pixel change between frames. Good values for 'n' are between 5 and 30. Requires [[ISSE]].
*An optional ''mode=2'' parameter: It has a new and better way of blending frame and provides better quality. It is also much faster. ''mode=1'' is default operation, and works as always.

[Good initial values: TemporalSoften(4,4,8,15,2)]

'''Changes:'''

{| border="1"
|-
| v2.56
| TemporalSoften working also with RGB32 input (as well as YV12, YUY2)
|}

[[Category:Internal filters]]