Blur - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-17T17:16:44Z

add link to avs+ documentation

← Older revision		Revision as of 19:16, 17 September 2022
Line 1:		Line 1:
			<div {{BlueBox2\|40\|0\|3px solid purple}} >
			{{AvsPlusFullname}}<br>
			Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/blur.html https://avisynthplus.readthedocs.io]
			</div>


	{{Func2Def		{{Func2Def
	\|Blur(clip ''clip'', float ''amount'', bool ''MMX'')		\|Blur(clip ''clip'', float ''amount'', bool ''MMX'')

Admin: /* Developer notes */

2016-03-16T17:44:12Z

Developer notes

← Older revision		Revision as of 19:44, 16 March 2016
Line 41:		Line 41:
	==== Developer notes ====		==== Developer notes ====
	'''Blur''' uses the kernel [(1−1/2^amount)/2, 1/2^amount, (1−1/2^amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a (1/3,1/3,1/3) kernel. A value of 1.0 gets you a (1/4,1/2,1/4) kernel for example.		'''Blur''' uses the kernel [(1−1/2^amount)/2, 1/2^amount, (1−1/2^amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a (1/3,1/3,1/3) kernel. A value of 1.0 gets you a (1/4,1/2,1/4) kernel for example.
	Likewise Blur(1.0).Blur(1.0) is a convolution of the kernel (1/4,1/2,1/4) with itself, ~~that is~~ a (1/4,1/2,1/4)*(1/4,1/2,1/4) = (1/16,4/16,6/16,4/16,1/16) kernel. It can be read of [https://en.wikipedia.org/wiki/Pascal's_triangle Pascal's triangle].		Likewise Blur(1.0).Blur(1.0) is a convolution of the kernel (1/4,1/2,1/4) with itself, being a (1/4,1/2,1/4)*(1/4,1/2,1/4) = (1/16,4/16,6/16,4/16,1/16) kernel. It can be read of [https://en.wikipedia.org/wiki/Pascal's_triangle Pascal's triangle].


	==== Changes ====		==== Changes ====

Admin at 17:43, 16 March 2016

2016-03-16T17:43:45Z

← Older revision		Revision as of 19:43, 16 March 2016
Line 24:		Line 24:
	{{Par2\|amountV\|float\|(amountH)}}		{{Par2\|amountV\|float\|(amountH)}}
	:You can use 2 arguments to set independent vertical and horizontal blurring or sharpening: for example,		:You can use 2 arguments to set independent vertical and horizontal blurring or sharpening: for example,
	::<code>Blur(0,1) </code>		::<code>Blur(0,1)</code>
	:will blur vertical only, perhaps to blend interlaced lines together.		:will blur vertical only, perhaps to blend interlaced lines together.

Line 37:		Line 37:

	Chaining calls to '''Sharpen''' is not a good idea, as the image quickly deteriorates.		Chaining calls to '''Sharpen''' is not a good idea, as the image quickly deteriorates.


			==== Developer notes ====
			'''Blur''' uses the kernel [(1−1/2^amount)/2, 1/2^amount, (1−1/2^amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a (1/3,1/3,1/3) kernel. A value of 1.0 gets you a (1/4,1/2,1/4) kernel for example.
			Likewise Blur(1.0).Blur(1.0) is a convolution of the kernel (1/4,1/2,1/4) with itself, that is a (1/4,1/2,1/4)*(1/4,1/2,1/4) = (1/16,4/16,6/16,4/16,1/16) kernel. It can be read of [https://en.wikipedia.org/wiki/Pascal's_triangle Pascal's triangle].

Raffriff42: formatting, links, phrasing * see talk page *

2016-01-28T05:49:36Z

formatting, links, phrasing *** see talk page ***

@@ Line 1: / Line 1: @@
-{{Template:Func4Def|Blur(clip ''clip'', float ''amount'', bool ''MMX'')|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')}}
+{{Func2Def
-This is a simple 3x3-kernel blurring filter using the kernel [(1−1/2^amount)/2, 1/2^amount, (1−1/2^amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a ({{Frac|1|3}}, {{Frac|1|3}}, {{Frac|1|3}}) kernel. A value of 1.0 gets you a ({{Frac|1|4}}, {{Frac|1|2}}, {{Frac|1|4}}) kernel. If you want a large-radius Gaussian blur, I recommend chaining several copies of Blur(1.0) together. (Anybody remember Pascal's triangle?)
+:A 3×3 [[Wikipedia:Kernel_(image_processing)|kernel]] blurring filter.
-You can use 2 arguments to set independent Vertical and Horizontal amounts. Like this, you can use Blur(0,1) to filter only Vertically, for example to blend interlaced lines together. By default ''amountV''=''amountH''.
+{{Func2Def
-'''Changes'''
+:A 3×3 kernel sharpening filter; the inverse of '''Blur'''.
 {| border=1 cellspacing=1 cellpadding=4
 | v2.58

Raffriff42: added category

2015-11-08T15:03:03Z

added category

← Older revision		Revision as of 17:03, 8 November 2015
Line 18:		Line 18:

	[[Category:Internal filters]]		[[Category:Internal filters]]
			[[Category:Blurring]]

Admin at 17:38, 30 December 2014

2014-12-30T17:38:40Z

← Older revision		Revision as of 19:38, 30 December 2014
Line 1:		Line 1:
	{{Template:Func4Def\|Blur(clip ''clip'', float ''amount'', bool ''MMX'')\|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')\|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')\|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')}}		{{Template:Func4Def\|Blur(clip ''clip'', float ''amount'', bool ''MMX'')\|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')\|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')\|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')}}

	This is a simple 3x3-kernel blurring filter using the kernel [(~~1−2~~^~~−amount~~)/2, 2^~~−amount~~, (~~1−2~~^~~−amount~~)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a ({{Frac\|1\|3}}, {{Frac\|1\|3}}, {{Frac\|1\|3}}) kernel. A value of 1.0 gets you a ({{Frac\|1\|4}}, {{Frac\|1\|2}}, {{Frac\|1\|4}}) kernel. If you want a large-radius Gaussian blur, I recommend chaining several copies of Blur(1.0) together. (Anybody remember Pascal's triangle?)		This is a simple 3x3-kernel blurring filter using the kernel [(1−1/2^amount)/2, 1/2^amount, (1−1/2^amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a ({{Frac\|1\|3}}, {{Frac\|1\|3}}, {{Frac\|1\|3}}) kernel. A value of 1.0 gets you a ({{Frac\|1\|4}}, {{Frac\|1\|2}}, {{Frac\|1\|4}}) kernel. If you want a large-radius Gaussian blur, I recommend chaining several copies of Blur(1.0) together. (Anybody remember Pascal's triangle?)

	Negative arguments to Blur actually sharpen the image, and in fact Sharpen(n) is just an alias for Blur(-n). The smallest allowable argument to Blur is -1.0 and the largest to Sharpen is 1.0.		Negative arguments to Blur actually sharpen the image, and in fact Sharpen(n) is just an alias for Blur(-n). The smallest allowable argument to Blur is -1.0 and the largest to Sharpen is 1.0.

Admin at 17:37, 30 December 2014

2014-12-30T17:37:48Z

← Older revision		Revision as of 19:37, 30 December 2014
Line 1:		Line 1:
	{{Template:Func4Def\|Blur(clip ''clip'', float ''amount'', bool ''MMX'')\|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')\|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')\|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')}}		{{Template:Func4Def\|Blur(clip ''clip'', float ''amount'', bool ''MMX'')\|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')\|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')\|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')}}

	This is a simple 3x3-kernel blurring ~~[[Internal_filters\|~~filter]] using the kernel [(1−2^−amount)/2, 2^−amount, (1−2^−amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a ({{Frac\|1\|3}}, {{Frac\|1\|3}}, {{Frac\|1\|3}}) kernel. A value of 1.0 gets you a ({{Frac\|1\|4}}, {{Frac\|1\|2}}, {{Frac\|1\|4}}) kernel. If you want a large-radius Gaussian blur, I recommend chaining several copies of Blur(1.0) together. (Anybody remember Pascal's triangle?)		This is a simple 3x3-kernel blurring filter using the kernel [(1−2^−amount)/2, 2^−amount, (1−2^−amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a ({{Frac\|1\|3}}, {{Frac\|1\|3}}, {{Frac\|1\|3}}) kernel. A value of 1.0 gets you a ({{Frac\|1\|4}}, {{Frac\|1\|2}}, {{Frac\|1\|4}}) kernel. If you want a large-radius Gaussian blur, I recommend chaining several copies of Blur(1.0) together. (Anybody remember Pascal's triangle?)

	Negative arguments to Blur actually sharpen the image, and in fact Sharpen(n) is just an alias for Blur(-n). The smallest allowable argument to Blur is -1.0 and the largest to Sharpen is 1.0.		Negative arguments to Blur actually sharpen the image, and in fact Sharpen(n) is just an alias for Blur(-n). The smallest allowable argument to Blur is -1.0 and the largest to Sharpen is 1.0.

Admin at 17:37, 30 December 2014

2014-12-30T17:37:34Z

← Older revision		Revision as of 19:37, 30 December 2014
Line 1:		Line 1:
	{{Template:Func4Def\|Blur(clip ''clip'', float ''amount'', bool ''MMX'')\|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')\|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')\|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')}}		{{Template:Func4Def\|Blur(clip ''clip'', float ''amount'', bool ''MMX'')\|Blur(clip, float ''amountH'', float ''amountV'', bool ''MMX'')\|Sharpen(clip ''clip'', float ''amount'', bool ''MMX'')\|Sharpen(clip, float ''amountH'', float ''amountV'', bool ''MMX'')}}

	This is a simple 3x3-kernel blurring [[Internal_filters\|filter]]. The largest allowable argument for Blur is about 1.58, which corresponds to a ({{Frac\|1\|3}}, {{Frac\|1\|3}}, {{Frac\|1\|3}}) kernel. A value of 1.0 gets you a ({{Frac\|1\|4}}, {{Frac\|1\|2}}, {{Frac\|1\|4}}) kernel. If you want a large-radius Gaussian blur, I recommend chaining several copies of Blur(1.0) together. (Anybody remember Pascal's triangle?)		This is a simple 3x3-kernel blurring [[Internal_filters\|filter]] using the kernel [(1−2^−amount)/2, 2^−amount, (1−2^−amount)/2]. The largest allowable argument for Blur is log2(3) (which is about 1.58), which corresponds to a ({{Frac\|1\|3}}, {{Frac\|1\|3}}, {{Frac\|1\|3}}) kernel. A value of 1.0 gets you a ({{Frac\|1\|4}}, {{Frac\|1\|2}}, {{Frac\|1\|4}}) kernel. If you want a large-radius Gaussian blur, I recommend chaining several copies of Blur(1.0) together. (Anybody remember Pascal's triangle?)

	Negative arguments to Blur actually sharpen the image, and in fact Sharpen(n) is just an alias for Blur(-n). The smallest allowable argument to Blur is -1.0 and the largest to Sharpen is 1.0.		Negative arguments to Blur actually sharpen the image, and in fact Sharpen(n) is just an alias for Blur(-n). The smallest allowable argument to Blur is -1.0 and the largest to Sharpen is 1.0.

Admin: note to myself - correct offline docs too

2014-09-21T18:24:17Z

note to myself - correct offline docs too

← Older revision		Revision as of 20:24, 21 September 2014
Line 11:		Line 11:
	{\| border=1 cellspacing=1 cellpadding=4		{\| border=1 cellspacing=1 cellpadding=4
	\| v2.58		\| v2.58
	\| MMX routines fixed (have full 8 bit precision); mmx=true by default		\| MMX routines fixed (have full 8 bit precision now); mmx=true by default
	\|-		\|-
	\| v2.57		\| v2.57

Admin at 18:23, 21 September 2014

2014-09-21T18:23:46Z

← Older revision		Revision as of 20:23, 21 September 2014
Line 6:		Line 6:

	You can use 2 arguments to set independent Vertical and Horizontal amounts. Like this, you can use Blur(0,1) to filter only Vertically, for example to blend interlaced lines together. By default ''amountV''=''amountH''.		You can use 2 arguments to set independent Vertical and Horizontal amounts. Like this, you can use Blur(0,1) to filter only Vertically, for example to blend interlaced lines together. By default ''amountV''=''amountH''.

	~~A Known issue, with the MMX routines is the lack of full 8 bit precision in the calculations.{{Citation_needed}} This can lead to banding in the resultant image. Set~~

	~~The ''MMX''=False option was originally to work around an MMX limitation, but this problem no longer exists. By default, ''MMX''=True.~~

	'''Changes'''		'''Changes'''

	{\| border=1 cellspacing=1 cellpadding=4		{\| border=1 cellspacing=1 cellpadding=4
			\| v2.58
			\| MMX routines fixed (have full 8 bit precision); mmx=true by default
			\|-
	\| v2.57		\| v2.57
	\| added MMX option		\| added MMX option

Blur - Revision history

Reel.Deal: add link to avs+ documentation

Admin: /* Developer notes */

Admin at 17:43, 16 March 2016

Raffriff42: formatting, links, phrasing *** see talk page ***

Raffriff42: added category

Admin at 17:38, 30 December 2014

Admin at 17:37, 30 December 2014

Admin at 17:37, 30 December 2014

Admin: note to myself - correct offline docs too

Admin at 18:23, 21 September 2014

Raffriff42: formatting, links, phrasing * see talk page *