Add Colour - Revision history

Redmaw: Corrected explanation for how Clamp high colour and Clamp low colours work. Not clamped to black and white, but to the values designated in the settings themselves.

2022-02-02T20:05:43Z

Corrected explanation for how Clamp high colour and Clamp low colours work. Not clamped to black and white, but to the values designated in the settings themselves.

← Older revision		Revision as of 20:05, 2 February 2022
Line 28:		Line 28:


	Although it’s possible for a component value to exceed the visual range of colours from pure black (0,0,0) to pure white (1,1,1), this is not recommended. In some shaders, such as the Power Fractal v3 shader, parameters exist to clamp the component values at ~~black or white~~. In the example below, the Main input contributes red values, and Input 2 contributes values that range less than zero ~~and~~ greater than 1. The Add Colour node will output values exceeding zero to 1 because the ~~checkboxes for clamping the~~ high and low colour ~~values between zero or 1~~ are unchecked. The result is that colours on the terrain appear unnaturally dark, almost burnt, where the colour values are below zero. Where they exceed 1, clipping can occur or unnatural shades of colour, such as the magenta areas.		Although it’s possible for a component value to exceed the visual range of colours from pure black (0,0,0) to pure white (1,1,1), this is not recommended. In some shaders, such as the Power Fractal v3 shader, parameters exist to clamp the component values at the values designated in the Apply high colour and Apply low colour settings. In the example below, the Main input contributes red values, and Input 2 contributes values that range from less than zero to greater than 1. The Add Colour node will output values exceeding zero to 1 because the Clamp high colour and Clamp low colour checkboxes in the Power fractal shader are unchecked. The result is that colours on the terrain appear unnaturally dark, almost burnt, where the colour values are below zero. Where they exceed 1, clipping can occur or unnatural shades of colour, such as the magenta areas.
	<ul>		<ul>
	[[File:AddColour_09_AddColourExceed.jpg\|none\|800px\|When the evaluated component values (RGB) exceed the 0 to 1 range, the resulting colours can appear clipped or burnt in. ]]		[[File:AddColour_09_AddColourExceed.jpg\|none\|800px\|When the evaluated component values (RGB) exceed the 0 to 1 range, the resulting colours can appear clipped or burnt in. ]]

Redmaw: Reformatted layout of examples under Overview section, temporarily removing table of content and Fun With section until additional examples are created.

2022-01-28T23:16:22Z

Reformatted layout of examples under Overview section, temporarily removing table of content and Fun With section until additional examples are created.

← Older revision		Revision as of 23:16, 28 January 2022
Line 1:		Line 1:
	[[File:AddColour_00_GUI.png\|none\|470px\|Add Colour]]		[[File:AddColour_00_GUI.png\|none\|470px\|Add Colour]]

			<!-- __TOC__ -->
	__TOC__

	== Overview ==		== Overview ==

	The Add family of nodes allow you to add the colour/scalar/vector coming into the Main Input with the color/scalar/vector coming into Input 2.		The Add family of nodes allow you to add the colour/scalar/vector coming into the Main Input with the color/scalar/vector coming into Input 2.


	With Add Colour the addition is component-wise:		With Add Colour the addition is component-wise:
			<ul>

	Main Input.red + Input 2.red <br /n>		Main Input.red + Input 2.red <br /n>
	Main Input.green + Input 2.green <br /n>		Main Input.green + Input 2.green <br /n>
	Main Input.blue + Input 2.blue		Main Input.blue + Input 2.blue
			</ul>

	~~All nodes in this family have just one setting, which lets you assign a shader or function nodes to Input 2.~~


	~~'''Settings:'''~~

	*'''Name:''' This setting allows you to apply a descriptive name to the node, which can be helpful when using multiple Add Colour nodes in a project.

	*'''Enable:''' When checked, the node is active and the Main Input value is added with the Input 2 value. When unchecked, only the Main Input value is passed through the node.

	*'''Input 2:''' The values from the shader or function nodes assigned to this setting are added to the values of the Main Input.


	~~== Fun with Add Colour ==~~

	~~Remember that each of the colour component values, the red, green, and blue channel values, from the Main Input and the Input 2 settings are added together to achieve the final result.~~


Line 45:		Line 28:


	Although it’s possible for a component value to exceed the visual range of colours from pure black (0,0,0) to pure white (1,1,1), this is not recommended. In some shaders, such as the Power Fractal v3 shader, parameters exist to clamp the component values at black or white.		Although it’s possible for a component value to exceed the visual range of colours from pure black (0,0,0) to pure white (1,1,1), this is not recommended. In some shaders, such as the Power Fractal v3 shader, parameters exist to clamp the component values at black or white. In the example below, the Main input contributes red values, and Input 2 contributes values that range less than zero and greater than 1. The Add Colour node will output values exceeding zero to 1 because the checkboxes for clamping the high and low colour values between zero or 1 are unchecked. The result is that colours on the terrain appear unnaturally dark, almost burnt, where the colour values are below zero. Where they exceed 1, clipping can occur or unnatural shades of colour, such as the magenta areas.

	In the example below, the Main input contributes red values, and Input 2 contributes values that range less than zero and greater than 1. The Add Colour node will output values exceeding zero to 1 because the checkboxes for clamping the high and low colour values between zero or 1 are unchecked. The result is that colours on the terrain appear unnaturally dark, almost burnt, where the colour values are below zero. Where they exceed 1, clipping can occur or unnatural shades of colour, such as the magenta areas.
	<ul>		<ul>
	[[File:AddColour_09_AddColourExceed.jpg\|none\|800px\|When the evaluated component values (RGB) exceed the 0 to 1 range, the resulting colours can appear clipped or burnt in. ]]		[[File:AddColour_09_AddColourExceed.jpg\|none\|800px\|When the evaluated component values (RGB) exceed the 0 to 1 range, the resulting colours can appear clipped or burnt in. ]]
	</ul>		</ul>


			All nodes in this family have just one setting, which lets you assign a shader or function nodes to Input 2.


			'''Settings:'''

			*'''Name:''' This setting allows you to apply a descriptive name to the node, which can be helpful when using multiple Add Colour nodes in a project.

			*'''Enable:''' When checked, the node is active and the Main Input value is added with the Input 2 value. When unchecked, only the Main Input value is passed through the node.

			*'''Input 2:''' The values from the shader or function nodes assigned to this setting are added to the values of the Main Input.


			<!-- == Fun with Add Colour ==
			Remember that each of the colour component values, the red, green, and blue channel values, from the Main Input and the Input 2 settings are added together to achieve the final result. -->

Redmaw: Removed text overlays from images in favor of text descriptions between example images.

2022-01-28T20:25:54Z

Removed text overlays from images in favor of text descriptions between example images.

← Older revision		Revision as of 20:25, 28 January 2022
Line 31:		Line 31:

	Remember that each of the colour component values, the red, green, and blue channel values, from the Main Input and the Input 2 settings are added together to achieve the final result.		Remember that each of the colour component values, the red, green, and blue channel values, from the Main Input and the Input 2 settings are added together to achieve the final result.


			In the example below, the Main Input contributes red values, and Input 2 contributes green values. Component-wise, the Main Input colour value is (1,0,0) and Input 2’s colour value is (0,1,0). The output of the Add Colour node is yellow (1,1,0).
	<ul>		<ul>
	{\|		[[File:AddColour_07_AddColour.jpg\|none\|800px\|The Add Colour node adds the component colour values from the Main Input and Input 2.]]
	\|-
	\| [[File:AddColour_04_AddColour.jpg\|none\|800px\|In this example, Main Input's colour values are red and the Input 2's colour values are green. When added together via the Add Colour node they make yellow.]]
	\|-
	\| [[File:~~AddColour_05_AddColourPF3~~.jpg\|none\|800px\|~~In this example, a Power Fractal shader assigned to Input 2 provides green values and black values. When added together via the~~ Add Colour node, the ~~green values become shades of yellow while the black values let the red~~ values from the Main Input ~~pass through~~.]]
	\|}
	</ul>		</ul>


	~~It’s possible for~~ the component ~~values~~ to ~~exceed~~ the ~~visual range of colours from~~ pure black (0,0,0) ~~to pure white~~ (1,1,1), ~~although this is not recommended~~, ~~and in some shaders such as~~ the Power Fractal ~~v3 shader, parameters exist to clamp~~ the colour ~~component~~ values ~~at black or white~~.		In the image below, the Main Input contributes red values, while Input 2 contributes values ranging from black to green, or component-wise, ranging from (0,0,0) to (0,1,0). The output of the Add Colour node results in red wherever pure black occured in Input 2, because red (1,0,0) plus black (0,0,0) equals red (1,0,0). Wherever a shade of green occurs in Input 2, the result is a shade of yellow, because red (1,0,0) plus green (0,1,0) equals yellow (1,1,0). Shades of yellow exist because the Power Fractal noise pattern produces a range of values between 0 and 1.
			<ul>
			[[File:AddColour_08_AddColourPF3.jpg\|none\|800px\|The Add Colour node adds the component colour values from the Main Input and Input 2.]]
			</ul>

	In the example below, colours of the terrain appear unnaturally dark, almost burnt, ~~when their~~ colour ~~component~~ values are below ~~0,0,0~~. ~~When component values~~ exceed ~~pure white~~, ~~this~~ can ~~lead to clipping~~ or unnatural shades of colour, such as the magenta areas ~~in the image below~~.
			Although it’s possible for a component value to exceed the visual range of colours from pure black (0,0,0) to pure white (1,1,1), this is not recommended. In some shaders, such as the Power Fractal v3 shader, parameters exist to clamp the component values at black or white.

			In the example below, the Main input contributes red values, and Input 2 contributes values that range less than zero and greater than 1. The Add Colour node will output values exceeding zero to 1 because the checkboxes for clamping the high and low colour values between zero or 1 are unchecked. The result is that colours on the terrain appear unnaturally dark, almost burnt, where the colour values are below zero. Where they exceed 1, clipping can occur or unnatural shades of colour, such as the magenta areas.
	<ul>		<ul>
	[[File:~~AddColour_06_AddColourExceed~~.jpg\|none\|800px\|When the evaluated component values (RGB) exceed the 0 to 1 range, the resulting colours can appear clipped or burnt in. ]]		[[File:AddColour_09_AddColourExceed.jpg\|none\|800px\|When the evaluated component values (RGB) exceed the 0 to 1 range, the resulting colours can appear clipped or burnt in. ]]
	</ul>		</ul>

Matt: Minor edit to first sentence

2022-01-21T02:08:50Z

Minor edit to first sentence

← Older revision		Revision as of 02:08, 21 January 2022
Line 6:		Line 6:
	== Overview ==		== Overview ==

	The Add family of nodes allow you to add the colour/scalar/vector coming into the Main Input by the color/scalar/vector coming into Input 2.		The Add family of nodes allow you to add the colour/scalar/vector coming into the Main Input with the color/scalar/vector coming into Input 2.

	With Add Colour the addition is component-wise:		With Add Colour the addition is component-wise:

Matt: Made opening more specific to Add Colour

2022-01-21T01:35:39Z

Made opening more specific to Add Colour

← Older revision		Revision as of 01:35, 21 January 2022
Line 6:		Line 6:
	== Overview ==		== Overview ==

	The Add family of nodes allow you to add the colour/scalar/vector coming into the Main Input by the color/scalar/vector coming into Input 2. ~~The~~ addition is component-wise~~, for example with colour~~:		The Add family of nodes allow you to add the colour/scalar/vector coming into the Main Input by the color/scalar/vector coming into Input 2.

			With Add Colour the addition is component-wise:

Redmaw: Updated descriptions and added example images.

2021-12-29T03:56:41Z

Updated descriptions and added example images.

@@ Line 1: / Line 1: @@
-[[Image:drex_module_41_image_0.png|485pxpx|Add Colour]]
+[[File:AddColour_00_GUI.png|none|470px|Add Colour]]
-Input.red + Input 2.red
+__TOC__
-Input.green + Input 2.green
+== Overview ==
-Input.blue + Input 2.blue
+The Add family of nodes allow you to add the colour/scalar/vector coming into the Main Input by the color/scalar/vector coming into Input 2. The addition is component-wise, for example with colour:
-'''Settings:'''
+Main Input.red + Input 2.red <br /n>
-All nodes in this family have just the one setting, which lets you choose a node for Input 2.
+Main Input.green + Input 2.green <br /n>
 [[Category: Add]]

JavaJones at 18:26, 1 June 2011

2011-06-01T18:26:33Z

← Older revision		Revision as of 18:26, 1 June 2011
Line 15:		Line 15:
	All nodes in this family have just the one setting, which lets you choose a node for Input 2.		All nodes in this family have just the one setting, which lets you choose a node for Input 2.

	[[Category: Add\| ]]		[[Category: Add]]

JavaJones at 00:53, 18 May 2011

2011-05-18T00:53:17Z

← Older revision		Revision as of 00:53, 18 May 2011
Line 15:		Line 15:
	All nodes in this family have just the one setting, which lets you choose a node for Input 2.		All nodes in this family have just the one setting, which lets you choose a node for Input 2.

	[[Category: Add]]		[[Category: Add\| ]]

JavaJones at 23:28, 17 May 2011

2011-05-17T23:28:32Z

← Older revision		Revision as of 23:28, 17 May 2011
Line 15:		Line 15:
	All nodes in this family have just the one setting, which lets you choose a node for Input 2.		All nodes in this family have just the one setting, which lets you choose a node for Input 2.

	~~[[Category: Function Nodes]]~~
	[[Category: Add]]		[[Category: Add]]

JavaJones at 21:19, 17 May 2011

2011-05-17T21:19:33Z

← Older revision		Revision as of 21:19, 17 May 2011
Line 1:		Line 1:
	~~[[Category:IMPORT]]~~
	~~='''Add Colour'''=~~

	[[Image:drex_module_41_image_0.png\|485pxpx\|Add Colour]]		[[Image:drex_module_41_image_0.png\|485pxpx\|Add Colour]]
	~~__NOTOC__~~

	'''Node Description & Purpose:'''		'''Node Description & Purpose:'''
Line 18:		Line 14:
	'''Settings:'''		'''Settings:'''
	All nodes in this family have just the one setting, which lets you choose a node for Input 2.		All nodes in this family have just the one setting, which lets you choose a node for Input 2.

			[[Category: Function Nodes]]
			[[Category: Add]]