Add Colour

From Terragen Documentation from Planetside Software
Jump to navigation Jump to search
Add Colour
Add Colour


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.


With Add Colour the addition is component-wise:

    Main Input.red + Input 2.red
    Main Input.green + Input 2.green
    Main Input.blue + Input 2.blue


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).

    The Add Colour node adds the component colour values from the Main Input and Input 2.
    The Add Colour node adds the component colour values from the Main Input and Input 2.


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.

    The Add Colour node adds the component colour values from the Main Input and Input 2.
    The Add Colour node adds the component colour values from the Main Input and Input 2.


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.

    When the evaluated component values (RGB) exceed the 0 to 1 range, the resulting colours can appear clipped or burnt in.
    When the evaluated component values (RGB) exceed the 0 to 1 range, the resulting colours can appear clipped or burnt in.


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.