Work in progress! This document is currently being compiled and edited. Contents may not be fully complete.

Lookup Tables

All coloration in Gaea is based on CLUTs, or color lookup tables. As 2D heightfields are essentially a grid of numbers ranging from 0.0 (lowest) to 1.0 (highest), CLUTs are represented as gradients which are mapped to those heights.

The lowest part of a gradient corresponds to the lowest part of the terrain, while the highest part of the gradient corresponds to the highest part of the terrain. Everything in between is evenly distributed.

// TODO: Image

In this example, you can see how the gradient from a CLUTer node maps to the heightfield.

If, however, you take the same CLUT map and use a FlowMap instead of using the height of the terrain as the input, you get a different type of texture output that follows the flow lines of the FlowMap output.

Node Structure

All color nodes (except Mixer) follow a simple structure: the main Input port for mapping the CLUT, and the Visualization port for the 3D heightfield to use for the viewport.

The latter is not necessary most of the time, but is recommended. Otherwise, your input may not look accurate in the preview because it will assume that the first 3D node prior to this node is the heightfield.

This port was created specifically to help visualize terrains while creating complex color maps.

Using Data Maps

To create color maps using Data Maps, see @color-datamaps.