GeneralConvolution - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-17T17:23:57Z

add link to avs+ documentation

← Older revision		Revision as of 19:23, 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/convolution.html https://avisynthplus.readthedocs.io]
			</div>


	Performs a matrix convolution on an [[RGB32]] ({{AvsPluscon}} any format) clip.		Performs a matrix convolution on an [[RGB32]] ({{AvsPluscon}} any format) clip.

Pinterf: GeneralConvolution Supported colorspaces

2018-12-19T11:49:26Z

GeneralConvolution Supported colorspaces

← Older revision		Revision as of 13:49, 19 December 2018
Line 1:		Line 1:
	Performs a matrix convolution on an [[RGB32]] clip.		Performs a matrix convolution on an [[RGB32]] ({{AvsPluscon}} any format) clip.

	== Syntax and Parameters ==		== Syntax and Parameters ==

Pinterf: /* Changelog */ Avs+2768

2018-12-19T11:46:47Z

Changelog: Avs+2768

← Older revision		Revision as of 13:46, 19 December 2018
Line 124:		Line 124:
	== Changelog ==		== Changelog ==
	{\| border="1"		{\| border="1"
			\|-
			\| {{AvsPluscon}} r2768
			\| Supports all color spaces, added 7x7 and 9x9 matrix sizes, added luma, chroma, alpha
	\|-		\|-
	\| v2.55		\| v2.55

Pinterf: /* Syntax and Parameters */ New parameters and matrix sizes

2018-12-19T11:40:33Z

Syntax and Parameters: New parameters and matrix sizes

← Older revision		Revision as of 13:40, 19 December 2018
Line 5:		Line 5:
	{{Template:FuncDef		{{Template:FuncDef
	\|GeneralConvolution (clip ''clip'', [ int ''bias'', string ''matrix'', float ''divisor'', bool ''auto'' ] )		\|GeneralConvolution (clip ''clip'', [ int ''bias'', string ''matrix'', float ''divisor'', bool ''auto'' ] )
			}}

			{{AvsPluscon}}
			{{Template:FuncDef
			\|GeneralConvolution (clip ''clip'', [ float ''bias'', string ''matrix'', float ''divisor'', bool ''auto'', bool ''luma'', bool ''chroma'', bool ''alpha'' ] )
	}}		}}

	:{{Par2\|clip\|clip\|}}		:{{Par2\|clip\|clip\|}}
	::Source clip. Must be [[RGB32]].		::Source clip. Must be [[RGB32]]. {{AvsPluscon}} All color spaces since Avisynth+ r2768.

	:{{Par2\|bias\|int\|0}}		:{{Par2\|bias\|int\|0}} {{AvsPluscon}} {{Par2\|bias\|float\|0.0}}
	::Additive bias to adjust the total output intensity.		::Additive bias to adjust the total output intensity.

	:{{Par2\|matrix\|string\|"0 0 0 0 1 0 0 0 0"}}		:{{Par2\|matrix\|string\|"0 0 0 0 1 0 0 0 0"}}
	::A 3×3 or 5×5 matrix with 3<sup>2</sup> (9) or 5<sup>2</sup> (25) integer values.		::A 3×3 or 5×5 matrix with 3<sup>2</sup> (9) or 5<sup>2</sup> (25) integer values.
			::{{AvsPluscon}} A 3×3, 5×5, 7×7 or 9×9 matrix with 3<sup>2</sup> (9), 5<sup>2</sup> (25), 7<sup>2</sup> (49), 9<sup>2</sup> (81) float or integer values. float values are converted to integers for 8-16 bit clips

	:{{Par2\|divisor\|float\|1.0}}		:{{Par2\|divisor\|float\|1.0}}
Line 22:		Line 28:
	::Enables ''auto scaling''. Auto scaling divides the output of the convolution by the sum of the elements of the matrix. The value of {{FuncArg\|divisor}} is applied in addition to this auto scaling factor. If the sum of elements is zero, auto scaling is disabled.		::Enables ''auto scaling''. Auto scaling divides the output of the convolution by the sum of the elements of the matrix. The value of {{FuncArg\|divisor}} is applied in addition to this auto scaling factor. If the sum of elements is zero, auto scaling is disabled.

	The {{FuncArg\|divisor}} is usually the sum of the elements of the matrix. But when the sum is zero, you can leave {{FuncArg\|divisor}}=1 and use the {{FuncArg\|bias}} setting to correct the pixel values. The {{FuncArg\|bias}} could be useful if the pixel values are negative due to the convolution. After adding {{FuncArg\|bias}}, the pixels are clipped to the range 0-255.		:{{AvsPluscon}}
			:{{Par2\|luma\|bool\|true}}
			:{{Par2\|chroma\|bool\|true}}
			:{{Par2\|alpha\|bool\|true}}
			::Enables processing only selected planes. For RGB clips {{FuncArg\|luma}} and {{FuncArg\|chroma}} setting is ignored. Unprocessed planes are simply copied. E.g. alpha=false can speed up RGB32 processing, usually A channel is not used.

			The {{FuncArg\|divisor}} is usually the sum of the elements of the matrix. But when the sum is zero, you can leave {{FuncArg\|divisor}}=1 and use the {{FuncArg\|bias}} setting to correct the pixel values. The {{FuncArg\|bias}} could be useful if the pixel values are negative due to the convolution. After adding {{FuncArg\|bias}}, the pixels are clipped to the range 0-255 {{AvsPluscon}} or the appropriate min-max range of the specific bit depth. In 32 bit float formats no clamp happens.

	Around the borders the edge pixels are simply repeated to service the matrix.		Around the borders the edge pixels are simply repeated to service the matrix.
	</div>		</div>


	== Examples ==		== Examples ==

Chanijean: /* External Links */ link is back up :^)

2018-10-06T20:02:15Z

External Links: link is back up :^)

← Older revision		Revision as of 22:02, 6 October 2018
Line 108:		Line 108:

	== External Links ==		== External Links ==
	* [~~http://web.archive.org/web/20120802031716/http~~://jeanbruenn.info/2011/03/13/avisynths-convolution-stuff-explained/ ''AviSynth’s GeneralConvolution explained'']		* [https://jeanbruenn.info/2011/03/13/avisynths-convolution-stuff-explained/ ''AviSynth’s GeneralConvolution explained'']
	* Some other examples can be found [http://web.archive.org/web/20100105183639/http://www.gamedev.net/reference/programming/features/imageproc/page2.asp here].		* Some other examples can be found [http://web.archive.org/web/20100105183639/http://www.gamedev.net/reference/programming/features/imageproc/page2.asp here].

Raffriff42: one more touch-up

2016-02-14T13:15:00Z

one more touch-up

← Older revision		Revision as of 15:15, 14 February 2016
Line 2:		Line 2:

	== Syntax and Parameters ==		== Syntax and Parameters ==
			<div style="max-width:68em" >
	{{Template:FuncDef		{{Template:FuncDef
	\|GeneralConvolution (clip ''clip'', [ int ''bias'', string ''matrix'', float ''divisor'', bool ''auto'' ] )		\|GeneralConvolution (clip ''clip'', [ int ''bias'', string ''matrix'', float ''divisor'', bool ''auto'' ] )
Line 24:		Line 25:

	Around the borders the edge pixels are simply repeated to service the matrix.		Around the borders the edge pixels are simply repeated to service the matrix.
			</div>

Raffriff42: formatting, links, phrasing

2016-02-14T13:13:58Z

formatting, links, phrasing

Show changes

Raffriff42: added category

2015-11-08T15:04:11Z

added category

← Older revision		Revision as of 17:04, 8 November 2015
Line 107:		Line 107:
	* [http://web.archive.org/web/20120802031716/http://jeanbruenn.info/2011/03/13/avisynths-convolution-stuff-explained/ AviSynth’s GeneralConvolution explained]		* [http://web.archive.org/web/20120802031716/http://jeanbruenn.info/2011/03/13/avisynths-convolution-stuff-explained/ AviSynth’s GeneralConvolution explained]
	[[Category:Internal filters]]		[[Category:Internal filters]]
			[[Category:Blurring]]
			[[Category:Sharpeners]]

Reel.Deal: /* External Links */ fix dead link

2015-01-01T14:04:41Z

External Links: fix dead link

← Older revision		Revision as of 16:04, 1 January 2015
Line 105:		Line 105:
	<br>		<br>
	== External Links ==		== External Links ==
	* [http://jeanbruenn.info/2011/03/13/avisynths-convolution-stuff-explained/ AviSynth’s GeneralConvolution explained]		* [http://web.archive.org/web/20120802031716/http://jeanbruenn.info/2011/03/13/avisynths-convolution-stuff-explained/ AviSynth’s GeneralConvolution explained]
	[[Category:Internal filters]]		[[Category:Internal filters]]

Reel.Deal: add external links

2014-09-15T17:32:17Z

add external links

← Older revision		Revision as of 19:32, 15 September 2014
Line 92:		Line 92:

	Some other examples can be found [http://web.archive.org/web/20100105183639/http://www.gamedev.net/reference/programming/features/imageproc/page2.asp here].		Some other examples can be found [http://web.archive.org/web/20100105183639/http://www.gamedev.net/reference/programming/features/imageproc/page2.asp here].


	'''Changelog''':		'''Changelog''':
Line 102:		Line 103:
	\| Initial Release		\| Initial Release
	\|}		\|}
			<br>
			== External Links ==
			* [http://jeanbruenn.info/2011/03/13/avisynths-convolution-stuff-explained/ AviSynth’s GeneralConvolution explained]
	[[Category:Internal filters]]		[[Category:Internal filters]]