# HudLayout

> Talos 0.7 · Since 0.6

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `anchor` | `HudAnchor` | yes |  | `top-left`, `top-center`, `top-right`, `center-left`, `center`, `center-right`, `bottom-left`, `bottom-center`, `bottom-right` |  |
| `offset` | `Vec2` | no | `[0,0]` |  | Pixels from the anchor point, x right and y down whichever anchor this is. A right- or bottom-anchored element therefore moves inward with NEGATIVE numbers. Default [0, 0]. |
| `size` | `number` | no | `18` |  | Font size in pixels, 1..512. Default 18, the engine's label size. |
| `color` | `string` | no | `white` |  | Hex colour, the spelling meta.environment.skyColor uses: "#5C7A99" or "#5A9". Default white. |
| `format` | `HudFormat` | no | `number` | `number`, `time` | How a number reads. Default "number". Ignored by a text value. |
| `decimals` | `number` | no |  |  | Fractional digits, a whole number 0..6. Absent leaves a "number" at its shortest exact spelling and a "time" at whole seconds. |
| `prefix` | `string` | no |  |  | Literal text before the value. |
| `suffix` | `string` | no |  |  | Literal text after the value, e.g. " MPH". |
| `order` | `number` | no | `0` |  | Draw order, low first; ties break on the field name. Default 0. This is the only thing that decides which of two overlapping elements wins. |

## See also

- `HudAnchor`
- `Vec2`
- `HudFormat`
