RgbAdjust - Revision history

Raffriff42: remove body, redirect to ->RGBAdjust

2015-12-14T01:35:54Z

remove body, redirect to ->RGBAdjust

Raffriff42: remove category

2015-11-10T22:12:18Z

remove category

Raffriff42: add cat.

2014-08-23T22:57:49Z

add cat.

Raffriff42: corrected arg list (see levels.cpp, line 51), add cat.

2014-08-23T22:56:10Z

corrected arg list (see levels.cpp, line 51), add cat.

Admin: 1 revision

2013-05-09T15:02:27Z

1 revision

Gzarkadas: first port from old wiki

2007-02-16T00:34:34Z

first port from old wiki

New page

{{Template:FuncDef|RGBAdjust(clip ''clip'' [, float ''red''] [, float ''green''] [, float ''blue''] [, float ''alpha''] [, float ''rb''] [, float ''gb''] [, float ''bb''] [, float ''ab''] [, float ''rg''] [, float ''gg''] [, float ''bg''] [, float ''ag''] [, bool ''analyze''])}}

This filter multiplies each color channel with the given value, clipping the result at 255. Note that RGBAdjust(1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1) leaves the clip untouched.

''red'' (0.0-255.0; default 1.0): This option determines how much red is to be scaled. For example, a scale of x 3 multiplies the red channel of each pixel by 3. ''green'' and ''blue'' work similar.
''alpha'' (0.0-255.0; default 1.0) specifies the alpha channel, that is it represents the transparency information on a per-pixel basis. An alpha value of zero represents full transparency, and a value of 1 represents a fully opaque pixel.

In v2.56 the offsets ''rb'', ''gb'', ''bb'', ''ab'' (default 0.0) add a value to the red, green, blue or alpha channels. For example, ''rb'' = 16 will add 16 to the red pixel values and -32 will subtract 32 from all red pixel values.

Also in v2.56 the exponents ''rg'', ''gg'', ''bg'', ''ag'' (default 1.0) adjust the gamma of the red, green, blue or alpha channels. For example, ''rg'' = 1.2 will brighten the red pixel values and ''gg'' = 0.8 will darken the green pixel values.

In v2.56 ''analyze'' (can be true or false) will print out color statistics on the screen. There are maximum and minimum values for all channels. There is an average and a standard deviation for all channels. There is a "loose minimum" and "loose maximum". The "loose" values are made to filter out very bright or very dark noise creating an artificially low or high minimum / maximum (it just means that the amount of red/green/blue of 255/256 of all pixels is above (under) the loose minimum (maximum)).

Keep in mind ALL the values are not scaled to accomodate changes to one (for that you should use levels) so doing something like:

RGBAdjust(2, 1, 1, 1)

will get you a whole lot of clipped red. If you WANT a whole lot of clipped red, there ya go - but if you want MORE red without clipping you'd do

[[Levels]](0, 1, 255, 0, 128).RGBAdjust(2, 1, 1, 1)

This would scale all the levels (and average lum) by half, then double the red. Or more compact

RGBAdjust(1.0, 0.5, 0.5, 1.0)

This leaves the red and halves the green and blue.

To invert the alpha channel

RGBAdjust(a=-1.0, ab=255)

Thus alpha pixels values become a=(255-a).

'''Changes'''
|| v2.56 || added offsets, gamma, analyze ||

[[Category:Internal filters]]

← Older revision		Revision as of 22:12, 10 November 2015
Line 39:		Line 39:
	[[Category:Internal filters]]		[[Category:Internal filters]]
	[[Category:Levels and Chroma filters]]		[[Category:Levels and Chroma filters]]
−	~~[[Category:Chroma correction]]~~

← Older revision		Revision as of 22:57, 23 August 2014
Line 37:		Line 37:
	\|\| v2.56 \|\| added offsets, gamma, analyze \|\|		\|\| v2.56 \|\| added offsets, gamma, analyze \|\|

−	~~[[Category:Chroma correction]]~~
	[[Category:Internal filters]]		[[Category:Internal filters]]
		+	[[Category:Levels and Chroma filters]]
		+	[[Category:Chroma correction]]

@@ Line 1: / Line 1: @@
-{{Template:FuncDef|RGBAdjust(clip ''clip'' [, float ''r''] [, float ''g''] [, float ''b''] [, float ''a''] [, float ''rb''] [, float ''gb''] [, float ''bb''] [, float ''ab''] [, float ''rg''] [, float ''gg''] [, float ''bg''] [, float ''ag''] [, bool ''analyze''] [, bool ''dither''])}}
+#REDIRECT [[RGBAdjust]]
+[[Category:Redirects]]
-This filter multiplies each color channel with the given value, clipping the result at 255. Note that RGBAdjust(1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1) leaves the clip untouched.
-−
-''r'' (0.0-255.0; default 1.0): This option determines how much red is to be scaled. For example, a scale of x 3 multiplies the red channel of each pixel by 3. ''green'' and ''blue'' work similar.
-''a'' (0.0-255.0; default 1.0) specifies the alpha channel, that is it represents the transparency information on a per-pixel basis. An alpha value of zero represents full transparency, and a value of 1 represents a fully opaque pixel.
-−
-In v2.56 the offsets ''rb'', ''gb'', ''bb'', ''ab'' (default 0.0) add a value to the red, green, blue or alpha channels. For example, ''rb'' = 16 will add 16 to the red pixel values and -32 will subtract 32 from all red pixel values.
-−
-Also in v2.56 the exponents ''rg'', ''gg'', ''bg'', ''ag'' (default 1.0) adjust the gamma of the red, green, blue or alpha channels. For example, ''rg'' = 1.2 will brighten the red pixel values and ''gg'' = 0.8 will darken the green pixel values.
-−
-In v2.56 ''analyze'' (can be true or false) will print out color statistics on the screen. There are maximum and minimum values for all channels. There is an average and a standard deviation for all channels. There is a "loose minimum" and "loose maximum". The "loose" values are made to filter out very bright or very dark noise creating an artificially low or high minimum / maximum (it just means that the amount of red/green/blue of 255/256 of all pixels is above (under) the loose minimum (maximum)).
-−
-In v2.60 ''dither'' = true/false (false by default): When set to true, [[ordered dithering]] is applied when doing the adjustment.
-−
-Keep in mind ALL the values are not scaled to accommodate changes to one (for that you should use levels) so doing something like:
-−
- RGBAdjust(2, 1, 1, 1)
-−
-will get you a whole lot of clipped red. If you WANT a whole lot of clipped red, there ya go - but if you want MORE red without clipping you'd do
-−
- [[Levels]](0, 1, 255, 0, 128).RGBAdjust(2, 1, 1, 1)
-−
-This would scale all the levels (and average lum) by half, then double the red. Or more compact
-−
- RGBAdjust(1.0, 0.5, 0.5, 1.0)
-−
-This leaves the red and halves the green and blue.
-−
-To invert the alpha channel
-−
- RGBAdjust(a=-1.0, ab=255)
-−
-Thus alpha pixels values become a=(255-a).
-−
-'''Changes'''
-|| v2.56 || added offsets, gamma, analyze ||
-−
-[[Category:Internal filters]]
-[[Category:Levels and Chroma filters]]