MaskHS - Revision history

Reel.Deal at 05:23, 18 September 2022

2022-09-18T05:23:30Z

Reel.Deal: add link to avs+ documentation

2022-09-16T22:51:17Z

add link to avs+ documentation

Raffriff42: Use Template:Deep_color

2017-04-28T02:50:26Z

Use Template:Deep_color

Raffriff42: tweak appearance

2017-04-23T09:11:52Z

tweak appearance

Raffriff42: tweak appearance

2017-04-23T00:29:40Z

tweak appearance

Raffriff42: note AVS+ differences

2017-04-22T00:57:23Z

note AVS+ differences

Admin: /* Examples */

2016-03-18T17:29:29Z

‎Examples

Raffriff42: better? startHue, endHue table

2016-03-06T21:22:41Z

better? startHue, endHue table

Raffriff42: formatting

2016-02-28T09:21:55Z

formatting

Raffriff42: formatting, links, phrasing

2016-01-29T00:59:30Z

formatting, links, phrasing

@@ Line 5: / Line 5: @@
 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.

← Older revision		Revision as of 22:51, 16 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.

@@ 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).
-::{{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.
@@ Line 78: / Line 78: @@
 {{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)
+::{{AvsPluscon}} When true, force 'no-lookup': pure float calculation of new pixel values (always true for certain {{Deep_color}} formats) ([[TODO]] - clarify)
 </div>

@@ Line 14: / Line 14: @@
 {{FuncDef
 |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).
-::{{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.

@@ Line 77: / Line 77: @@
 {{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>

@@ 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;" >
 == Syntax and Parameters ==
@@ Line 5: / Line 10: @@
 {{FuncDef
 |MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring'' ] )
 }}
@@ 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).
 ::Range 0 to 150 (percent), default 150, 0; thus when using the default values all pixels will be processed.
 :{{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.
 </div>
@@ Line 114: / Line 129: @@
   | Initial Release
   |}
 [[Category:Internal_filters]]
 [[Category:Masking]]

@@ 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.
-: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
 |<pre style="width:22em" >
@@ Line 107: / Line 107: @@
 </div>
 </div>
 == Changelog ==

@@ 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.
-::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"
-  !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="text-align:left" | Red
   |style="background:#D926B9; color: #EEEEEE" | 075
   |style="background:#D93B26; color: #EEEEEE" | 115
   |-
   |style="text-align:left" | Yellow
   |style="background:#D99D26; color: #121212" | 150
-  |style="background:#D5D926; color: #121212" | 172
+ |style="background:#D9D900; color: #121212" | 176
   |-
   |style="text-align:left" | Green
   |style="background:#9DD926; color: #121212" | 191
   |style="background:#26D97A; color: #121212" | 258
   |-
   |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="text-align:left" | Blue
   |style="background:#2688D9; color: #EEEEEE" | 316
   |style="background:#5026D9; color: #EEEEEE" | 004
   |-
   |style="text-align:left" | Magenta
   |style="background:#9626D9; color: #EEEEEE" | 028
   |style="background:#D526D5; color: #EEEEEE" | 052
   |}

@@ Line 1: / Line 1: @@
-{{Template:FuncDef|MaskHS(clip [, int ''startHue'', int ''endHue'', int ''maxSat'', int ''minSat'', bool ''coring''])}}
+Added in v2.6. Returns a mask (as [[Y8]]) of clip using a given hue and saturation range.
-Added in v2.6. This filter returns a mask (as Y8) of clip using a given hue and saturation range.
+== Syntax and Parameters ==
-''startHue'' (default 0), ''endHue'' (default 360): (both from 0 to 360; given in degrees.). The hue and saturation will be adjusted for values in the range [startHue, endHue] when startHue<endHue. Note that the hue is periodic, thus a hue of 360 degrees corresponds with a hue of zero degrees. If endHue<startHue then the range [endHue, 360] and [0, startHue] will be selected (thus anti-clockwise). If you need to select a range of [350, 370] for example, you need to specify startHue=370 and endHue=350. Thus when using the default values all pixels will be processed.
+:{{Par2|startHue|int|0}}
-''maxSat'' (default 150), ''minSat'' (default 0): (both from 0 to 150 with minSat<maxSat; given in percentages). The hue and saturation will be adjusted for values in the range [minSat, maxSat]. 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^2+127^2) = 180). Thus when using the default values all pixels will be processed.
+::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.
-''coring'' = true/false (default true). When set to true, the luma (Y) is clipped to [16,235]; when set to false, the luma is left untouched.
+::Range 0 to 360 (degrees), default 0, 360; thus when using the default values all pixels will be processed.
-Suppose we want to create a mask of the skin of the girl. The proper way to do this is to look at the vectorscope of [[Histogram]]:
+::As a guide, the following table shows approximate values for the basic colors:
- clip = ...
+:{{Par2|maxSat|int|150}}
- Histogram(clip, mode="color2")
+:{{Par2|minSat|int|0}}
-and estimate the hue range you want to select. As can be seen, the orange hue is between (about) 105 and 165 degrees.
+::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).
-Lower the hue range till you found the correct hue range which should be processed. Use the values in MaskHS and make the interval smaller till the correct one is selected. You can also use Tweak for this (with sat=0). Using the example in [[Tweak]], the following mask is obtained:
+::Range 0 to 150 (percent), default 150, 0; thus when using the default values all pixels will be processed.
-{|border=1 cellspacing=1 cellpadding=4
+:{{Par2|coring|bool|true}}
-| [[Image:Tweak_original2.jpg]]
+::When set to true, the luma (Y) is clipped to [16,235]; when set to false, the luma is left untouched.
-| [[Image:Maskhs.jpg]]
 |-
-| original
+|[[File:Tweak_original2_plus_hist.jpg]]
-| MaskHS(startHue=105, endHue=138)
 |}
-Looking at the blue screen example in [[Overlay]] the following can be used
+: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.
-  testcard = ColorBars()
+:In our example we arrive at {{FuncArg|startHue}}=105, {{FuncArg|endHue}}=138, and the following mask is obtained:
   # example subtitle file with blue background:
-  subs = ImageSource("F:\TestClips\blue.jpg").ConvertToYV24
+  subs = [[ImageSource]]("F:\TestClips\blue.jpg").[[ConvertToYV24]]
   # subs.Histogram(mode="color2").ConvertToRGB # blue in [345,359]
-  mask_hs = subs.MaskHS(startHue=340, endHue=359).Levels(0, 1, 255, 255, 0)
+  mask_hs = subs.MaskHS(startHue=340, endHue=359).[[Levels]](0, 1, 255, 255, 0)
-  Overlay(testcard, subs, mask=mask_hs, mode="blend", opacity=1)
+  [[Overlay]](testcard, subs, mask=mask_hs, mode="blend", opacity=1)
-'''Changelog:'''
+== Changelog ==
 {|border=1 cellspacing=1 cellpadding=4