Multiply Scalar: Difference between revisions

From Terragen Documentation from Planetside Software
Jump to navigation Jump to search
← Older edit
No edit summary
Redmaw (talk | contribs)
3,961 edits
Updated descriptions and added example images.
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Image:drex_module_75_image_0.png|485pxpx|Multiply Scalar]]
<div style="float:right; border-style:solid; padding:20px"><categorytree mode=pages hideroot=off>Multiply</categorytree></div>


'''Node Description & Purpose: '''<br /> The Multiply family of nodes allow you to multiply the colour/scalar/vector coming into the Input by the color/scalar/vector coming into Input 2. The multiplication is component-wise, for example with a colour :<br /><br /> Input.red '''multiplied by''' Input 2.red<br /> Input.green '''multiplied by''' Input 2.green<br /> Input.blue '''multiplied by''' Input 2.blue<br /><br />'''Node Type: ''' Function<br /><br />'''Settings: '''<br /> All nodes in this family have just the one setting, which lets you choose a node for Input 2.
[[File:MultiplyScalar_00_GUI.png|none|470px|Multiply Scalar]]


<!-- imported from file: module_75.html-->


[[Category:Multiply| ]]
== Overview ==
The Multiply family of nodes allow you to multiply the colour/scalar/vector coming into the Main Input by the color/scalar/vector coming into Input 2.
 
 
The Multiply Scalar node multiplies two scalars together. It wants the incoming data to be scalars, and will convert colours and vectors to scalars if necessary as follows:
<ul>
* Colour data is converted to scalar based on the component’s luminance values.  The math for this is: 0.2125 * r + 0.7152 * g + 0.0724 * b.
* Vector data is converted to scalar data, based on the length of the vector from the zero origin. The math for this is: square_root(x * x + y * y + z * z).
</ul>
 
[[File: MultiplyColour 02 Chart.JPG|none|800px|A comparison of the Multiply family of node’s output to that of the Main Input, as the value of Input 2 is changed.]]
 
 
The following example illustrates the effect of the Multiply scalar node on a cloud layer’s Final density parameter as the value from Input 2 changes. 
<ul>
{|
|-
| [[File:MultiplyScalar_02_Clouds.JPG|none|800px|As the value assigned to Input 2 of the Multiply scalar node changes, the Final density of the cloud layer changes. ]]
|-
| [[File:MultiplyScalar_03_NodeNetwork.jpg|none|800px|Node network view illustrating the use of the Multiply scalar node to adjust the Final density of a cloud layer.]]
|}
</ul>
 
In this example, the value assigned to Input 2 is 0.5, which results in the cloud layer’s Final density value to be half as dense as the source values assigned to the Main Input.
<ul>
{|
|-
| [[File:MultiplyScalar_04Clouds_0p5.jpg|None|800 px|In this example, changing the value of Input 2 to 0.5 results in the cloud layer being half as dense as the values assigned to the Main Input.]]
|-
| [[File:MultiplyScalar_05_NodeNetwork.jpg|None|800px|In this example, changing the value of Input 2 to 0.5 results in the cloud layer being half as dense as the values assigned to the Main Input.]]
|}
</ul>
 
In this example, the value assigned to Input 2 is 4.0, which results in the cloud layer’s Final density value to be four times as dense as the source values assigned to the Main input.
<ul>
{|
|-
| [[File:MultiplyScalar_06ouds_4p0.jpg|None|800 px|In this example, changing the value of Input 2 to 4.0 results in the cloud layer being four times as dense as the values assigned to the Main input.]]
|-
| [[File:MultiplyScalar_07_NodeNetwork.jpg|None|800px|In this example, changing the value of Input 2 to 4.0 results in the cloud layer being four times as dense as the values assigned to the Main input.]]
|}
</ul>
 
If a shader or function nodes are not connected to Input 2, the Main Input is simply passed through the Multiple scalar node’s output.
<ul>
{|
|-
|[[File:MultiplyScalar_08ouds_1p0.jpg|none|800px|When Input 2 is disconnected, the Main Input is passed through the node.]]
|-
| [[File:MultiplyScalar_09_NodeNetwork.jpg|none|800px|When Input 2 is disconnected, the Main Input is passed through the node.]]
|}
</ul>
 
If a shader or function nodes are not connected to the Main Input, a value of 0, or black, is passed through the node.
<ul>
{|
|-
| [[File:MultiplyScalar_10Clouds_Off.jpg|none|800px|When the Main input is unassigned, a value of 0, or black, is passed through the node.]]
|-
|[[File:MultiplyScalar_11_NodeNetwork.jpg|none|800px|When the Main input is unassigned, a value of 0, or black, is passed through the node.]]
|}
</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 Multiply Scalar nodes in a project.
*'''Enable:''' When checked, the node is active and the multiplication operation will take place. When unchecked the values assigned to its Main Input, if any, are passed through, otherwise a value of 0 is passed through.
*'''Input 2:''' The values from the shader or function nodes assigned to this setting are multiplied with the Main Input values. When nothing is assigned, the Main Input values, if any, are passed through. If the Main Input is unassigned, the output from the node is 0.
 
 
<br /n>
 
[[Category:Multiply]]

Latest revision as of 19:13, 28 February 2022

Multiply
Cross Product
Dot Product
Multiply Colour
Multiply Complement Colour
Multiply Complement Scalar
Multiply Scalar
Multiply Vector
Multiply Scalar
Multiply Scalar


Overview

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


The Multiply Scalar node multiplies two scalars together. It wants the incoming data to be scalars, and will convert colours and vectors to scalars if necessary as follows:

    • Colour data is converted to scalar based on the component’s luminance values. The math for this is: 0.2125 * r + 0.7152 * g + 0.0724 * b.
    • Vector data is converted to scalar data, based on the length of the vector from the zero origin. The math for this is: square_root(x * x + y * y + z * z).
A comparison of the Multiply family of node’s output to that of the Main Input, as the value of Input 2 is changed.
A comparison of the Multiply family of node’s output to that of the Main Input, as the value of Input 2 is changed.


The following example illustrates the effect of the Multiply scalar node on a cloud layer’s Final density parameter as the value from Input 2 changes.

    As the value assigned to Input 2 of the Multiply scalar node changes, the Final density of the cloud layer changes.
    As the value assigned to Input 2 of the Multiply scalar node changes, the Final density of the cloud layer changes.
    Node network view illustrating the use of the Multiply scalar node to adjust the Final density of a cloud layer.
    Node network view illustrating the use of the Multiply scalar node to adjust the Final density of a cloud layer.


In this example, the value assigned to Input 2 is 0.5, which results in the cloud layer’s Final density value to be half as dense as the source values assigned to the Main Input.

    In this example, changing the value of Input 2 to 0.5 results in the cloud layer being half as dense as the values assigned to the Main Input.
    In this example, changing the value of Input 2 to 0.5 results in the cloud layer being half as dense as the values assigned to the Main Input.


In this example, the value assigned to Input 2 is 4.0, which results in the cloud layer’s Final density value to be four times as dense as the source values assigned to the Main input.

    In this example, changing the value of Input 2 to 4.0 results in the cloud layer being four times as dense as the values assigned to the Main input.
    In this example, changing the value of Input 2 to 4.0 results in the cloud layer being four times as dense as the values assigned to the Main input.


If a shader or function nodes are not connected to Input 2, the Main Input is simply passed through the Multiple scalar node’s output.

    When Input 2 is disconnected, the Main Input is passed through the node.
    When Input 2 is disconnected, the Main Input is passed through the node.
    When Input 2 is disconnected, the Main Input is passed through the node.
    When Input 2 is disconnected, the Main Input is passed through the node.


If a shader or function nodes are not connected to the Main Input, a value of 0, or black, is passed through the node.

    When the Main input is unassigned, a value of 0, or black, is passed through the node.
    When the Main input is unassigned, a value of 0, or black, is passed through the node.
    When the Main input is unassigned, a value of 0, or black, is passed through the node.
    When the Main input is unassigned, a value of 0, or black, is passed through the node.


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 Multiply Scalar nodes in a project.
  • Enable: When checked, the node is active and the multiplication operation will take place. When unchecked the values assigned to its Main Input, if any, are passed through, otherwise a value of 0 is passed through.
  • Input 2: The values from the shader or function nodes assigned to this setting are multiplied with the Main Input values. When nothing is assigned, the Main Input values, if any, are passed through. If the Main Input is unassigned, the output from the node is 0.



A scalar is a single number. 1, 200.45, -45, -0.2 are all examples of scalar values.

A vector is a set of three scalars, normally representing X, Y and Z coordinates. It also commonly represents rotation, where the values are pitch, heading and bank.

A single object or device in the node network which generates or modifies data and may accept input data or create output data or both, depending on its function. Nodes usually have their own settings which control the data they create or how they modify data passing through them. Nodes are connected together in a network to perform work in a network-based user interface. In Terragen 2 nodes are connected together to describe a scene.

This is essentially the brightness of the colour. Terragen converts RGB colours to greyscale by taking the luminance of the colour.

A parameter is an individual setting in a node parameter view which controls some aspect of the node.

A shader is a program or set of instructions used in 3D computer graphics to determine the final surface properties of an object or image. This can include arbitrarily complex descriptions of light absorption and diffusion, texture mapping, reflection and refraction, shadowing, surface displacement and post-processing effects. In Terragen 2 shaders are used to construct and modify almost every element of a scene.

Retrieved from "https://docs.planetside.co.uk/w/index.php?title=Multiply_Scalar&oldid=15941"