Mappings

The mappings page allows you to setup the lighting exactly the way you like. A default profile is loaded when you launch Chromatics for the first time.

Chromatics 3 uses the concept of layers, you can setup multiple layers per device and map those layers to specific keys (or LEDs) on a device.

Layer Types

Base Layer

The base layer is always set as the lowest layer for each device type, it contains all keys/LEDs in a device. You can use this type of layer to set a solid colour over the entire device to build upon. This is a static layer that you cannot move, remove or add a new base layer.

Dynamic Layer

Dynamic Layers allow you to build out certain looks on your devices. There are many types of dynamic layers and you can add/remove specific keys from a dynamic layer.

Effect Layer

The effect layer contains all keys/LEDs of a device, and also can't be moved or removed. Most effects operate on this layer which is above all other layers.

Mappings

A	Device Selection Changes the currently displayed device type.
B	Import Layers Imports a layer file from your PC. This will overwrite all existing layers for all devices you have setup.
C	Export Layers Exports your current layer setup to a file on your PC.
D	Preview Layers Display your current layers on your devices.
E	Layer Type to Add Change what type of layer to add. Currently this is only set to Dynamic Layer.
F	Add Layer Add a new layer to the list, this will be added above the base layer. You cannot add a base or effect layer.
G	Layer ID The layer ID for each layer, which also indicates the stack order of the layer. A layer with a higher ID is always on top of a layer with a lower ID. You can drag and drop layers to change their order, but you cannot change the order of the base or effect layer.
H	Layer Type The layer type of the selected layer, either base, dynamic or effect layer.
I	Layer Function The function for the layer, which indicates the what type of FFXIV integration is attached to that layer. For a list of available functions, see FFXIV Functions.
J	Layer Enable Enable/disabled this layer.
K	Edit Layer Edit the keys assigned to the layer.
L	Delete/Copy Layer Deletes the selected layer. If you hold SHIFT, this will change to copy and allow you to duplicate the layer.
M	Enable Bleeding This button determines whether a layer can bleed through to lower layers when the current layer has nothing to display. When set to enabled, the layer can bleed through, and when set to disabled, the layer will not bleed through to lower layers.
N	Layer Mode On some layers, there are different modes available depending on the type of device.
O	Undo When editing a layer, you can undo any changes you have made using this button.
P	Reverse When editing a layer, you can reverse the selected keys using this button.
Q	Clear When editing a layer, you can clear all selected keys using this button. When clearing a layer, you will exit editing mode.
R	Key Selection When editing a layer, you can select which keys you want attached to the layer.

Keyboard Layouts

Currently only one keyboard layout en-us is available on the mapping tab. This is a QWERTY keyboard so if you use a different layout, such as AZERTY you will need to remap keys accordingly.

Layer Bleeding

By default, colour palettes for each layer function have a negative colour. This means that when this layer has nothing to display it will display the negative colour, usually black.

For example, if you have the dynamic layer HP Tracker assigned to a set of keys and you were currently at 50% HP, half of your keys will be the HP tracker colour palette (default green) and half of your keys will be the negative color (default black).

When bleeding is enabled for a layer, instead of showing the negative colour, it becomes transparent instead allowing lower layers to bleed through.

Layer Modes

Certain dynamic layers support changing the mode of the layer.

Interpolate

When set to interpolate, the lighting of the layer's selected keys will be spread across those keys. This can give the effect of a bar across your device (e.g. health bar).

Fade

When set to fade, the lighting of the layer's selected keys will all fade between the two colour's. This mode is good for non-keyboard devices which don't necessarily have consecutive key layouts.