# palette.lbl This file is used to define a palette of colours which can be used under the circumstances defined by the associated labels. In the `livery.cfg` file, you can define a series of palette key / value pairs to be used for the livery being defined, and these will then be used to filter the palette LBL file and find a specific palette to match the circumstances of the flight the livery is being used in. {{< callout context="note" title="NOTE" icon="outline/bulb" >}} The name of the file is not important as all \*.lbl files are parsed when looking for a palette. {{< /callout >}}   Before listing the different keys that the LBL file requires, here is an example showing a single palette definition which can be used for reference when setting up your own: ``` json { "LabeledPalettes": [ { "Name": "SKP_Red_Black", "ColorPalette": [ "#cc1919", "#FFFFFF", "#cc1919", "#FFFFFF", "#333333", "#FFFFFF", "#333333", "#FFFFFF", "#333333", "#FFFFFF"], "Labels": [ { "Key": "Type", "Values":["SKP"] }, { "Key": "Continent", "Values":["Africa"] }, { "Key": "Color", "Values":["Red"] } ] } ] } ```     ### "LabeledPalettes" This is the **top level** key of the `.lbl` file, and *must be included* otherwise the file will be invalid. The value for this element is an *array*, where each *object* in the array is a single palette definition containing the `"Name"`, `"ColorPalette"`, and `"Lables"` keys.     ### "Name" This key expects a single value, which is a string defining the name of the palette. This name is *purely orientative* and is not used in the simulation. It is simply to help clearly identify each palette object within the file.     ### "ColorPalette" This key expects an array of strings, where each string contains a colour expressed as a hexadecimal value (RGB only, no alpha). The array can hold any number of colours, which will ideally (though not necessarily) correspond with the defined `[EDITABLE_COLORS]` in the [livery.cfg](../cfg-files/livery.cfg/) file.     ### "Labels" This key expects an array of 1 or more objects, where each object is a **"key"** and **"value"** pair. Label keys are used to further filter the list of palettes available such that only one is possible under any given situation, with the keys to check coming from the `[PALETTE_LABELS]` section of the [livery.cfg](../cfg-files/livery.cfg/) file.     ##### "Key" This key is used to define a key parameter to be used as a filter to find the correct palette to use.     ##### "Value" This is an array of values that accompany the given key to generate the filter used to find the correct palette to use.     ### Labels / Keys For Included Palettes The simulation has a number of included palettes that can be accessed using specific keys and optional values. You can use any number of these keys/values from the list below to select a colour palette for your own aircraft.     #### Geographic Keys When creating the palette labels, every **value** must have an associated **key**, but not every **key** requires a value. In the case of *geographic* keys, there are three that can be used with *no* value, which means that the simulation will automatically find the value from the simulation palette file based on the geographic location of the aircraft. The three available keys are:   - "**Continent**": When supplying this key, the simulation will search for a palette with the value corresponding to the continent the flight is taking place on. Accepted values in the palette library for this are:   - "**MergedCountry**": when supplying this key, the simulation will search for a palette with the value corresponding to the merged country the flight is taking place on (a merged country is a collection of countries grouped together based on geographic and socio-cultural parity). Accepted values in the palette library for this are:   - "**Country**": when supplying this key, the simulation will search for a palette with the value corresponding to the country the flight is taking place on. Accepted values in the palette library for this are:     #### Colours You can select a specific colour palette by supplying the "**Color**" key and then one of the following values: AllBlue Apple Green Red AppleGreen\_Blue AppleGreen\_DarkGreen\_Orange AppleGreen\_Red Black\_White Blue Blue Yellow White Blue\_DeepBlue Blue\_FullYellow Blue\_LightBlue Blue\_RedDarkBlueLines Blue\_Turquoise\_White Brown Beige White Brown\_Beige\_White Brown\_White Crimson DarkBlue White Crimson White Crimson\_PaleGreen Cyan\_DesaturatedBlue Cyan\_Yellow DarkBlue Gold DarkBlue\_Cyan\_Grey DarkBlue\_Orange DarkBlue\_Red DarkBlue\_Red\_White DarkBlue\_Red\_Yellow DarkBlue\_Yellow DarkBlue\_Yellow\_White DarkGreen Black Yellow DarkGreen\_Black\_Yellow DarkGreen\_PaleGreen DeepBlue Red White DeepBlue\_Red\_Orange DeepBlue\_White DeepBlue\_Yellow FullBlack\_Grey FullBlack\_Red FullBlue\_White FullGreen\_DarkBlue FullGreen\_Yellow\_Black\_Red FullOrange\_Black FullOrange\_White FullOrange\_White\_Green FullRed FullRed\_Green FullRed\_White FullRed\_Yellow FullWhite\_Blue FullWhite\_Cyan FullWhite\_DarkBlue FullWhite\_DarkBlue\_Red FullWhite\_DarkGreen FullWhite\_Gold\_Red FullWhite\_Green FullWhite\_Green\_Blue FullWhite\_Orange FullWhite\_PaleBlue FullWhite\_Red FullWhite\_Red\_Green FullWhite\_RedLines FullYellow\_Blue FullYellow\_DarkBlue FullYellow\_Green FullYellow\_Red FullYellow\_Red\_Green\_Black FullYellow\_VibrantBlue Gold\_Brown Gold\_White Green\_BlueRedLines Green\_Cyan Green\_DeepBlue Green\_Red Green\_White Grey\_Red Grey\_White LightBlue&VariousColors LightBlue\_DeepBlue Ocher PaleGreen DarkBlue Ocher White Ocher\_PaleGreen\_DarkBlue Ocher\_White Orange\_Blue\_White Orange\_DeepBlue\_White Orange\_GreenBlackLines Orange\_White Orange\_White\_Cyan PaleBlue\_Mauve\_DarkBlue\_Pink PaleBlue\_NavyBlue\_Red PaleBlue\_White PaleBlue\_White\_Green\_Red PaleYellow PaleGreen Brown PaleYellow\_Green\_Brown PaleYellow\_PaleBlue\_Green PaleYellow\_Red\_Brown\_Beige Pink\_Cyan\_Purple Purple\_Orange\_White Red Black Red\_Black Red\_DarkBlue\_White Red\_Grey\_White Red\_White Red\_Yellow Red\_Yellow\_White RedOcher\_White Sand Brown Sand White Sand\_Brown Sand\_LightBrown\_PaleGreen Sand\_Red Silver\_DeepBlue Silver\_Red White Black Red White Blue Black White Blue Red White Crimson White Crimson DarkBlue White DarkBlue White DarkBlue Red White DarkGreen Red White Gold Red Green White Green Blue Red Yellow White Green Grey Red White Green Red White Grey White Orange Green White Red White Red DeepBlue White Yellow DeepBlue White Yellow PaleRed White\_Blue White\_Blue\_Grey White\_Blue\_Orange White\_BlueGreenLines White\_BlueLines White\_Blues White\_Cyan\_Orange White\_DarkBlue\_Grey White\_DarkBlue\_Orange White\_DarkBlue\_Purple\_Cyan White\_DeepBlue White\_Gold White\_Green\_Blue\_Red White\_Green\_DarkBlue\_Yellow White\_Green\_Grey\_Gold White\_Green\_PaleOrange White\_Green\_Red White\_Green\_Red\_Black White\_Green\_Yellow\_Red White\_Grey\_BlueLines White\_Grey\_Cyan White\_Orange White\_Orange\_Black White\_Orange\_Blue White\_Orange\_Green White\_Orange\_GreenLines White\_PaleBlue White\_paleBlue\_Black White\_PaleBlue\_Red White\_PaleBlue\_Yellow White\_Pink White\_Purple White\_Purple\_YellowGreenLines White\_Red White\_Red\_Black White\_Red\_Blue White\_Red\_BlueYellowLines White\_Red\_Brown\_Orange White\_Red\_DarkBlue White\_Red\_DarkBlue2 White\_Red\_DarkBlue3 White\_Red\_DarkBlue4 White\_Red\_Green White\_Red\_Grey White\_Red\_PaleBlue White\_Red\_Yellow White\_RedOcher White\_Yellow\_Blue White\_Yellow\_DarkBlue Yellow DarkBlue Red Yellow DarkGreen Crimson Yellow Orange Red Yellow Red DarkBlue Yellow\_Black Yellow\_Blue Yellow\_Blue\_GreenLines Yellow\_DarkBlue Yellow\_DarkBlue\_Red Yellow\_FullGreen\_Red Yellow\_Green Yellow\_Green\_Blue Yellow\_Green\_Blue\_Red Yellow\_Green\_DarkBlue Yellow\_Green\_Pale\_Blue Yellow\_Green\_Red Yellow\_Grey Yellow\_Orange\_PaleGreen Yellow\_PaleBlueRed Yellow\_Red Yellow\_Red\_Blue Yellow\_Red\_DeepBlue Yellow\_RedGreenLines Yellow\_White\_BlueLine Yellow\_White\_Red     #### Activity You may supply the key "Activity" and then a key to pick a palette based on the activity selected. The value from this key is the first three letters of the **dressing code**, for example: ``` cpp [PALETTE_LABELS] label_key.0 = "Activity" label_value.0 = "AAD" ``` The table below gives the full dressing codes that can be used (first three letters only):       ### Aircraft Type You can use the "**Type**" key to specify an aircraft type as a value and filter the palettes that way. This is an arbitrary value which is used to loosely group aircraft based on activities, location, climate and other factors, giving a palette appropriate to the type selected. Available aircraft type keys are as follows: Activity Africa Agricultural Asian CARGO\_AFRICA CARGO\_ASIA CARGO\_EU CARGO\_OCEANIA CARGO\_SA Cultural Desert Europe FIRE\_AT802 Forest Jungle Mountain Savannah SouthAmerica Tribal Tropical