Limiter - Revision history

FranceBB: Swapped "autoscale" with paramscale which is the right parameter for scaling values automaticaly inside Limiter()

2020-09-25T12:15:53Z

Swapped "autoscale" with paramscale which is the right parameter for scaling values automaticaly inside Limiter()

Pinterf: Update for avs+ r2724: float allowed, autoscale option

2018-07-02T09:31:08Z

Update for avs+ r2724: float allowed, autoscale option

Raffriff42: note AVS+ differences

2017-04-28T20:57:23Z

note AVS+ differences

Raffriff42: formatting

2016-02-28T09:19:35Z

formatting

Admin at 18:32, 25 January 2016

2016-01-25T18:32:18Z

Raffriff42: add example 7

2016-01-23T16:27:31Z

add example 7

Raffriff42: format ''show'' table

2016-01-23T15:39:42Z

format ''show'' table

Raffriff42: 'show

2016-01-23T15:14:32Z

'show

Raffriff42: one more touch-up

2016-01-23T14:08:10Z

one more touch-up

Raffriff42: one more touch-up

2016-01-23T14:02:20Z

one more touch-up

@@ Line 7: / Line 7: @@
 {{AvsPluscon}} By default all parameters are ''non''-[[Autoscale_parameter|autoscaling]] &ndash; they must be scaled to the target bit depth.<br>
-By using parameter ''autoscale'' the range parameters are treated to be of 8 bits range and will be scaled to the current bit depth automatically
+By using parameter ''paramscale'' the range parameters are treated to be of 8 bits range and will be scaled to the current bit depth automatically
 </div>
@@ Line 18: / Line 18: @@
 }}
 <br>{{Template:FuncDef
-|{{AvsPluscon}} Limiter(clip ''clip'' [, float ''min_luma'', float ''max_luma'', float ''min_chroma'', float ''max_chroma'', string ''show'', bool ''autoscale'' ] )
+|{{AvsPluscon}} Limiter(clip ''clip'' [, float ''min_luma'', float ''max_luma'', float ''min_chroma'', float ''max_chroma'', string ''show'', bool ''paramscale'' ] )
 }}
@@ Line 112: / Line 112: @@
 </div>
-:{{AvsPluscon}} {{Par2|autoscale|bool|false}}
+:{{AvsPluscon}} {{Par2|paramscale|bool|false}}
 :: If set, minimum/maximum luma/chroma values are treated as they were in 8 bit range (but non-integer values are allowed), limiter will autoscale them to the current bit depth of the clip.
-:: Conversion uses the bit-shift method for integer bit depth conversion (from 8 to 8-16 bits). For 32 bit float clips the conversion is value/255.0 for Y (luma) channel and (value-128)/255.0 for U/V chroma channels. Do not use autoscale when you want to limit 32 bit float chroma exactly to +/-0.5, give the parameters directly instead.
+:: Conversion uses the bit-shift method for integer bit depth conversion (from 8 to 8-16 bits). For 32 bit float clips the conversion is value/255.0 for Y (luma) channel and (value-128)/255.0 for U/V chroma channels. Do not use paramscale when you want to limit 32 bit float chroma exactly to +/-0.5, give the parameters directly instead.
 ::Default: does not scale at all, parameters are used as-is. Parameters now are of float type to handle 32 bit float values..
@@ Line 198: / Line 198: @@
 | {{AvsPluscon}} r2724
 | Added support for float.
-Added ''autoscale''
+Added ''paramscale''
 |-
 | {{AvsPluscon}}

@@ Line 6: / Line 6: @@
 '''Limiter''' can also colorize out-of-range pixels (with {{FuncArg|show}}) to warn of a potential  problem. See the [[#Examples|example images]] below. Naturally, this option should not be enabled for final output.
-{{AvsPluscon}} all parameters are ''non''-[[Autoscale_parameter|autoscaling]] &ndash; they must be scaled to the target bit depth.
+{{AvsPluscon}} By default all parameters are ''non''-[[Autoscale_parameter|autoscaling]] &ndash; they must be scaled to the target bit depth.<br>
 </div>
@@ Line 14: / Line 15: @@
 <div style="max-width:62em" >
 {{Template:FuncDef
-|Limiter(clip ''clip'' [, int ''min_luma'', int ''max_luma'', int ''min_chroma'', int ''max_chroma'', string show ] )
+|Limiter(clip ''clip'' [, int ''min_luma'', int ''max_luma'', int ''min_chroma'', int ''max_chroma'', string ''show'' ] )
 }}
 :{{Par2|clip|clip|(required)}}
 ::Source clip. [[YUV]] only.
-::{{AvsPluscon}} also supports [[YUVA]]. [[Float_(color_format)|Floating point]] not supported.
+::{{AvsPluscon}} also supports [[YUVA]].
 :{{Par2|min_luma|int|16{{Template:D}}}}
@@ Line 107: / Line 111: @@
 |}
 </div>
@@ Line 186: / Line 195: @@
 == Changes ==
 {| border="1"
 |-
 | v2.60

@@ Line 5: / Line 5: @@
 '''Limiter''' can also colorize out-of-range pixels (with {{FuncArg|show}}) to warn of a potential  problem. See the [[#Examples|example images]] below. Naturally, this option should not be enabled for final output.
 </div>
 __TOC__
@@ Line 16: / Line 19: @@
 :{{Par2|clip|clip|(required)}}
 ::Source clip. [[YUV]] only.
-:{{Par2|min_luma|int|16}}
+:{{Par2|min_luma|int|16{{Template:D}}}}
 ::''Y'' (luma) lower bound.
-:{{Par2|max_luma|int|235}}
+:{{Par2|max_luma|int|235{{Template:D}}}}
 ::''Y'' (luma) upper bound.
@@ Line 26: / Line 30: @@
 ::''U'' & ''V'' (chroma) lower bound.
-:{{Par2|max_chroma|int|240}}
+:{{Par2|max_chroma|int|240{{Template:D}}}}
 ::''U'' & ''V'' (chroma) upper bound.

@@ Line 1: / Line 1: @@
 The standard known as Rec.601 or [[Wikipedia:Rec._601|CCIR-601]] (''Studio Encoding Parameters of Digital Television...'') defines standard quantization levels: for luminance, black is '''16''' and peak white is '''235'''. This is the normal luminance range. For chrominance, the range is '''16''' to '''240''', or 128±112. "The signal may occasionally excurse beyond" these ranges according to Rec.601.<sup>[http://www.itu.int/rec/R-REC-BT.601/ BT.601-7] (Annex 1, Table 3)</sup>
@@ Line 4: / Line 5: @@
 '''Limiter''' can also colorize out-of-range pixels (with {{FuncArg|show}}) to warn of a potential  problem. See the [[#Examples|example images]] below. Naturally, this option should not be enabled for final output.
 __TOC__
 == Syntax and Parameters ==
 {{Template:FuncDef
 |Limiter(clip ''clip'' [, int ''min_luma'', int ''max_luma'', int ''min_chroma'', int ''max_chroma'', string show ] )
@@ Line 99: / Line 102: @@
 | &nbsp;{{BoldColor|#FF00FF|120|&diams;}} magenta
 |}
@@ Line 107: / Line 111: @@
   [[FFmpegSource|FFmpegSource2]]("[http://www.sintel.org/ sintel].mp4")
   [[Trim]](4685, 4685)
   # 2. Exaggerated luma and chroma range
   [[Levels]](16, 1.0, 255-16, 0, 255, coring=false)
   [[Tweak]](sat=2.0, coring=false)
   ColorYUV(analyze=true)
 |-
@@ Line 181: / Line 178: @@
 |[[File:Limit_Ex07a.png|768px]]
 |}
 == Changes ==

@@ Line 15: / Line 15: @@
 :{{Par2|min_luma|int|16}}
-::''Y'' (luma) lower clamping limit.
+::''Y'' (luma) lower bound.
 :{{Par2|max_luma|int|235}}
-::''Y'' (luma) upper clamping limit.
+::''Y'' (luma) upper bound.
 :{{Par2|min_chroma|int|16}}
-::''U'' & ''V'' (chroma) lower clamping limit.
+::''U'' & ''V'' (chroma) lower bound.
 :{{Par2|max_chroma|int|240}}
-::''U'' & ''V'' (chroma) upper clamping limit.
+::''U'' & ''V'' (chroma) upper bound.
 :{{Par2|show|string|(empty)}}

@@ Line 161: / Line 161: @@
 |-
 |[[File:Limit_Ex06.jpg]]
 |}

@@ Line 75: / Line 75: @@
 |-
 | ''U'' < {{FuncArg|min_chroma}}
-| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
+| rowspan="8"|&nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
 | &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
 |-
 | ''U'' > {{FuncArg|max_chroma}}
 | &nbsp;{{BoldColor|#0000FF|120|&diams;}} blue
 |-
 | ''V'' < {{FuncArg|min_chroma}}
 | &nbsp;{{BoldColor|#00FFFF|120|&diams;}} cyan
 |-
 | ''V'' > {{FuncArg|max_chroma}}
 | &nbsp;{{BoldColor|#FF0000|120|&diams;}} red
 |-
 | ''U'' < {{FuncArg|min_chroma}}&nbsp;and ''V''&nbsp;<&nbsp;{{FuncArg|min_chroma}}
 | &nbsp;{{BoldColor|#00FF00|120|&diams;}} green
 |-
 | ''U'' > {{FuncArg|max_chroma}}&nbsp;and ''V''&nbsp;<&nbsp;{{FuncArg|min_chroma}}
 | &nbsp;{{BoldColor|#008080|120|&diams;}} teal
 |-
 | ''U'' < {{FuncArg|min_chroma}}&nbsp;and ''V''&nbsp;>&nbsp;{{FuncArg|max_chroma}}
 | &nbsp;{{BoldColor|#FFA500|120|&diams;}} orange
 |-
 | ''U'' > {{FuncArg|max_chroma}}&nbsp;and ''V''&nbsp;>&nbsp;{{FuncArg|max_chroma}}
 | &nbsp;{{BoldColor|#FF00FF|120|&diams;}} magenta
 |}

@@ Line 55: / Line 55: @@
 |-
+|
-! style="text-align:left;width:12em;"|{{FuncArg|show}}="luma"
+! style="text-align:left;width:12em;"|&nbsp;{{FuncArg|show}}="luma"
-! style="text-align:left;width:12em;"|{{FuncArg|show}}="luma_grey"
+! style="text-align:left;width:12em;"|&nbsp;{{FuncArg|show}}="luma_grey"
 |-
 | ''Y''j < {{FuncArg|min_luma}}
-| red (pj)
+| &nbsp;{{BoldColor|#FF0000|120|&diams;}} red (pj)
-| red (pj)
+| &nbsp;{{BoldColor|#FF0000|120|&diams;}} red (pj)
 |-
 | ''Y''j > {{FuncArg|max_luma}}
-| green (pj)
+| &nbsp;{{BoldColor|#00FF00|120|&diams;}} green (pj)
-| green (pj)
+| &nbsp;{{BoldColor|#00FF00|120|&diams;}} green (pj)
 |-
 | ''Y''j < {{FuncArg|min_luma}}&nbsp;and ''Y''k&nbsp;>&nbsp;{{FuncArg|max_luma}}
-| yellow (pj and pk)
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow (pj and pk)
-| puke (pj), olive (pk)
+| &nbsp;{{BoldColor|#555501|120|&diams;}}&nbsp;puke&nbsp;(pj) {{BoldColor|#A0A04A|120|&diams;}}&nbsp;olive&nbsp;(pk)
 |-
+|
-! style="text-align:left;"|{{FuncArg|show}}="chroma"
+! style="text-align:left;"|&nbsp;{{FuncArg|show}}="chroma"
-! style="text-align:left;"|{{FuncArg|show}}="chroma_grey"
+! style="text-align:left;"|&nbsp;{{FuncArg|show}}="chroma_grey"
 |-
 | ''U'' < {{FuncArg|min_chroma}}
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
 |-
 | ''U'' > {{FuncArg|max_chroma}}
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
-| blue
+| &nbsp;{{BoldColor|#0000FF|120|&diams;}} blue
 |-
 | ''V'' < {{FuncArg|min_chroma}}
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
-| cyan
+| &nbsp;{{BoldColor|#00FFFF|120|&diams;}} cyan
 |-
 | ''V'' > {{FuncArg|max_chroma}}
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
-| red
+| &nbsp;{{BoldColor|#FF0000|120|&diams;}} red
 |-
 | ''U'' < {{FuncArg|min_chroma}}&nbsp;and ''V''&nbsp;<&nbsp;{{FuncArg|min_chroma}}
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
-| green
+| &nbsp;{{BoldColor|#00FF00|120|&diams;}} green
 |-
 | ''U'' > {{FuncArg|max_chroma}}&nbsp;and ''V''&nbsp;<&nbsp;{{FuncArg|min_chroma}}
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
-| teal
+| &nbsp;{{BoldColor|#008080|120|&diams;}} teal
 |-
 | ''U'' < {{FuncArg|min_chroma}}&nbsp;and ''V''&nbsp;>&nbsp;{{FuncArg|max_chroma}}
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
-| orange
+| &nbsp;{{BoldColor|#FFA500|120|&diams;}} orange
 |-
 | ''U'' > {{FuncArg|max_chroma}}&nbsp;and ''V''&nbsp;>&nbsp;{{FuncArg|max_chroma}}
-| yellow
+| &nbsp;{{BoldColor|#FFFF00|120|&diams;}} yellow
-| magenta
+| &nbsp;{{BoldColor|#FF00FF|120|&diams;}} magenta
 |}

@@ Line 1: / Line 1: @@
-The standard known as Rec.601 or [[Wikipedia:Rec._601|CCIR-601]] (''Studio Encoding Parameters of Digital Television...'') defines standard quantization levels: for luminance, black is '''16''' and peak white is '''235'''. For chrominance, the range is '''16''' to '''240''', with the center (grey) at 128. "The signal may occasionally excurse beyond" this range according to Rec.601.<sup>[http://www.itu.int/rec/R-REC-BT.601/ BT.601-7] (Annex 1, Table 3)</sup>
+The standard known as Rec.601 or [[Wikipedia:Rec._601|CCIR-601]] (''Studio Encoding Parameters of Digital Television...'') defines standard quantization levels: for luminance, black is '''16''' and peak white is '''235'''. For chrominance, the range is '''16''' to '''240''', or 128±112. "The signal may occasionally excurse beyond" this range according to Rec.601.<sup>[http://www.itu.int/rec/R-REC-BT.601/ BT.601-7] (Annex 1, Table 3)</sup>
 Luminance or chrominance values outside this range are [http://forum.doom9.org/showthread.php?p=1108323#post1108323 known to cause problems with some TV sets], so '''Limiter''' was created to ''clip'' them (or [[Talk:Levels#Clamping_vs._Clipping|''clamp'']] them - both terms are used) to the ranges [{{FuncArg|min_luma}}''', '''{{FuncArg|max_luma}}] and [{{FuncArg|min_chroma}}''', '''{{FuncArg|max_chroma}}], which you may specify, but by default are the Rec.601 values listed above.
 __TOC__
@@ Line 47: / Line 49: @@
 ::*[[YV24]]: {{Serif|j}},{{Serif|k}}=1 (no chroma shared)
 ::*[[YV12]]: {{Serif|j}},{{Serif|k}}=11,12,21,22 (chroma shared between 2x2 pixels Y11UY12V: Y21UY22V)
 ::{| class="wikitable"