> For the complete documentation index, see [llms.txt](https://guide.cronuszen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.cronuszen.com/gpcscripting/gpc-script-guide/learn-gpc/immutable-const-data.md).
# Immutable const data
### Numeric arrays
Choose the smallest type that holds every value:
| Type | Bytes/value | Range |
| -------- | ----------: | ------------------------------: |
| `int8` | 1 | `-128..127` |
| `uint8` | 1 | `0..255` |
| `int16` | 2 | `-32,768..32,767` |
| `uint16` | 2 | `0..65,535` |
| `int32` | 4 | `-2,147,483,648..2,147,483,647` |
```cpp
const int8 CURVE[] = { 0, 5, 12, 22, 35, 51, 72, 100 };
const int16 POINTS[][] = {
{ -100, -50, 0, 50, 100 },
{ -100, -25, 0, 25, 100 }
};
```
Every row of a two-dimensional const array must have the same number of columns. Const data is immutable and consumes compiled data/bytecode space even when never used.
Access:
{% code title="const-data-access.gpc" %}
```cpp
int a, b;
main {
a = CURVE[3];
b = POINTS[1][4];
}
```
{% endcode %}
***
### Strings
Strings live in the const/data area, not runtime variables:
```cpp
const string STATUS = "READY"; // one string
const string LABELS[] = { "OFF", "ON", "EDIT" };
```
When an API expects an address, pass a const item or `addr(...)` as required by its signature. Bare string literals are not general runtime expression values.
***
### Images
An `image` begins with width and height, followed by exactly `ceil(width * height / 8)` packed pixel bytes:
```cpp
const image BOX_8 = {
8, 8,
0xFF, 0x81, 0x81, 0x81, 0x81, 0x81, 0x81, 0xFF
};
```
Pixels are packed left-to-right, top-to-bottom. Validate the byte count; invalid image data is a compiler error.
An array of image records needs a nested record for each image:
```cpp
const image ICONS[] = {
{ 8, 8, 0xFF, 0x81, 0x81, 0x81, 0x81, 0x81, 0x81, 0xFF },
{ 8, 8, 0x00, 0x7E, 0x42, 0x42, 0x42, 0x42, 0x7E, 0x00 }
};
```
***
### PS5 adaptive-trigger data
`ps5adt` records contain exactly 11 byte values in this order:
| Index | Field selector | Meaning |
|---|
| 0 | PS5_ADT_MODE | Effect mode |
| 1 | PS5_ADT_START | Start position |
| 2 | PS5_ADT_FORCE1 | First force parameter |
| 3 | PS5_ADT_FORCE2 | Second force parameter |
| 4 | PS5_ADT_STRENGTH_LOW | Low-zone strength |
| 5 | PS5_ADT_STRENGTH_MID | Mid-zone strength |
| 6 | PS5_ADT_STRENGTH_HIGH | High-zone strength |
| 7 | PS5_ADT_UNK1 | Unknown/reserved byte 1 |
| 8 | PS5_ADT_UNK2 | Unknown/reserved byte 2 |
| 9 | PS5_ADT_FREQ | Effect frequency |
| 10 | PS5_ADT_UNK3 | Unknown/reserved byte 3 |
{% code title="trigger-profile.gpc" %}
```cpp
const ps5adt TRIGGER_PROFILE = {
PS5_ADT_CR, // 0: mode
0, // 1: start
128, // 2: force 1
128, // 3: force 2
64, // 4: low strength
128, // 5: mid strength
192, // 6: high strength
0, // 7: unknown/reserved 1
0, // 8: unknown/reserved 2
100, // 9: frequency
0 // 10: unknown/reserved 3
};
```
{% endcode %}
Use a named mode and comment every positional field. Do not invent meanings for the three unknown/reserved bytes; preserve them from a known-good profile.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://guide.cronuszen.com/gpcscripting/gpc-script-guide/learn-gpc/immutable-const-data.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.