ColorYUV - Revision history

Pinterf: /* Changelog */ Add change log

2021-03-18T09:33:44Z

‎Changelog: Add change log

Pinterf: /* Syntax and Parameters */ add condvarsuffix parameter description

2021-03-18T09:31:44Z

‎Syntax and Parameters: add condvarsuffix parameter description

Pinterf: /* Conditional Variables */ add parameter condvarsuffix

2021-03-18T09:28:43Z

‎Conditional Variables: add parameter condvarsuffix

Raffriff42: typo

2018-03-05T23:26:21Z

typo

Raffriff42: touch up

2018-03-05T22:54:36Z

touch up

Pinterf: Float is supported in Avs+

2018-03-05T11:58:43Z

Float is supported in Avs+

Pinterf: /* Syntax and Parameters */ levels "TV" explained, "PC->TV.Y" added, chroma range added, gamma on TV range when

2018-03-05T11:55:09Z

‎Syntax and Parameters: levels "TV" explained, "PC->TV.Y" added, chroma range added, gamma on TV range when

Raffriff42: update for AVS+ r2632

2018-03-05T00:42:03Z

update for AVS+ r2632

Raffriff42: more on showyuv

2017-04-30T00:59:34Z

Raffriff42: link to [Float_(color_format)] and [Autoscale_parameter]

2017-04-28T03:57:04Z

link to [Float_(color_format)] and [Autoscale_parameter]

@@ Line 332: / Line 332: @@
 == Changelog ==
 {| border="1"
 |-
 | v2.6

@@ Line 31: / Line 31: @@
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''levels'', string ''opt'', bool ''showyuv'', bool ''analyze'',<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int ''bits'', bool ''showyuv_fullrange'', bool ''f2c'' ] )}} {{AvsPluscon}}
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int ''bits'', bool ''showyuv_fullrange'', bool ''f2c'', string ''condvarsuffix'' ] )}} {{AvsPluscon}}
 :{{Par2|gain_y|float|0}}
@@ Line 191: / Line 191: @@
 ::{{AvsPluscon}} If ''true,'' perform [[#Parameter Rescaling|''parameter rescaling'']] as described below on all '''cont_'''''x'', '''gain_'''''x'' and '''gamma_'''''x''  arguments.
 ::For example, with {{FuncArg|f2c}}=''true'', {{FuncArg|cont_u}}=1.2 results in a 20% increase in ''U'' channel "saturation".
 </div>

@@ Line 229: / Line 229: @@
 The global variables "coloryuv_xxx" with xxx = gain_y, gain_u, gain_v, bright_y, bright_u, bright_v, gamma_y, contrast_y, contrast_u or contrast_v are read each frame, and applied. It is possible to modify these variables using [[FrameEvaluate]] or [[ConditionalReader]].
-For example:
+Parameter 'condvarsuffix' works similarly in ColorYUV, RGBAdjust, Overlay, ConditionalReader.
 coloryuvoffset.txt:
@@ Line 253: / Line 274: @@
 There are more examples of conditional modification at the [[ConditionalReader]] page.
 </div>
 == Examples ==

@@ Line 210: / Line 210: @@
   ## usage example:
-  ColorYUV(gain_y=f2c({{BoldColor|blue|100|2.0}}), cont_u=f2c({{BoldColor|blue|100|1.2}}), cont_v=f2c({{BoldColor|blue|100|0.8}})
+  ColorYUV(gain_y=f2c({{BoldColor|blue|100|2.0}}), cont_u=f2c({{BoldColor|blue|100|1.2}}), cont_v=f2c({{BoldColor|blue|100|0.8}}))
   ## that is, gain is 200%, and contrast (saturation)
@@ Line 216: / Line 216: @@
   ## ...which specified normally, would look like this:
-  ColorYUV(gain_y={{BoldColor|blue|100|256}}, cont_u={{BoldColor|blue|100|51.2}}, cont_v={{BoldColor|blue|100|-51.2}})_
+  ColorYUV(gain_y={{BoldColor|blue|100|256}}, cont_u={{BoldColor|blue|100|51.2}}, cont_v={{BoldColor|blue|100|-51.2}})
   ## AVS+ users can rescale these arguments with the '''f2c''' option.

@@ Line 108: / Line 108: @@
 ::*{{FuncArg|gamma_}}''x'' is valid down to -256, where a minimal gamma of 0.01 is applied (gamma cannot be zero)
 ::*'''Note:''' gamma for chroma is not implemented (''gamma_u'' and ''gamma_v'' are dummy parameters).
-::*{{AvsPluscon}}'''Note:''' gamma will operate on TV range instead of PC range when the input clip is known to be in TV range: levels="TV->PC", levels="TV", opt="coring" and levels is not "PC->TV"/"PC->TV.Y"
+::*{{AvsPluscon}} will operate on TV range instead of the default PC range when the input clip is known to be in TV range:
 :{{Par2|cont_y|float|0}}
@@ Line 146: / Line 148: @@
 :{{Par2|levels|string|""}}
-::Can be "<tt>TV->PC</tt>", "<tt>PC->TV</tt>", "<tt>PC->TV.Y</tt>", "<tt>TV</tt>" {{AvsPluscon}} or nothing (default)
+::Can be "<tt>TV->PC</tt>", "<tt>PC->TV</tt>", "<tt>PC->TV.Y</tt>" or nothing (default)
-::This option can convert between "TV" range (black=16{{D}}, white=235{{D}}) and "Full" or "PC" range (black=0{{D}}, white=255{{D}}).
 ::*If {{FuncArg|levels}}="<tt>TV->PC</tt>", a 16{{D}}-235{{D}} &rarr; 0{{D}}-255{{D}} (contrast increasing) conversion is made
 ::*If {{FuncArg|levels}}="<tt>PC->TV</tt>", a 0{{D}}-255{{D}} &rarr; 16{{D}}-235{{D}} (contrast decreasing) conversion is made
-::*If {{FuncArg|levels}}="<tt>PC->TV.Y</tt>", a 0{{D}}-255{{D}} &rarr; 16{{D}}-235{{D}} (contrast decreasing) conversion is done only on luma channel
+::*If {{FuncArg|levels}}="<tt>PC->TV.Y</tt>", a 0{{D}}-255{{D}} &rarr; 16{{D}}-235{{D}} (contrast decreasing) conversion is made, on luma channel only
-::*{{AvsPluscon}} If {{FuncArg|levels}}="<tt>TV</tt>", tells the filter that gamma will operate on TV range clip, no levels conversion is made
 ::*By default, no conversion is made
 :{{Par2|opt|string|""}}
@@ Line 161: / Line 162: @@
 ::If ''true, ''this option will overwrite your image with a new 448x448 image showing all chroma values along the two axes. This can be useful if you need to adjust the color of your image, but need to know how the colors are arranged.  At the top left of the image, the chroma values are 16{{D}}. At the right side of the image, U is at maximum.  At the bottom of the screen V is at its maximum.  In the middle both chroma is 128{{D}} (or grey). See example image [[#Examples:|below]].
 ::{{AvsPluscon}} Size changes depending on options selected &ndash; see {{FuncArg|showyuv_fullrange}} below
-::If {{FuncArg|bits}}=8, output colorspace is YV12, else colorspace is YUV422P16
+::If {{FuncArg|bits}}=8, output colorspace is [[YV12]], else colorspace is [[Avisynthplus_color_formats|YUV422P16]].
 :{{Par2|analyze|bool|false}}
@@ Line 188: / Line 189: @@
 :{{Par2|f2c|bool|false}}
-::{{AvsPluscon}} If ''true,'' perform [[#Parameter Rescaling|''parameter rescaling'']] as decribed below on all '''cont_'''''x'', '''gain_'''''x'' and '''gamma_'''''x''  arguments.
+::{{AvsPluscon}} If ''true,'' perform [[#Parameter Rescaling|''parameter rescaling'']] as described below on all '''cont_'''''x'', '''gain_'''''x'' and '''gamma_'''''x''  arguments.
 ::For example, with {{FuncArg|f2c}}=''true'', {{FuncArg|cont_u}}=1.2 results in a 20% increase in ''U'' channel "saturation".
 </div>
@@ Line 203: / Line 204: @@
 You can add a simple [[User_defined_script_functions|user function]] to rescale or translate from familiar "Tweak-like" units to ColorYUV units:
-<div {{BoxWidthIndent|56|2}} >
+<div {{BoxWidthIndent|60|2}} >
   function f2c(float f) {
       return (f - 1.0) * 256.0
@@ Line 215: / Line 216: @@
   ## ...which specified normally, would look like this:
-  ColorYUV(gain_y={{BoldColor|blue|100|256}}, cont_u={{BoldColor|blue|100|51.2}}, cont_v={{BoldColor|blue|100|-51.2}})
+  ColorYUV(gain_y={{BoldColor|blue|100|256}}, cont_u={{BoldColor|blue|100|51.2}}, cont_v={{BoldColor|blue|100|-51.2}})_
 </div>
 </div>

@@ Line 7: / Line 7: @@
 * In AviSynth 2.6, all [[YUV]] color formats are supported ([[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]] and [[YUY2]])
-* {{AvsPluscon}} all non-[[Float_(color_format)|Float]] [[YUV]] and [[YUVA]] color formats are supported.
+* {{AvsPluscon}} all [[YUV]] and [[YUVA]] color formats are supported, including [[Float_(color_format)|Float]].
-* {{AvsPluscon}} all parameters are [[Autoscale_parameter|autoscaling]] &ndash; they work without changes at all bit depths.
+* {{AvsPluscon}} all relevant parameters are [[Autoscale_parameter|autoscaling]] &ndash; they work without changes at all bit depths.

@@ Line 31: / Line 31: @@
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''levels'', string ''opt'', bool ''showyuv'', bool ''analyze'',<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int ''bits'', bool ''showyuv_fullrange'' ] )}} {{AvsPluscon}}
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int ''bits'', bool ''showyuv_fullrange'', bool ''f2c'' ] )}} {{AvsPluscon}}
 :{{Par2|gain_y|float|0}}
@@ Line 180: / Line 180: @@
 :{{Par2|showyuv_fullrange|bool|false}}
-::{{AvsPluscon}} If ''true, '' {{FuncArg|showyuv}} output is full range instead of TV range.
+::{{AvsPluscon}} If ''true,'' {{FuncArg|showyuv}} output is full range instead of TV range.
 ::At {{FuncArg|bits}}=8, size of the generated clip grows from 450x450 to 512x512.
 ::At {{FuncArg|bits}}>8, size of the generated clip grows from 1800x1800 to 2048x2048.
 </div>

@@ Line 32: / Line 32: @@
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int ''bits'', bool ''showyuv_fullrange'' ] )}} {{AvsPluscon}}
 :{{Par2|gain_y|float|0}}
@@ Line 115: / Line 112: @@
 :{{Par2|cont_u|float|0}}
 :{{Par2|cont_v|float|0}}
-::Like {{FuncArg|gain_}}''X'', a multiplier for the value, but stretches or shrinks the signal from the center (128).
+::Like {{FuncArg|gain_}}''X'', a multiplier for the value, but stretches or shrinks the signal from the center (128{{D}}).
 ::This is most useful for the chroma components, where it translates to saturation.
-::If {{FuncArg|cont_y}} = {{Serif|''k''}}, then ''Y'' becomes (''Y''-128) '''·''' {{Serif|''k''}}/256 + 128 &ndash; for example:
+::If {{FuncArg|cont_y}} = {{Serif|''k''}}, then ''Y'' becomes (''Y''-128) '''·''' {{Serif|''k''}} / 256 + 128 &ndash; for example:
 :: ('''TL;DR''' ''see [[#Parameter_Rescaling|Parameter Rescaling]] below'')
 ::{|class="wikitable"
@@ Line 144: / Line 141: @@
 |style="text-align:left;padding:0.3em;"| 3.0
 |}
-::*{{FuncArg|cont_}}''x'' is valid down to -256, where the signal is set to 128.
+::*{{FuncArg|cont_}}''x'' is valid down to -256, where the signal is set to 128{{D}}.
 ::*Although it is possible, it doesn't make sense to apply this setting to the luma of the signal.
@@ Line 159: / Line 156: @@
 :{{Par2|showyuv|bool|false}}
-::If ''true, ''this option will overwrite your image with a new 448x448 image showing all chroma values along the two axes. This can be useful if you need to adjust the color of your image, but need to know how the colors are arranged.  At the top left of the image, the chroma values are 16{{D}}. At the right side of the image, U is at maximum.  At the bottom of the screen V is at its maximum.  In the middle both chroma is 128 (or grey). See example image [[#Examples:|below]].
+::If ''true, ''this option will overwrite your image with a new 448x448 image showing all chroma values along the two axes. This can be useful if you need to adjust the color of your image, but need to know how the colors are arranged.  At the top left of the image, the chroma values are 16{{D}}. At the right side of the image, U is at maximum.  At the bottom of the screen V is at its maximum.  In the middle both chroma is 128{{D}} (or grey). See example image [[#Examples:|below]].
-::{{AvsPluscon}} Size changes depending on options selected:
+::{{AvsPluscon}} Size changes depending on options selected &ndash; see {{FuncArg|showyuv_fullrange}} below
-::*By default size is 450x450.
+::If {{FuncArg|bits}}=8, output colorspace is YV12, else colorspace is YUV422P16
-::*With {{FuncArg|showyuv_fullrange}}=true, size is 512x512.
-::*With {{FuncArg|bits}}=10, width and height are both multiplied by 4.
 :{{Par2|analyze|bool|false}}
@@ Line 182: / Line 177: @@
 :{{Par2|bits|int|8}}
 ::{{AvsPluscon}} Sets the bit depth of {{FuncArg|showyuv}} output. Must be 8, 10, 12, 14 or 16.
-::Size of the generated clip grows by 2{{Sup2|(''bit_depth''-8)}}
+::Size changes depending on options selected &ndash; see next item.
 :{{Par2|showyuv_fullrange|bool|false}}
 ::{{AvsPluscon}} If ''true, '' {{FuncArg|showyuv}} output is full range instead of TV range.
-::Size of the generated clip grows from 450x450 to 512x512 at {{FuncArg|bits}}=8.
+::At {{FuncArg|bits}}=8, size of the generated clip grows from 450x450 to 512x512.
 </div>