ColorYUV - Revision history

Pinterf: /* Changelog */ Add change log

2021-03-18T09:33:44Z

Changelog: Add change log

← Older revision		Revision as of 11:33, 18 March 2021
Line 332:		Line 332:
	== Changelog ==		== Changelog ==
	{\| border="1"		{\| border="1"
			\|-
			\| v3.4 (r2915)
			\| Added condvarsuffix option
	\|-		\|-
	\| v2.6		\| v2.6

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

2021-03-18T09:31:44Z

Syntax and Parameters: add condvarsuffix parameter description

← Older revision		Revision as of 11:31, 18 March 2021
Line 31:		Line 31:
	string ''levels'', string ''opt'', bool ''showyuv'', bool ''analyze'',<br>		string ''levels'', string ''opt'', bool ''showyuv'', bool ''analyze'',<br>
	bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>		bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>
	int ''bits'', bool ''showyuv_fullrange'', bool ''f2c'' ] )}} {{AvsPluscon}}		int ''bits'', bool ''showyuv_fullrange'', bool ''f2c'', string ''condvarsuffix'' ] )}} {{AvsPluscon}}

	:{{Par2\|gain_y\|float\|0}}		:{{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.		::{{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".		::For example, with {{FuncArg\|f2c}}=''true'', {{FuncArg\|cont_u}}=1.2 results in a 20% increase in ''U'' channel "saturation".

			:{{Par2\|condvarsuffix\|string\|""}}
			::{{AvsPluscon}} this parameter works similarly in ColorYUV, RGBAdjust, Overlay, ConditionalReader.
			:: Allows multiple filter instances to use differently named conditional parameters, thus preventing collision and overwrite of variables which are used by different ConditionalReader instances.
			:: See Conditional Variables section
	</div>		</div>

Pinterf: /* Conditional Variables */ add parameter condvarsuffix

2021-03-18T09:28:43Z

Conditional Variables: add parameter condvarsuffix

@@ 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 ==

Raffriff42: typo

2018-03-05T23:26:21Z

typo

← Older revision		Revision as of 01:26, 6 March 2018
Line 210:		Line 210:

	## usage example:		## 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)		## that is, gain is 200%, and contrast (saturation)
Line 216:		Line 216:

	## ...which specified normally, would look like this:		## ...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.		## AVS+ users can rescale these arguments with the '''f2c''' option.

Raffriff42: touch up

2018-03-05T22:54:36Z

touch up

← Older revision		Revision as of 00:54, 6 March 2018
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)		::*{{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).		::*'''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:
			:::*{{FuncArg\|levels}}="TV->PC", or {{FuncArg\|levels}}="TV",
			:::*or {{FuncArg\|opt}}="coring" and {{FuncArg\|levels}} is ''not'' "PC->TV" or "PC->TV.Y"

	:{{Par2\|cont_y\|float\|0}}		:{{Par2\|cont_y\|float\|0}}
Line 146:		Line 148:

	:{{Par2\|levels\|string\|""}}		:{{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}} → 0{{D}}-255{{D}} (contrast increasing) conversion is made		::*If {{FuncArg\|levels}}="<tt>TV->PC</tt>", a 16{{D}}-235{{D}} → 0{{D}}-255{{D}} (contrast increasing) conversion is made
	::*If {{FuncArg\|levels}}="<tt>PC->TV</tt>", a 0{{D}}-255{{D}} → 16{{D}}-235{{D}} (contrast decreasing) conversion is made		::*If {{FuncArg\|levels}}="<tt>PC->TV</tt>", a 0{{D}}-255{{D}} → 16{{D}}-235{{D}} (contrast decreasing) conversion is made
	::*If {{FuncArg\|levels}}="<tt>PC->TV.Y</tt>", a 0{{D}}-255{{D}} → 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}} → 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		::*By default, no conversion is made
			::{{AvsPluscon}} adds "<tt>TV</tt>", which does no conversion; it only tells the filter that {{FuncArg\|gamma}}''_x'' will operate on a TV range clip.

	:{{Par2\|opt\|string\|""}}		:{{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]].		::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 – see {{FuncArg\|showyuv_fullrange}} below		::{{AvsPluscon}} Size changes depending on options selected – 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}}		:{{Par2\|analyze\|bool\|false}}
Line 188:		Line 189:

	:{{Par2\|f2c\|bool\|false}}		:{{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".		::For example, with {{FuncArg\|f2c}}=''true'', {{FuncArg\|cont_u}}=1.2 results in a 20% increase in ''U'' channel "saturation".
	</div>		</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:		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) {		function f2c(float f) {
	return (f - 1.0) * 256.0		return (f - 1.0) * 256.0
Line 215:		Line 216:

	## ...which specified normally, would look like this:		## ...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.
			ColorYUV(gain_y={{BoldColor\|blue\|100\|2.0}}, cont_u={{BoldColor\|blue\|100\|1.2}}, cont_v={{BoldColor\|blue\|100\|0.8}}, {{FuncArg\|f2c}}=true)

	</div>		</div>
	</div>		</div>

Pinterf: Float is supported in Avs+

2018-03-05T11:58:43Z

Float is supported in Avs+

← Older revision		Revision as of 13:58, 5 March 2018
Line 7:		Line 7:

	* In AviSynth 2.6, all [[YUV]] color formats are supported ([[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]] and [[YUY2]])		* 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]] – they work without changes at all bit depths.		* {{AvsPluscon}} all relevant parameters are [[Autoscale_parameter\|autoscaling]] – they work without changes at all bit depths.

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

← Older revision		Revision as of 13:55, 5 March 2018
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)		::*{{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).		::*'''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"

	:{{Par2\|cont_y\|float\|0}}		:{{Par2\|cont_y\|float\|0}}
Line 145:		Line 146:

	:{{Par2\|levels\|string\|""}}		:{{Par2\|levels\|string\|""}}
	::Can be "<tt>TV->PC</tt>", "<tt>PC->TV</tt>" or nothing (default)		::Can be "<tt>TV->PC</tt>", "<tt>PC->TV</tt>", "<tt>PC->TV.Y</tt>", "<tt>TV</tt>" {{AvsPluscon}} 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}}).		::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}} → 0{{D}}-255{{D}} (contrast increasing) conversion is made		::*If {{FuncArg\|levels}}="<tt>TV->PC</tt>", a 16{{D}}-235{{D}} → 0{{D}}-255{{D}} (contrast increasing) conversion is made
	::*If {{FuncArg\|levels}}="<tt>PC->TV</tt>", a 0{{D}}-255{{D}} → 16{{D}}-235{{D}} (contrast decreasing) conversion is made		::*If {{FuncArg\|levels}}="<tt>PC->TV</tt>", a 0{{D}}-255{{D}} → 16{{D}}-235{{D}} (contrast decreasing) conversion is made
			::*If {{FuncArg\|levels}}="<tt>PC->TV.Y</tt>", a 0{{D}}-255{{D}} → 16{{D}}-235{{D}} (contrast decreasing) conversion is done only on luma channel
			::*{{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		::*By default, no conversion is made

	:{{Par2\|opt\|string\|""}}		:{{Par2\|opt\|string\|""}}
	::Can be either "coring" or "" (nothing, default setting).		::Can be either "coring" or "" (nothing, default setting).
	::Specifying "coring" will clip your YUV values to the "TV" range (16{{D}}-235{{D}}). Otherwise values outside that range will be accepted.		::Specifying "coring" will clip your YUV values to the "TV" range (luma 16{{D}}-235{{D}}, chroma 16{{D}}-240{{D}}). Otherwise values outside that range will be accepted.

	:{{Par2\|showyuv\|bool\|false}}		:{{Par2\|showyuv\|bool\|false}}
Line 188:		Line 191:
	::For example, with {{FuncArg\|f2c}}=''true'', {{FuncArg\|cont_u}}=1.2 results in a 20% increase in ''U'' channel "saturation".		::For example, with {{FuncArg\|f2c}}=''true'', {{FuncArg\|cont_u}}=1.2 results in a 20% increase in ''U'' channel "saturation".
	</div>		</div>


	==Parameter Rescaling==		==Parameter Rescaling==

Raffriff42: update for AVS+ r2632

2018-03-05T00:42:03Z

update for AVS+ r2632

← Older revision		Revision as of 02:42, 5 March 2018
Line 31:		Line 31:
	string ''levels'', string ''opt'', bool ''showyuv'', bool ''analyze'',<br>		string ''levels'', string ''opt'', bool ''showyuv'', bool ''analyze'',<br>
	bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>		bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>
	int ''bits'', bool ''showyuv_fullrange'' ] )}} {{AvsPluscon}}		int ''bits'', bool ''showyuv_fullrange'', bool ''f2c'' ] )}} {{AvsPluscon}}

	:{{Par2\|gain_y\|float\|0}}		:{{Par2\|gain_y\|float\|0}}
Line 180:		Line 180:

	:{{Par2\|showyuv_fullrange\|bool\|false}}		:{{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 450x450 to 512x512.
	::At {{FuncArg\|bits}}>8, size of the generated clip grows from 1800x1800 to 2048x2048.		::At {{FuncArg\|bits}}>8, size of the generated clip grows from 1800x1800 to 2048x2048.

			:{{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.
			::For example, with {{FuncArg\|f2c}}=''true'', {{FuncArg\|cont_u}}=1.2 results in a 20% increase in ''U'' channel "saturation".
	</div>		</div>

Raffriff42: more on showyuv

2017-04-30T00:59:34Z

more on showyuv

← Older revision		Revision as of 02:59, 30 April 2017
Line 32:		Line 32:
	bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>		bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>
	int ''bits'', bool ''showyuv_fullrange'' ] )}} {{AvsPluscon}}		int ''bits'', bool ''showyuv_fullrange'' ] )}} {{AvsPluscon}}

	~~:{{Par2\| \|clip\| \|}}~~
	~~::Input clip~~

	:{{Par2\|gain_y\|float\|0}}		:{{Par2\|gain_y\|float\|0}}
Line 115:		Line 112:
	:{{Par2\|cont_u\|float\|0}}		:{{Par2\|cont_u\|float\|0}}
	:{{Par2\|cont_v\|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.		::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 – for example:		::If {{FuncArg\|cont_y}} = {{Serif\|''k''}}, then ''Y'' becomes (''Y''-128) '''·''' {{Serif\|''k''}} / 256 + 128 – for example:
	:: ('''TL;DR''' ''see [[#Parameter_Rescaling\|Parameter Rescaling]] below'')		:: ('''TL;DR''' ''see [[#Parameter_Rescaling\|Parameter Rescaling]] below'')
	::{\|class="wikitable"		::{\|class="wikitable"
Line 144:		Line 141:
	\|style="text-align:left;padding:0.3em;"\| 3.0		\|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.		::*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}}		:{{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 – 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}}		:{{Par2\|analyze\|bool\|false}}
Line 182:		Line 177:
	:{{Par2\|bits\|int\|8}}		:{{Par2\|bits\|int\|8}}
	::{{AvsPluscon}} Sets the bit depth of {{FuncArg\|showyuv}} output. Must be 8, 10, 12, 14 or 16.		::{{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 – see next item.

	:{{Par2\|showyuv_fullrange\|bool\|false}}		:{{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.
	::~~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.
			::At {{FuncArg\|bits}}>8, size of the generated clip grows from 1800x1800 to 2048x2048.
	</div>		</div>

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

2017-04-28T03:57:04Z

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

← Older revision		Revision as of 05:57, 28 April 2017
Line 7:		Line 7:

	* In AviSynth 2.6, all [[YUV]] color formats are supported ([[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]] and [[YUY2]])		* In AviSynth 2.6, all [[YUV]] color formats are supported ([[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]] and [[YUY2]])
	* {{AvsPluscon}} all [[YUV]] and [[YUVA]] ~~integer~~ color formats are supported.		* {{AvsPluscon}} all non-[[Float_(color_format)\|Float]] [[YUV]] and [[YUVA]] color formats are supported.
			* {{AvsPluscon}} all parameters are [[Autoscale_parameter\|autoscaling]] – they work without changes at all bit depths.



Line 213:		Line 215:
	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>
	~~{{AvsPluscon}} Note, all '''ColorYUV''' parameters work without changes at all bit depths.~~
	</div>		</div>

← Older revision		Revision as of 00:54, 6 March 2018
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)		::*{{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).		::*'''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:
			:::*{{FuncArg\|levels}}="TV->PC", or {{FuncArg\|levels}}="TV",
			:::*or {{FuncArg\|opt}}="coring" and {{FuncArg\|levels}} is ''not'' "PC->TV" or "PC->TV.Y"

	:{{Par2\|cont_y\|float\|0}}		:{{Par2\|cont_y\|float\|0}}
Line 146:		Line 148:

	:{{Par2\|levels\|string\|""}}		:{{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}} → 0{{D}}-255{{D}} (contrast increasing) conversion is made		::*If {{FuncArg\|levels}}="<tt>TV->PC</tt>", a 16{{D}}-235{{D}} → 0{{D}}-255{{D}} (contrast increasing) conversion is made
	::*If {{FuncArg\|levels}}="<tt>PC->TV</tt>", a 0{{D}}-255{{D}} → 16{{D}}-235{{D}} (contrast decreasing) conversion is made		::*If {{FuncArg\|levels}}="<tt>PC->TV</tt>", a 0{{D}}-255{{D}} → 16{{D}}-235{{D}} (contrast decreasing) conversion is made
	::*If {{FuncArg\|levels}}="<tt>PC->TV.Y</tt>", a 0{{D}}-255{{D}} → 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}} → 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		::*By default, no conversion is made
			::{{AvsPluscon}} adds "<tt>TV</tt>", which does no conversion; it only tells the filter that {{FuncArg\|gamma}}''_x'' will operate on a TV range clip.

	:{{Par2\|opt\|string\|""}}		:{{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]].		::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 – see {{FuncArg\|showyuv_fullrange}} below		::{{AvsPluscon}} Size changes depending on options selected – 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}}		:{{Par2\|analyze\|bool\|false}}
Line 188:		Line 189:

	:{{Par2\|f2c\|bool\|false}}		:{{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".		::For example, with {{FuncArg\|f2c}}=''true'', {{FuncArg\|cont_u}}=1.2 results in a 20% increase in ''U'' channel "saturation".
	</div>		</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:		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) {		function f2c(float f) {
	return (f - 1.0) * 256.0		return (f - 1.0) * 256.0
Line 215:		Line 216:

	## ...which specified normally, would look like this:		## ...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.
			ColorYUV(gain_y={{BoldColor\|blue\|100\|2.0}}, cont_u={{BoldColor\|blue\|100\|1.2}}, cont_v={{BoldColor\|blue\|100\|0.8}}, {{FuncArg\|f2c}}=true)

	</div>		</div>
	</div>		</div>

← Older revision		Revision as of 02:59, 30 April 2017
Line 32:		Line 32:
	bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>		bool ''autowhite'', bool ''autogain'', bool ''conditional'',<br>
	int ''bits'', bool ''showyuv_fullrange'' ] )}} {{AvsPluscon}}		int ''bits'', bool ''showyuv_fullrange'' ] )}} {{AvsPluscon}}

	~~:{{Par2\| \|clip\| \|}}~~
	~~::Input clip~~

	:{{Par2\|gain_y\|float\|0}}		:{{Par2\|gain_y\|float\|0}}
Line 115:		Line 112:
	:{{Par2\|cont_u\|float\|0}}		:{{Par2\|cont_u\|float\|0}}
	:{{Par2\|cont_v\|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.		::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 – for example:		::If {{FuncArg\|cont_y}} = {{Serif\|''k''}}, then ''Y'' becomes (''Y''-128) '''·''' {{Serif\|''k''}} / 256 + 128 – for example:
	:: ('''TL;DR''' ''see [[#Parameter_Rescaling\|Parameter Rescaling]] below'')		:: ('''TL;DR''' ''see [[#Parameter_Rescaling\|Parameter Rescaling]] below'')
	::{\|class="wikitable"		::{\|class="wikitable"
Line 144:		Line 141:
	\|style="text-align:left;padding:0.3em;"\| 3.0		\|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.		::*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}}		:{{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 – 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}}		:{{Par2\|analyze\|bool\|false}}
Line 182:		Line 177:
	:{{Par2\|bits\|int\|8}}		:{{Par2\|bits\|int\|8}}
	::{{AvsPluscon}} Sets the bit depth of {{FuncArg\|showyuv}} output. Must be 8, 10, 12, 14 or 16.		::{{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 – see next item.

	:{{Par2\|showyuv_fullrange\|bool\|false}}		:{{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.
	::~~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.
			::At {{FuncArg\|bits}}>8, size of the generated clip grows from 1800x1800 to 2048x2048.
	</div>		</div>