MaskHS - Revision history

Reel.Deal at 05:23, 18 September 2022

2022-09-18T05:23:30Z

← Older revision		Revision as of 07:23, 18 September 2022
Line 5:		Line 5:
	Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/maskhs.html https://avisynthplus.readthedocs.io]		Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/maskhs.html https://avisynthplus.readthedocs.io]
	</div>		</div>


	Returns a mask (as [[Y8]]) of clip using a given hue and saturation range. Added in v2.6.		Returns a mask (as [[Y8]]) of clip using a given hue and saturation range. Added in v2.6.

Reel.Deal: add link to avs+ documentation

2022-09-16T22:51:17Z

add link to avs+ documentation

← Older revision		Revision as of 00:51, 17 September 2022
Line 1:		Line 1:
	<div style="max-width:82em; min-width:42em;" >		<div style="max-width:82em; min-width:42em;" >
	~~{{AvsStarFilter}}Returns a mask (as [[Y8]]) of clip using a given hue and saturation range. Added in v2.6.~~

	{{~~AvsPluscon~~}} ~~adds new [[#realcalc\|~~{{~~FuncArg\|realcalc~~}}]~~] parameter.~~		<div {{BlueBox2\|40\|0\|3px solid purple}} >
			{{AvsPlusFullname}}<br>
			Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/maskhs.html https://avisynthplus.readthedocs.io]
			</div>

			Returns a mask (as [[Y8]]) of clip using a given hue and saturation range. Added in v2.6.

Raffriff42: Use Template:Deep_color

2017-04-28T02:50:26Z

Use Template:Deep_color

← Older revision		Revision as of 04:50, 28 April 2017
Line 69:		Line 69:

	::Practically the saturation of a pixel will be in the range [0,100] (thus 0-100%), since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119). 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).		::Practically the saturation of a pixel will be in the range [0,100] (thus 0-100%), since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119). 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).
	::{{AvsPluscon}} [[TODO]] needs documentation of behavior ~~at high bit depth~~.		::{{AvsPluscon}} [[TODO]] needs documentation of behavior with {{Deep_color}} formats.

	::Range 0 to 150 (percent), default 150, 0; thus when using the default values all pixels will be processed.		::Range 0 to 150 (percent), default 150, 0; thus when using the default values all pixels will be processed.
Line 78:		Line 78:
	{{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)
	</div>		</div>

Raffriff42: tweak appearance

2017-04-23T09:11:52Z

tweak appearance

← Older revision		Revision as of 11:11, 23 April 2017
Line 14:		Line 14:
	{{FuncDef		{{FuncDef
	\|MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring'',		\|MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring'',
	bool ''realcalc'' ] ){{AvsPluscon}}		bool ''realcalc'' ] ) {{AvsPluscon}}
	}}		}}

Line 69:		Line 69:

	::Practically the saturation of a pixel will be in the range [0,100] (thus 0-100%), since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119). 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).		::Practically the saturation of a pixel will be in the range [0,100] (thus 0-100%), since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119). 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).
	::{{AvsPluscon}}[[TODO]] needs documentation of behavior at high bit depth.		::{{AvsPluscon}} [[TODO]] needs documentation of behavior at high bit depth.

	::Range 0 to 150 (percent), default 150, 0; thus when using the default values all pixels will be processed.		::Range 0 to 150 (percent), default 150, 0; thus when using the default values all pixels will be processed.

Raffriff42: tweak appearance

2017-04-23T00:29:40Z

tweak appearance

← Older revision		Revision as of 02:29, 23 April 2017
Line 77:		Line 77:

	{{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)
	</div>		</div>

Raffriff42: note AVS+ differences

2017-04-22T00:57:23Z

note AVS+ differences

← Older revision		Revision as of 02:57, 22 April 2017
Line 1:		Line 1:
	~~Added in v2.6.~~ Returns a mask (as [[Y8]]) of clip using a given hue and saturation range.		<div style="max-width:82em; min-width:42em;" >
			{{AvsStarFilter}}Returns a mask (as [[Y8]]) of clip using a given hue and saturation range. Added in v2.6.

			{{AvsPluscon}} adds new [[#realcalc\|{{FuncArg\|realcalc}}]] parameter.



	== Syntax and Parameters ==		== Syntax and Parameters ==
Line 5:		Line 10:
	{{FuncDef		{{FuncDef
	\|MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring'' ] )		\|MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring'' ] )
			}}

			{{FuncDef
			\|MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring'',
			bool ''realcalc'' ] ){{AvsPluscon}}
	}}		}}

Line 59:		Line 69:

	::Practically the saturation of a pixel will be in the range [0,100] (thus 0-100%), since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119). 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).		::Practically the saturation of a pixel will be in the range [0,100] (thus 0-100%), since these correspond to valid RGB pixels (100% corresponds to R=255, G=B=0, which has a saturation of 119). 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).
			::{{AvsPluscon}}[[TODO]] needs documentation of behavior at high bit depth.

	::Range 0 to 150 (percent), default 150, 0; thus when using the default values all pixels will be processed.		::Range 0 to 150 (percent), default 150, 0; thus when using the default values all pixels will be processed.

	:{{Par2\|coring\|bool\|true}}		:{{Par2\|coring\|bool\|true}}
	::When set to true, the luma (Y) is clipped to ~~[16,235]~~; when set to false, the luma is left untouched.		::When set to true, the luma (Y) is clipped to TV-range; when set to false, the luma is left untouched.

			{{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)
	</div>		</div>

Line 114:		Line 129:
	\| Initial Release		\| Initial Release
	\|}		\|}
			</div>

	[[Category:Internal_filters]]		[[Category:Internal_filters]]
	[[Category:Masking]]		[[Category:Masking]]

Admin: /* Examples */

2016-03-18T17:29:29Z

Examples

← Older revision		Revision as of 19:29, 18 March 2016
Line 83:		Line 83:
	:Start with a wide hue range and narrow it until the output of '''MaskHS''' isolates the range of interest. You can also use [[Tweak]] to preview the affected range (with ''sat''=0), as the arguments are compatible.		:Start with a wide hue range and narrow it until the output of '''MaskHS''' isolates the range of interest. You can also use [[Tweak]] to preview the affected range (with ''sat''=0), as the arguments are compatible.

	:In our example we ~~arrive~~ at {{FuncArg\|startHue}}=105, {{FuncArg\|endHue}}=138, and the following mask is obtained:		:In our example we end at {{FuncArg\|startHue}}=105, {{FuncArg\|endHue}}=138, and the following mask is obtained:
	:{\|border=0		:{\|border=0
	\|<pre style="width:22em" >		\|<pre style="width:22em" >
Line 107:		Line 107:
	</div>		</div>
	</div>		</div>


	== Changelog ==		== Changelog ==

Raffriff42: better? startHue, endHue table

2016-03-06T21:22:41Z

better? startHue, endHue table

← Older revision		Revision as of 23:22, 6 March 2016
Line 13:		Line 13:
	::If {{FuncArg\|endHue}}<{{FuncArg\|startHue}} then the range [{{FuncArg\|endHue}}, 360] and [0, {{FuncArg\|startHue}}] will be selected (thus anti-clockwise). If you need to select a range of [350, 370] for example, you need to specify {{FuncArg\|startHue}}=370, {{FuncArg\|endHue}}=350.		::If {{FuncArg\|endHue}}<{{FuncArg\|startHue}} then the range [{{FuncArg\|endHue}}, 360] and [0, {{FuncArg\|startHue}}] will be selected (thus anti-clockwise). If you need to select a range of [350, 370] for example, you need to specify {{FuncArg\|startHue}}=370, {{FuncArg\|endHue}}=350.

	::Range 0 to 360 (degrees), default 0, 360; thus when using the default values all pixels will be processed.		::Range 0 to 360 (degrees), default 0, 360; thus when using the default values, all pixels will be processed.

	::~~As a guide, the~~ following ~~table~~ shows ~~approximate~~ values for the basic colors:		::The following shows some arbitrary {{FuncArg\|startHue}} and {{FuncArg\|endHue}} values for the basic colors, with a [[Histogram#Color2_mode\|Histogram vectorscope]] to illustrate the color circle:
	::{\| class="wikitable" border="1" style="text-align:center"		::{\| class="wikitable" border="1" style="text-align:center"
	!style="width:6em" \| Color		\|style="width:6em" \| '''Color'''
	!style="width:6em" \| startHue		\|style="width:6em" \| '''startHue'''
	!style="width:6em" \| endHue		\|style="width:6em" \| (center)
			\|style="width:6em" \| '''endHue'''
			\|rowspan="7"\| [[File:Labeled-vector-color2.png\|right]]
	\|-		\|-
	\|style="text-align:left" \| Red		\|style="text-align:left" \| Red
	\|style="background:#D926B9; color: #EEEEEE" \| 075		\|style="background:#D926B9; color: #EEEEEE" \| 075
			\|style="background:#D90000; color: #EEEEEE" \| 102
	\|style="background:#D93B26; color: #EEEEEE" \| 115		\|style="background:#D93B26; color: #EEEEEE" \| 115
	\|-		\|-
	\|style="text-align:left" \| Yellow		\|style="text-align:left" \| Yellow
	\|style="background:#D99D26; color: #121212" \| 150		\|style="background:#D99D26; color: #121212" \| 150
	\|style="background:#D5D926; color: #121212" \| ~~172~~		\|style="background:#D9D900; color: #121212" \| 176
			\|style="background:#D5D926; color: #121212" \| 180
	\|-		\|-
	\|style="text-align:left" \| Green		\|style="text-align:left" \| Green
	\|style="background:#9DD926; color: #121212" \| 191		\|style="background:#9DD926; color: #121212" \| 191
			\|style="background:#00D900; color: #121212" \| 230
	\|style="background:#26D97A; color: #121212" \| 258		\|style="background:#26D97A; color: #121212" \| 258
	\|-		\|-
	\|style="text-align:left" \| Cyan		\|style="text-align:left" \| Cyan
	\|style="background:#26D9B9; color: #~~EEEEEE~~" \| 279		\|style="background:#26D9B9; color: #121212" \| 279
	\|style="background:#26B2D9; color: #~~EEEEEE~~" \| 300		\|style="background:#00D9D9; color: #121212" \| 282
			\|style="background:#26B2D9; color: #121212" \| 300
	\|-		\|-
	\|style="text-align:left" \| Blue		\|style="text-align:left" \| Blue
	\|style="background:#2688D9; color: #EEEEEE" \| 316		\|style="background:#2688D9; color: #EEEEEE" \| 316
			\|style="background:#0000D9; color: #EEEEEE" \| 000
	\|style="background:#5026D9; color: #EEEEEE" \| 004		\|style="background:#5026D9; color: #EEEEEE" \| 004
	\|-		\|-
	\|style="text-align:left" \| Magenta		\|style="text-align:left" \| Magenta
	\|style="background:#9626D9; color: #EEEEEE" \| 028		\|style="background:#9626D9; color: #EEEEEE" \| 028
			\|style="background:#D900D9; color: #EEEEEE" \| 048
	\|style="background:#D526D5; color: #EEEEEE" \| 052		\|style="background:#D526D5; color: #EEEEEE" \| 052
	\|}		\|}

Raffriff42: formatting

2016-02-28T09:21:55Z

formatting

← Older revision		Revision as of 11:21, 28 February 2016
Line 2:		Line 2:

	== Syntax and Parameters ==		== Syntax and Parameters ==
			<div style="max-width:62em" >
	{{FuncDef		{{FuncDef
	\|MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring'' ] )		\|MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring'' ] )
Line 55:		Line 56:
	:{{Par2\|coring\|bool\|true}}		:{{Par2\|coring\|bool\|true}}
	::When set to true, the luma (Y) is clipped to [16,235]; when set to false, the luma is left untouched.		::When set to true, the luma (Y) is clipped to [16,235]; when set to false, the luma is left untouched.
			</div>


	== Examples ==		== Examples ==
			<div style="max-width:62em" >
	*Suppose we want to create a mask of the skin of the girl below. The proper way to do this is to look at the vectorscope of [[Histogram#Color2_mode\|Histogram]]:		*Suppose we want to create a mask of the skin of the girl below. The proper way to do this is to look at the vectorscope of [[Histogram#Color2_mode\|Histogram]]:
	:{\|border=0		:{\|border=0
Line 94:		Line 97:

	[[Overlay]](testcard, subs, mask=mask_hs, mode="blend", opacity=1)		[[Overlay]](testcard, subs, mask=mask_hs, mode="blend", opacity=1)
			</div>
	</div>		</div>

Raffriff42: formatting, links, phrasing

2016-01-29T00:59:30Z

formatting, links, phrasing

Show changes

← Older revision		Revision as of 23:22, 6 March 2016
Line 13:		Line 13:
	::If {{FuncArg\|endHue}}<{{FuncArg\|startHue}} then the range [{{FuncArg\|endHue}}, 360] and [0, {{FuncArg\|startHue}}] will be selected (thus anti-clockwise). If you need to select a range of [350, 370] for example, you need to specify {{FuncArg\|startHue}}=370, {{FuncArg\|endHue}}=350.		::If {{FuncArg\|endHue}}<{{FuncArg\|startHue}} then the range [{{FuncArg\|endHue}}, 360] and [0, {{FuncArg\|startHue}}] will be selected (thus anti-clockwise). If you need to select a range of [350, 370] for example, you need to specify {{FuncArg\|startHue}}=370, {{FuncArg\|endHue}}=350.

	::Range 0 to 360 (degrees), default 0, 360; thus when using the default values all pixels will be processed.		::Range 0 to 360 (degrees), default 0, 360; thus when using the default values, all pixels will be processed.

	::~~As a guide, the~~ following ~~table~~ shows ~~approximate~~ values for the basic colors:		::The following shows some arbitrary {{FuncArg\|startHue}} and {{FuncArg\|endHue}} values for the basic colors, with a [[Histogram#Color2_mode\|Histogram vectorscope]] to illustrate the color circle:
	::{\| class="wikitable" border="1" style="text-align:center"		::{\| class="wikitable" border="1" style="text-align:center"
	!style="width:6em" \| Color		\|style="width:6em" \| '''Color'''
	!style="width:6em" \| startHue		\|style="width:6em" \| '''startHue'''
	!style="width:6em" \| endHue		\|style="width:6em" \| (center)
			\|style="width:6em" \| '''endHue'''
			\|rowspan="7"\| [[File:Labeled-vector-color2.png\|right]]
	\|-		\|-
	\|style="text-align:left" \| Red		\|style="text-align:left" \| Red
	\|style="background:#D926B9; color: #EEEEEE" \| 075		\|style="background:#D926B9; color: #EEEEEE" \| 075
			\|style="background:#D90000; color: #EEEEEE" \| 102
	\|style="background:#D93B26; color: #EEEEEE" \| 115		\|style="background:#D93B26; color: #EEEEEE" \| 115
	\|-		\|-
	\|style="text-align:left" \| Yellow		\|style="text-align:left" \| Yellow
	\|style="background:#D99D26; color: #121212" \| 150		\|style="background:#D99D26; color: #121212" \| 150
	\|style="background:#D5D926; color: #121212" \| ~~172~~		\|style="background:#D9D900; color: #121212" \| 176
			\|style="background:#D5D926; color: #121212" \| 180
	\|-		\|-
	\|style="text-align:left" \| Green		\|style="text-align:left" \| Green
	\|style="background:#9DD926; color: #121212" \| 191		\|style="background:#9DD926; color: #121212" \| 191
			\|style="background:#00D900; color: #121212" \| 230
	\|style="background:#26D97A; color: #121212" \| 258		\|style="background:#26D97A; color: #121212" \| 258
	\|-		\|-
	\|style="text-align:left" \| Cyan		\|style="text-align:left" \| Cyan
	\|style="background:#26D9B9; color: #~~EEEEEE~~" \| 279		\|style="background:#26D9B9; color: #121212" \| 279
	\|style="background:#26B2D9; color: #~~EEEEEE~~" \| 300		\|style="background:#00D9D9; color: #121212" \| 282
			\|style="background:#26B2D9; color: #121212" \| 300
	\|-		\|-
	\|style="text-align:left" \| Blue		\|style="text-align:left" \| Blue
	\|style="background:#2688D9; color: #EEEEEE" \| 316		\|style="background:#2688D9; color: #EEEEEE" \| 316
			\|style="background:#0000D9; color: #EEEEEE" \| 000
	\|style="background:#5026D9; color: #EEEEEE" \| 004		\|style="background:#5026D9; color: #EEEEEE" \| 004
	\|-		\|-
	\|style="text-align:left" \| Magenta		\|style="text-align:left" \| Magenta
	\|style="background:#9626D9; color: #EEEEEE" \| 028		\|style="background:#9626D9; color: #EEEEEE" \| 028
			\|style="background:#D900D9; color: #EEEEEE" \| 048
	\|style="background:#D526D5; color: #EEEEEE" \| 052		\|style="background:#D526D5; color: #EEEEEE" \| 052
	\|}		\|}