Vector to Colour

From Terragen Documentation from Planetside Software
Jump to: navigation, search
Vector to Colour


The Vector to colour node converts the Input vector into a colour. This conversion happens according to the node input type conversion rules which are described in the Node Input Type Conversion documentation.

When converting a vector to a colour, a piecewise component copy is done: becomes vector.x becomes vector.y becomes vector.z

The following example is for illustrative purposes only. An EXR image supplies vector data to displace the planet surface. The vector data is also passed to a Normalise vector node prior to being passed to a Vector to colour node because some of the vector values will exceed the visual range, 0 to 1 or sRGB 0 - 255. Once normalised, the vector data is then converted to colour via the Vector to colour node.

Node Network view illustrating the vector data supplied by an EXR file both displacing and colouring the planet surface.
Render views illustrating the vector data supplied by an EXR file being assigned to a Surface layer’s Colour function and Luminosity function.


  • Name: This setting allows you to apply a descriptive name to the node, which can be helpful when using multiple Vector to colour nodes in a project.
  • Enable: When checked, the node is active and the conversion 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.

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.

Literally, to change the position of something. In graphics terminology to displace a surface is to modify its geometric (3D) structure using reference data of some kind. For example, a grayscale image might be taken as input, with black areas indicating no displacement of the surface, and white indicating maximum displacement. In Terragen 2 displacement is used to create all terrain by taking heightfield or procedural data as input and using it to displace the normally flat sphere of the planet.

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.