Tweak - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-17T07:40:38Z

add link to avs+ documentation

← Older revision		Revision as of 09:40, 17 September 2022
Line 1:		Line 1:
	<div style="max-width:82em; min-width:42em;" >		<div style="max-width:82em; min-width:42em;" >
	{{AvsStarFilter}}<div style="max-width:62em" >		{{AvsStarFilter}}<div style="max-width:62em" >

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


	Adjust hue, saturation, brightness, and contrast of a video clip.		Adjust hue, saturation, brightness, and contrast of a video clip.

Raffriff42: note AVS+ differences, continued

2017-04-28T20:25:14Z

note AVS+ differences, continued

← Older revision		Revision as of 22:25, 28 April 2017
Line 6:		Line 6:
	</div>		</div>

	{{AvsPluscon}} adds new [[#realcalc\|{{FuncArg\|realcalc}}]] and [[#dstrength\|{{FuncArg\|dither_strength}}]] parameters.		{{AvsPluscon}} adds new [[#realcalc\|{{FuncArg\|realcalc}}]] and [[#dstrength\|{{FuncArg\|dither_strength}}]] parameters. <br>
			{{AvsPluscon}} all parameters are [[Autoscale_parameter\|autoscaling]] – they work without changes at all bit depths.

			__TOC__
	== Syntax and Parameters ==		== Syntax and Parameters ==
	<div style="max-width:62em" >		<div style="max-width:62em" >
Line 25:		Line 26:
	bool ''realcalc'', float ''dither_strength'' ] ) {{AvsPluscon}}		bool ''realcalc'', float ''dither_strength'' ] ) {{AvsPluscon}}
	}}		}}

			:{{Par2\| \|clip\| \|}}
			::Input clip. [[YUV]] data only (no [[RGB]]).

	:{{Par2\|hue\|float\|0.0}}		:{{Par2\|hue\|float\|0.0}}
Line 109:		Line 113:
	::The hue and saturation will be adjusted for image values in the range [{{FuncArg\|minSat}}, {{FuncArg\|maxSat}}].		::The hue and saturation will be adjusted for image values in the range [{{FuncArg\|minSat}}, {{FuncArg\|maxSat}}].

	::Practically speaking, the percentage saturation of a pixel will be in the range [0, 100], since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119 in units of chroma). An overshoot (up to 150%) is allowed for non-valid RGB pixels (150% corresponds to U=V=255, which has a saturation of ~~sqrt~~(127<sup>2</sup>+127<sup>2</sup>) = 180). Thus when using the default values all pixels will be processed.		::Practically speaking, the percentage saturation of a pixel will be in the range [0, 100], since these correspond to valid RGB pixels (100% corresponds to R=255{{D}}, G=B=0{{D}}, which has a saturation of 119 in units of chroma). An overshoot (up to 150%) is allowed for non-valid RGB pixels (150% corresponds to U=V=255{{D}}, which has a saturation of √(127<sup>2</sup>+127<sup>2</sup>) = 180). Thus when using the default values all pixels will be processed.
	~~::{{AvsPluscon}} [[TODO]] needs documentation of behavior with {{Deep_color}} formats~~.

	::Range 0 to 150; default 150, 0; {{FuncArg\|minSat}} must be less than {{FuncArg\|maxSat}}		::Range 0 to 150; default 150, 0; {{FuncArg\|minSat}} must be less than {{FuncArg\|maxSat}}
Line 204:		Line 207:
	Tweak(hue=-33)		Tweak(hue=-33)
	# Now: U corresponds to I, V corresponds to Q		# Now: U corresponds to I, V corresponds to Q
	# could also have used: FlipHorizontal(clip).Tweak(hue=57) (see [http://forum.videohelp.com/threads/377237-Purple-green-VHS?p=2435970&viewfull=1#post2435970 forum.videohelp.com])		# could also have used: FlipHorizontal(clip).Tweak(hue=57)
			# (see [http://forum.videohelp.com/threads/377237-Purple-green-VHS?p=2435970&viewfull=1#post2435970 forum.videohelp.com])
	}		}

Raffriff42: Use Template:Deep_color

2017-04-28T02:43:18Z

Use Template:Deep_color

← Older revision		Revision as of 04:43, 28 April 2017
Line 110:		Line 110:

	::Practically speaking, the percentage saturation of a pixel will be in the range [0, 100], since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119 in units of chroma). An overshoot (up to 150%) is allowed for non-valid RGB pixels (150% corresponds to U=V=255, which has a saturation of sqrt(127<sup>2</sup>+127<sup>2</sup>) = 180). Thus when using the default values all pixels will be processed.		::Practically speaking, the percentage saturation of a pixel will be in the range [0, 100], since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119 in units of chroma). An overshoot (up to 150%) is allowed for non-valid RGB pixels (150% corresponds to U=V=255, which has a saturation of sqrt(127<sup>2</sup>+127<sup>2</sup>) = 180). Thus when using the default values all pixels will be processed.
	::{{AvsPluscon}} [[TODO]] needs documentation of behavior ~~at high bit depth~~.		::{{AvsPluscon}} [[TODO]] needs documentation of behavior with {{Deep_color}} formats.

	::Range 0 to 150; default 150, 0; {{FuncArg\|minSat}} must be less than {{FuncArg\|maxSat}}		::Range 0 to 150; default 150, 0; {{FuncArg\|minSat}} must be less than {{FuncArg\|maxSat}}
Line 124:		Line 124:
	{{HiddenAnchor\|realcalc}}		{{HiddenAnchor\|realcalc}}
	:{{Par2\|realcalc\|bool\|false}}		:{{Par2\|realcalc\|bool\|false}}
	::{{AvsPluscon}} When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain ~~high bit depths~~) ([[TODO]] - clarify)		::{{AvsPluscon}} When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain {{Deep_color}} formats) ([[TODO]] - clarify)

	{{HiddenAnchor\|dstrength}}		{{HiddenAnchor\|dstrength}}

Raffriff42: tweak appearance

2017-04-23T09:03:56Z

tweak appearance

← Older revision		Revision as of 11:03, 23 April 2017
Line 23:		Line 23:
	bool ''coring'', bool ''sse'', float ''startHue'', float ''endHue'', <br>		bool ''coring'', bool ''sse'', float ''startHue'', float ''endHue'', <br>
	float ''maxSat'', float ''minSat'', float ''interp'', bool ''dither'', <br>		float ''maxSat'', float ''minSat'', float ''interp'', bool ''dither'', <br>
	bool ''realcalc'', float ''dither_strength'' ] ){{AvsPluscon}}		bool ''realcalc'', float ''dither_strength'' ] ) {{AvsPluscon}}
	}}		}}

Line 110:		Line 110:

	::Practically speaking, the percentage saturation of a pixel will be in the range [0, 100], since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119 in units of chroma). An overshoot (up to 150%) is allowed for non-valid RGB pixels (150% corresponds to U=V=255, which has a saturation of sqrt(127<sup>2</sup>+127<sup>2</sup>) = 180). Thus when using the default values all pixels will be processed.		::Practically speaking, the percentage saturation of a pixel will be in the range [0, 100], since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119 in units of chroma). An overshoot (up to 150%) is allowed for non-valid RGB pixels (150% corresponds to U=V=255, which has a saturation of sqrt(127<sup>2</sup>+127<sup>2</sup>) = 180). Thus when using the default values all pixels will be processed.
	::{{AvsPluscon}}[[TODO]] needs documentation of behavior at high bit depth.		::{{AvsPluscon}} [[TODO]] needs documentation of behavior at high bit depth.

	::Range 0 to 150; default 150, 0; {{FuncArg\|minSat}} must be less than {{FuncArg\|maxSat}}		::Range 0 to 150; default 150, 0; {{FuncArg\|minSat}} must be less than {{FuncArg\|maxSat}}
Line 124:		Line 124:
	{{HiddenAnchor\|realcalc}}		{{HiddenAnchor\|realcalc}}
	:{{Par2\|realcalc\|bool\|false}}		:{{Par2\|realcalc\|bool\|false}}
	::{{AvsPluscon}}When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain high bit depths) ([[TODO]] - clarify)		::{{AvsPluscon}} When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain high bit depths) ([[TODO]] - clarify)

	{{HiddenAnchor\|dstrength}}		{{HiddenAnchor\|dstrength}}
	:{{Par2\|dither_strength\|float\|1.0}}		:{{Par2\|dither_strength\|float\|1.0}}
	::{{AvsPluscon}}Control dithering amount.		::{{AvsPluscon}} Control dithering amount.
	::For example, {{FuncArg\|dither_strength}}=1.0 adds ±0.5 amplitude dither on the 0..255 range, and scaled in proportion for other ranges. ([[TODO]] - confirm)		::For example, {{FuncArg\|dither_strength}}=1.0 adds ±0.5 amplitude dither on the 0..255 range, and scaled in proportion for other ranges. ([[TODO]] - confirm)
	</div>		</div>

Raffriff42: tweak appearance

2017-04-23T00:27:17Z

tweak appearance

← Older revision		Revision as of 02:27, 23 April 2017
Line 123:		Line 123:

	{{HiddenAnchor\|realcalc}}		{{HiddenAnchor\|realcalc}}
	:{{Par2\|realcalc\|bool\|false{{AvsPluscon}} }}		:{{Par2\|realcalc\|bool\|false}}
	::When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain high bit depths) ([[TODO]] - clarify)		::{{AvsPluscon}}When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain high bit depths) ([[TODO]] - clarify)

	{{HiddenAnchor\|dstrength}}		{{HiddenAnchor\|dstrength}}
	:{{Par2\|dither_strength\|float\|1.0{{AvsPluscon}} }}		:{{Par2\|dither_strength\|float\|1.0}}
			::{{AvsPluscon}}Control dithering amount.
	::For example, {{FuncArg\|dither_strength}}=1.0 adds ±0.5 amplitude dither on the 0..255 range, and scaled in proportion for other ranges. ([[TODO]] - confirm)		::For example, {{FuncArg\|dither_strength}}=1.0 adds ±0.5 amplitude dither on the 0..255 range, and scaled in proportion for other ranges. ([[TODO]] - confirm)
	</div>		</div>

Raffriff42: note AVS+ differences * WIP *

2017-04-22T00:49:41Z

note AVS+ differences *** WIP ***

← Older revision		Revision as of 02:49, 22 April 2017
Line 1:		Line 1:
	<div style="max-width:62em" >		<div style="max-width:82em; min-width:42em;" >
			{{AvsStarFilter}}<div style="max-width:62em" >
	Adjust hue, saturation, brightness, and contrast of a video clip.		Adjust hue, saturation, brightness, and contrast of a video clip.

	In v2.60, both the saturation and hue can be adjusted for range of saturation from {{FuncArg\|minSat}} to {{FuncArg\|maxSat}} and a range of hue from {{FuncArg\|startHue}} to {{FuncArg\|endHue}}.		In v2.60, both the saturation and hue can be adjusted for range of saturation from {{FuncArg\|minSat}} to {{FuncArg\|maxSat}} and a range of hue from {{FuncArg\|startHue}} to {{FuncArg\|endHue}}.
	</div>		</div>

			{{AvsPluscon}} adds new [[#realcalc\|{{FuncArg\|realcalc}}]] and [[#dstrength\|{{FuncArg\|dither_strength}}]] parameters.


Line 13:		Line 16:
	bool ''coring'', bool ''sse'', float ''startHue'', float ''endHue'', <br>		bool ''coring'', bool ''sse'', float ''startHue'', float ''endHue'', <br>
	float ''maxSat'', float ''minSat'', float ''interp'', bool ''dither'' ] )		float ''maxSat'', float ''minSat'', float ''interp'', bool ''dither'' ] )
			}}

			{{Template:FuncDef
			\|Tweak( clip ''clip'' [, <br>
			float ''hue'', float ''sat'', float ''bright'', float ''cont'', <br>
			bool ''coring'', bool ''sse'', float ''startHue'', float ''endHue'', <br>
			float ''maxSat'', float ''minSat'', float ''interp'', bool ''dither'', <br>
			bool ''realcalc'', float ''dither_strength'' ] ){{AvsPluscon}}
	}}		}}

Line 41:		Line 52:

	:{{Par2\|coring\|bool\|true}}		:{{Par2\|coring\|bool\|true}}
	::When set to true (the default), the luma (Y) ~~is clipped to [16,235]~~ and ~~the~~ chroma ~~(U, V) is~~ clipped to ~~[16,240]~~;		::When set to true (the default), the luma (Y) and chroma are clipped to TV-range;
	::When set to false, the luma and chroma are unconstrained.		::When set to false, the luma and chroma are unconstrained.

Line 99:		Line 110:

	::Practically speaking, the percentage saturation of a pixel will be in the range [0, 100], since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119 in units of chroma). An overshoot (up to 150%) is allowed for non-valid RGB pixels (150% corresponds to U=V=255, which has a saturation of sqrt(127<sup>2</sup>+127<sup>2</sup>) = 180). Thus when using the default values all pixels will be processed.		::Practically speaking, the percentage saturation of a pixel will be in the range [0, 100], since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119 in units of chroma). An overshoot (up to 150%) is allowed for non-valid RGB pixels (150% corresponds to U=V=255, which has a saturation of sqrt(127<sup>2</sup>+127<sup>2</sup>) = 180). Thus when using the default values all pixels will be processed.
			::{{AvsPluscon}}[[TODO]] needs documentation of behavior at high bit depth.

	::Range 0 to 150; default 150, 0; {{FuncArg\|minSat}} must be less than {{FuncArg\|maxSat}}		::Range 0 to 150; default 150, 0; {{FuncArg\|minSat}} must be less than {{FuncArg\|maxSat}}
Line 109:		Line 121:
	:{{Par2\|dither\|bool\|false}}		:{{Par2\|dither\|bool\|false}}
	::When true, [[ordered dithering]] is applied when doing the adjustment. (default false)		::When true, [[ordered dithering]] is applied when doing the adjustment. (default false)

			{{HiddenAnchor\|realcalc}}
			:{{Par2\|realcalc\|bool\|false{{AvsPluscon}} }}
			::When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain high bit depths) ([[TODO]] - clarify)

			{{HiddenAnchor\|dstrength}}
			:{{Par2\|dither_strength\|float\|1.0{{AvsPluscon}} }}
			::For example, {{FuncArg\|dither_strength}}=1.0 adds ±0.5 amplitude dither on the 0..255 range, and scaled in proportion for other ranges. ([[TODO]] - confirm)
	</div>		</div>

Line 205:		Line 225:
	AviSynth uses the following definitions for hue and saturation:<br>		AviSynth uses the following definitions for hue and saturation:<br>
	As can be seen in the first image above, hue is the angle between the positive V-axis of the chroma plane and the point given by the centralised coordinates (V,U) on it. The saturation is the amplitude of the centralised chroma plane. Mathematically:		As can be seen in the first image above, hue is the angle between the positive V-axis of the chroma plane and the point given by the centralised coordinates (V,U) on it. The saturation is the amplitude of the centralised chroma plane. Mathematically:
	* hue = 180/pi * [https://en.wikipedia.org/wiki/Atan2 atan2]((V-128)/128, (U-128)/128)		* hue = 180/{{Serif\|π}} * [https://en.wikipedia.org/wiki/Atan2 atan2]((V-128)/128, (U-128)/128)
	* sat = ~~sqrt~~((U-128)<sup>2</sup> + (V-128)<sup>2</sup>)		* sat = √((U-128)<sup>2</sup> + (V-128)<sup>2</sup>)


Line 219:		Line 239:
	\| Added dither.		\| Added dither.
	\|}		\|}
			</div>
	</div>		</div>

	[[Category:Internal filters]]		[[Category:Internal filters]]
	[[Category:Levels and Chroma filters]]		[[Category:Levels and Chroma filters]]

Admin at 16:16, 18 March 2016

2016-03-18T16:16:36Z

← Older revision		Revision as of 18:16, 18 March 2016
Line 206:		Line 206:
	As can be seen in the first image above, hue is the angle between the positive V-axis of the chroma plane and the point given by the centralised coordinates (V,U) on it. The saturation is the amplitude of the centralised chroma plane. Mathematically:		As can be seen in the first image above, hue is the angle between the positive V-axis of the chroma plane and the point given by the centralised coordinates (V,U) on it. The saturation is the amplitude of the centralised chroma plane. Mathematically:
	* hue = 180/pi * [https://en.wikipedia.org/wiki/Atan2 atan2]((V-128)/128, (U-128)/128)		* hue = 180/pi * [https://en.wikipedia.org/wiki/Atan2 atan2]((V-128)/128, (U-128)/128)
	* sat = sqrt((U-128)^2 + (V-128)^2)		* sat = sqrt((U-128)<sup>2</sup> + (V-128)<sup>2</sup>)

Admin: /* YUV to YIQ conversion */

2016-03-18T16:10:41Z

YUV to YIQ conversion

← Older revision		Revision as of 18:10, 18 March 2016
Line 168:		Line 168:

	==== YUV to YIQ conversion ====		==== YUV to YIQ conversion ====

	~~todo: fix (see http://forum.videohelp.com/threads/377237-Purple-green-VHS?p=2435970&viewfull=1#post2435970)~~

	The NTSC analog television system used the [[YUV]] color space with the UV axes exchanged and rotated by minus 33 degrees. See [http://www.poynton.com/notes/colour_and_gamma/ColorFAQ.html#RTFToC33 Colour FAQ of Charles Poynton]. Note he gives the reverse transformation (from YIQ to YUV).		The NTSC analog television system used the [[YUV]] color space with the UV axes exchanged and rotated by minus 33 degrees. See [http://www.poynton.com/notes/colour_and_gamma/ColorFAQ.html#RTFToC33 Colour FAQ of Charles Poynton]. Note he gives the reverse transformation (from YIQ to YUV).
Line 177:		Line 175:
	The eye is far more sensitive to detail along the ''I'' axis than along the ''Q'' axis, and NTSC allocated more bandwidth for ''I'' than for ''Q''.		The eye is far more sensitive to detail along the ''I'' axis than along the ''Q'' axis, and NTSC allocated more bandwidth for ''I'' than for ''Q''.

	The Tweak filter can be used to convert YUV to YIQ, where the ''V'' axis represents ''I'' and ''U'' represents ''Q''.		The Tweak filter can be used to convert YUV to YIQ, where the ''U'' axis represents ''I'' and ''V'' represents ''Q''.
	The following example, based on an example at [[Swap]], converts a YUV clip to YIQ, blanks the ''Q'' channel, and converts back to YUV.		The following example, based on an example at [[Swap]], converts a YUV clip to YIQ, blanks the ''Q'' channel, and converts back to YUV. This produces the "orange and teal" color scheme that [http://tvtropes.org/pmwiki/pmwiki.php/Main/OrangeBlueContrast became a cliché].
	This produces the "orange and teal" color scheme that [http://tvtropes.org/pmwiki/pmwiki.php/Main/OrangeBlueContrast became a cliché].
	<div {{BoxWidthIndent\|48\|1}} >		<div {{BoxWidthIndent\|48\|1}} >
	Function YUVtoYIQ(clip clip)		Function YUVtoYIQ(clip clip)
Line 197:		Line 194:
	clip = [[AviSource]](...)		clip = [[AviSource]](...)
	yiqclip = YUVtoYIQ(clip) # convert to YIQ		yiqclip = YUVtoYIQ(clip) # convert to YIQ
	~~u_chroma~~ = [[BlankClip]]([[~~UToY~~]](yiqclip), color=$808080)		v_chroma = [[BlankClip]]([[VToY]](yiqclip), color=$808080)
	[[YToUV]](~~u_chroma,~~ yiqclip.[[~~VToY~~]], yiqclip)		[[YToUV]](yiqclip.[[UToY]], v_chroma, yiqclip)
	YIQtoYUV() # convert back to YUV		YIQtoYUV() # convert back to YUV
	[[AudioDub]](yiqclip)		[[AudioDub]](yiqclip)
Line 204:		Line 201:
	This allows processing the ''I'' and ''Q'' signals separately.		This allows processing the ''I'' and ''Q'' signals separately.
	</div>		</div>


	== Developer notes ==		== Developer notes ==

Admin: need to check changes

2016-03-18T16:03:02Z

need to check changes

← Older revision		Revision as of 18:03, 18 March 2016
Line 171:		Line 171:
	todo: fix (see http://forum.videohelp.com/threads/377237-Purple-green-VHS?p=2435970&viewfull=1#post2435970)		todo: fix (see http://forum.videohelp.com/threads/377237-Purple-green-VHS?p=2435970&viewfull=1#post2435970)

	The NTSC analog television system used the [[YUV]] color space with its axes rotated by 33 degrees, a color space called [[Wikipedia:YIQ\|YIQ]].		The NTSC analog television system used the [[YUV]] color space with the UV axes exchanged and rotated by minus 33 degrees. See [http://www.poynton.com/notes/colour_and_gamma/ColorFAQ.html#RTFToC33 Colour FAQ of Charles Poynton]. Note he gives the reverse transformation (from YIQ to YUV).

			with its axes rotated by 33 degrees, a color space called [[Wikipedia:YIQ\|YIQ]].
	In YIQ, orange and teal are along the in-phase (''I'') axis, while green and magenta are along the quadrature (''Q'') axis.		In YIQ, orange and teal are along the in-phase (''I'') axis, while green and magenta are along the quadrature (''Q'') axis.
	The eye is far more sensitive to detail along the ''I'' axis than along the ''Q'' axis, and NTSC allocated more bandwidth for ''I'' than for ''Q''.		The eye is far more sensitive to detail along the ''I'' axis than along the ''Q'' axis, and NTSC allocated more bandwidth for ''I'' than for ''Q''.
Line 179:		Line 181:
	This produces the "orange and teal" color scheme that [http://tvtropes.org/pmwiki/pmwiki.php/Main/OrangeBlueContrast became a cliché].		This produces the "orange and teal" color scheme that [http://tvtropes.org/pmwiki/pmwiki.php/Main/OrangeBlueContrast became a cliché].
	<div {{BoxWidthIndent\|48\|1}} >		<div {{BoxWidthIndent\|48\|1}} >
	# [~~[AviSource]~~]() ~~etc~~. ~~goes above here~~		Function YUVtoYIQ(clip clip)
			{
			YtoUV(clip.VtoY(), clip.UtoY(), clip) # swap U and V
			Tweak(hue=-33)
			# Now: U corresponds to I, V corresponds to Q
			# could also have used: FlipHorizontal(clip).Tweak(hue=57) (see [http://forum.videohelp.com/threads/377237-Purple-green-VHS?p=2435970&viewfull=1#post2435970 forum.videohelp.com])
			}

			Function YIQtoYUV(clip clip)
			{
			clip.Tweak(hue=33)
			YtoUV(VtoY(), UtoY(), last) # swap U and V
			}

	yiqclip = ~~Tweak~~(~~hue=33~~) # ~~at this point v and u represent i and q~~		clip = [[AviSource]](...)
	u_chroma = [[BlankClip]]([[UToY]](yiqclip),color=$808080)		yiqclip = YUVtoYIQ(clip) # convert to YIQ
	[[YToUV]](u_chroma, yiqclip.[[VToY]])		u_chroma = [[BlankClip]]([[UToY]](yiqclip), color=$808080)
	~~[[MergeLuma]](~~yiqclip)		[[YToUV]](u_chroma, yiqclip.[[VToY]], yiqclip)
	~~Tweak~~(~~hue=-33~~) # convert back to ~~yuv~~		YIQtoYUV() # convert back to YUV
	[[AudioDub]](yiqclip)		[[AudioDub]](yiqclip)
	</div>		</div>
	This allows processing the ''I'' and ''Q'' signals separately.		This allows processing the ''I'' and ''Q'' signals separately.
	</div>		</div>


			== Developer notes ==
			AviSynth uses the following definitions for hue and saturation:<br>
			As can be seen in the first image above, hue is the angle between the positive V-axis of the chroma plane and the point given by the centralised coordinates (V,U) on it. The saturation is the amplitude of the centralised chroma plane. Mathematically:
			* hue = 180/pi * [https://en.wikipedia.org/wiki/Atan2 atan2]((V-128)/128, (U-128)/128)
			* sat = sqrt((U-128)^2 + (V-128)^2)

Admin at 14:34, 18 March 2016

2016-03-18T14:34:25Z

← Older revision		Revision as of 16:34, 18 March 2016
Line 41:		Line 41:

	:{{Par2\|coring\|bool\|true}}		:{{Par2\|coring\|bool\|true}}
	::When true (the default), the luma (Y) is clipped to [16,235] and the chroma (U, V) is clipped to [16,240];		::When set to true (the default), the luma (Y) is clipped to [16,235] and the chroma (U, V) is clipped to [16,240];
	::~~when~~ set to false, the luma and chroma are unconstrained.		::When set to false, the luma and chroma are unconstrained.

	:{{Par2\|sse\|bool\|false}}		:{{Par2\|sse\|bool\|false}}
Line 50:		Line 50:
	:{{Par2\|startHue\|float\|0.0}}		:{{Par2\|startHue\|float\|0.0}}
	:{{Par2\|endHue\|float\|360.0}}		:{{Par2\|endHue\|float\|360.0}}
	::The hue and saturation will be adjusted for image values in the range [{{FuncArg\|startHue}}}, {{FuncArg\|endHue}}] when {{FuncArg\|startHue}}<{{FuncArg\|endHue}}. Note that the hue is periodic, thus a hue of 360 degrees corresponds with a hue of zero degrees.		::The hue and saturation will be adjusted for image values in the range [{{FuncArg\|startHue}}, {{FuncArg\|endHue}}] when {{FuncArg\|startHue}}<{{FuncArg\|endHue}}. Note that the hue is periodic, thus a hue of 360 degrees corresponds with a hue of zero degrees.

	::Range 0 to 360, given in degrees. Default 0, 360 (all hues).		::Range 0 to 360, given in degrees. Default 0, 360 (all hues).

← Older revision		Revision as of 02:27, 23 April 2017
Line 123:		Line 123:

	{{HiddenAnchor\|realcalc}}		{{HiddenAnchor\|realcalc}}
	:{{Par2\|realcalc\|bool\|false{{AvsPluscon}} }}		:{{Par2\|realcalc\|bool\|false}}
	::When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain high bit depths) ([[TODO]] - clarify)		::{{AvsPluscon}}When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain high bit depths) ([[TODO]] - clarify)

	{{HiddenAnchor\|dstrength}}		{{HiddenAnchor\|dstrength}}
	:{{Par2\|dither_strength\|float\|1.0{{AvsPluscon}} }}		:{{Par2\|dither_strength\|float\|1.0}}
			::{{AvsPluscon}}Control dithering amount.
	::For example, {{FuncArg\|dither_strength}}=1.0 adds ±0.5 amplitude dither on the 0..255 range, and scaled in proportion for other ranges. ([[TODO]] - confirm)		::For example, {{FuncArg\|dither_strength}}=1.0 adds ±0.5 amplitude dither on the 0..255 range, and scaled in proportion for other ranges. ([[TODO]] - confirm)
	</div>		</div>

Tweak - Revision history

Reel.Deal: add link to avs+ documentation

Raffriff42: note AVS+ differences, continued

Raffriff42: Use Template:Deep_color

Raffriff42: tweak appearance

Raffriff42: tweak appearance

Raffriff42: note AVS+ differences *** WIP ***

Admin at 16:16, 18 March 2016

Admin: /* YUV to YIQ conversion */

Admin: need to check changes

Admin at 14:34, 18 March 2016

Raffriff42: note AVS+ differences * WIP *