Add Scalar - Revision history

Redmaw: Disabled table of contents for now, until Fun With section has some examples.

2022-01-28T22:31:49Z

Disabled table of contents for now, until Fun With section has some examples.

← Older revision		Revision as of 22:31, 28 January 2022
Line 2:		Line 2:


	__TOC__		<!-- __TOC__ -->

	== Overview ==		== Overview ==

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

2022-01-28T22:30:52Z

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

← Older revision		Revision as of 22:30, 28 January 2022
Line 14:		Line 14:


	~~'''Settings~~:~~'''~~		In the example image below, the Add Scalar node simply adds the scalar values from the nodes assigned to it.
			<ul>
			[[File:AddScalar_10_Scalar.JPG\|none\|800px\|The Add Scalar node adds together the scalar data from the Main Input and Input 2.]]
			</ul>

	*'''Name:''' This setting allows you to apply a descriptive name to the node, which can be helpful when using multiple Add Scalar 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 Scalar ==		The Add Scalar node requires scalar data. One way to convert colour data to scalar data is shown below, where the Luminance to scalar node is used to convert the colour output of the Power fractal node.
			<ul>
			[[File:AddScalar_11_ColourInputsPF3.JPG\|none\|800px\|The Add scalar node requires scalar data. One way to convert colour data to scalar data is by using a Luminous to scalar node.]]
			</ul>

	~~[[File:AddScalar_09_ScalarToScalar.JPG\|none\|800px\|The Add scalar node requires scalar data. Here the colour output from the red nodes is converted to scalar data via the Luminous to scalar nodes.]]~~

			The Add Scalar node will automatically convert non-scalar data to scalar before adding them together as described above. Only scalar data is recognized and any displacement data a shader provides is ignored and not passed through. In the example below, the colour values from both Power fractal shaders are converted to scalar data and the displacement data discarded. Only scalar values are output by the Add Scalar node.
			<ul>
			[[File:AddScalar_12_PF3DisplaceIgnored.JPG\|none\|800px\|The Add Scalar node will convert non-scalar values to scalar and ignores any displacement data.]]
			</ul>

	~~[[File:AddScalar_01_MainInputAndInput2.JPG\|none\|800px\| Add scalar combines the Main Input and Input 2 component values, discarding displacement data, and outputting scalar data.]]~~

			When Input 2 is unassigned, the Main Input’s component values are passed through, first converting them to scalar if necessary.
			<ul>
			[[File:AddScalar_13_MainInputOnly.JPG\|none\|800px\|When Input 2 is unassigned, data from the Main Input is passed through as scalar data.]]
			</ul>

	~~[[File:AddScalar_02_MainInputOnly.JPG\|none\|800px\|When Input 2 is unassigned, data from the Main Input is passed through as scalar data.]]~~

			When the Main Input is unassigned, the value zero (black) is passed through.
			<ul>
			[[File:AddScalar_14_Input2Only.JPG\|none\|800px\|When the Main Input is unassigned, the value zero (black) is passed through.]]
			</ul>

	~~[[File:AddScalar_03_Input2Only.JPG\|none\|800px\|When the Main Input is unassigned, nothing is passed through.]]~~

			When colour sources are assigned to the Main Input or Input 2, the colour’s luminance value is used as described above. Only scalar data is output.
			<ul>
			[[File:AddScalar_15_ColourInputs.JPG\|none\|800px\|Colour sources are converted to scalar by using the colour’s luminance value.]]
			</ul>

	~~[[File:AddScalar_04_ColourInputs.JPG\|none\|800px\|When colour values are used as the source for the Main Input and Input 2, their component’s luminance values are used.]]~~

			When vector sources are assigned to the Main Input or Input 2, the node produces a scalar value based on the length of the vector as described above. Only scalar data is output.
			<ul>
			[[File:AddScalar_16_VectorInputs.JPG\|none\|800px\|Vector sources are converted to scalar based on the length of the vector. The math is square_root(xx + yy + z*z).]]
			</ul>

	[[File:~~AddScalar_05_VectorInputs~~.JPG\|~~none\|800px\|When vector values are used as the source, the scalar values are based on the length of the vector from a zero origin.~~]]		<!-- [[File:AddScalar_17_VectorAndColourInputs.JPG\|400px]] -->


	~~[[File~~:AddScalar_08_VectorAndColourInputs.JPG\|none\|800px\|Vector and colour values can be used simultaneously as inputs to the Add Scalar node. Their component values are converted as necessary and output as scalar data.]]		'''Settings:'''

			*'''Name:''' This setting allows you to apply a descriptive name to the node, which can be helpful when using multiple Add Scalar 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 Scalar == -->

Matt: Changed wording of luminance conversion and removed "from the zero origin" when talking about the length of a vector.

2022-01-28T03:59:22Z

Changed wording of luminance conversion and removed "from the zero origin" when talking about the length of a vector.

← Older revision		Revision as of 03:59, 28 January 2022
Line 9:		Line 9:
	The Add Scalar node adds two scalars together. It wants the incoming data to be scalars, but it will convert colours and vectors to scalars if necessary.		The Add Scalar node adds two scalars together. It wants the incoming data to be scalars, but it will convert colours and vectors to scalars if necessary.

	* When the source of the incoming data is colour data, the Add Scalar node converts the data to scalar based on the ~~component's~~ luminance ~~values~~. The math for this is: 0.2125 * r + 0.7152 g + 0.0724 b.		* When the source of the incoming data is colour data, the Add Scalar node converts the data to scalar based on the luminance of the colour. The math for this is: 0.2125 * r + 0.7152 g + 0.0724 b.

	* When the source of the incoming data is vector data, the Add Scalar node converts the data to scalar based on the length of the vector ~~from the zero origin~~. The math for this is: square_root(xx + yy + z*z).		* When the source of the incoming data is vector data, the Add Scalar node converts the data to scalar based on the length of the vector. The math for this is: square_root(xx + yy + z*z).

Redmaw: Repointed GUI image to clean version.

2022-01-21T06:38:15Z

Repointed GUI image to clean version.

← Older revision		Revision as of 06:38, 21 January 2022
Line 1:		Line 1:
	[[File:~~AddScalar_00_GUI~~.png\|none\|470px\|Add Scalar]]		[[File:AddScalar_00a_GUI.png\|none\|470px\|Add Scalar]]

Redmaw: Added additional example image to Fun With section, showing scalar data fed into Add scalar node.

2022-01-21T06:35:57Z

Added additional example image to Fun With section, showing scalar data fed into Add scalar node.

← Older revision		Revision as of 06:35, 21 January 2022
Line 21:		Line 21:

	== Fun with Add Scalar ==		== Fun with Add Scalar ==

			[[File:AddScalar_09_ScalarToScalar.JPG\|none\|800px\|The Add scalar node requires scalar data. Here the colour output from the red nodes is converted to scalar data via the Luminous to scalar nodes.]]


	[[File:AddScalar_01_MainInputAndInput2.JPG\|none\|800px\| Add scalar combines the Main Input and Input 2 component values, discarding displacement data, and outputting scalar data.]]		[[File:AddScalar_01_MainInputAndInput2.JPG\|none\|800px\| Add scalar combines the Main Input and Input 2 component values, discarding displacement data, and outputting scalar data.]]

Redmaw: Fixed typo and colour description on last image.

2022-01-21T05:00:16Z

Fixed typo and colour description on last image.

← Older revision		Revision as of 05:00, 21 January 2022
Line 37:		Line 37:


			[[File:AddScalar_08_VectorAndColourInputs.JPG\|none\|800px\|Vector and colour values can be used simultaneously as inputs to the Add Scalar node. Their component values are converted as necessary and output as scalar data.]]
	[[File:~~AddScalar_06_VectorAndColourInputs~~.JPG\|none\|800px\|Vector and colour values can be used simultaneously as inputs to the Add Scalar node. Their component values are converted as necessary and output as scalar data.]]

Redmaw: Removed example image of VDM because displacement cancelled out vector data

2022-01-21T04:45:59Z

Removed example image of VDM because displacement cancelled out vector data

← Older revision		Revision as of 04:45, 21 January 2022
Line 41:		Line 41:



	~~[[File:AddScalar_07_VDMAndColourInputs.JPG\|none\|800px\|No matter the type of source data, the output of the Add Scalar node is scalar data.]]~~

Matt: Edited overview for clarity.

2022-01-21T01:48:23Z

Edited overview for clarity.

← Older revision		Revision as of 01:48, 21 January 2022
Line 5:		Line 5:

	== 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 colour/scalar/vector coming into Input 2.

	The Add Scalar node wants the incoming data to be scalars, but it will convert colours and vectors to scalars if necessary.		The Add Scalar node adds two scalars together. It wants the incoming data to be scalars, but it will convert colours and vectors to scalars if necessary.

	When the source of the incoming data is colour data, the Add Scalar node converts the data to scalar based on the component's luminance values. The math for this is: 0.2125 * r + 0.7152 g + 0.0724 b.		* When the source of the incoming data is colour data, the Add Scalar node converts the data to scalar based on the component's luminance values. The math for this is: 0.2125 * r + 0.7152 g + 0.0724 b.

	When the source of the incoming data is vector data, the Add Scalar node converts the data to scalar based on the length of the vector from the zero origin. The math for this is: square_root(xx + yy + z*z).		* When the source of the incoming data is vector data, the Add Scalar node converts the data to scalar based on the length of the vector from the zero origin. The math for this is: square_root(xx + yy + z*z).

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

Matt: Capitalizing S in Add Scalar

2022-01-21T01:21:14Z

Capitalizing S in Add Scalar

← Older revision		Revision as of 01:21, 21 January 2022
Line 7:		Line 7:
	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 by the color/scalar/vector coming into Input 2.

	The Add ~~scalar~~ node wants the incoming data to be scalars, but it will convert colours and vectors to scalars if necessary.		The Add Scalar node wants the incoming data to be scalars, but it will convert colours and vectors to scalars if necessary.

	When the source of the incoming data is colour data, the Add ~~scalar~~ node converts the data to scalar based on the component's luminance values. The math for this is: 0.2125 * r + 0.7152 g + 0.0724 b.		When the source of the incoming data is colour data, the Add Scalar node converts the data to scalar based on the component's luminance values. The math for this is: 0.2125 * r + 0.7152 g + 0.0724 b.

	When the source of the incoming data is vector data, the Add ~~scalar~~ node converts the data to scalar based on the length of the vector from the zero origin. The math for this is: square_root(xx + yy + z*z).		When the source of the incoming data is vector data, the Add Scalar node converts the data to scalar based on the length of the vector from the zero origin. The math for this is: square_root(xx + yy + z*z).

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

Matt: Correction to previous edit

2022-01-21T01:19:14Z

Correction to previous edit

← Older revision		Revision as of 01:19, 21 January 2022
Line 7:		Line 7:
	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 by the color/scalar/vector coming into Input 2.

	The Add scalar node wants to incoming data ~~that are~~ scalars, but it will convert colours and vectors to scalars if necessary.		The Add scalar node wants the incoming data to be scalars, but it will convert colours and vectors to scalars if necessary.

	When the source of the incoming data is colour data, the Add scalar node converts the data to scalar based on the component's luminance values. The math for this is: 0.2125 * r + 0.7152 g + 0.0724 b.		When the source of the incoming data is colour data, the Add scalar node converts the data to scalar based on the component's luminance values. The math for this is: 0.2125 * r + 0.7152 g + 0.0724 b.