# Gridfinity Box Label

![Preview](preview.png)

A flat, chamfered label sized for the lid of a Gridfinity storage box. Defaults to 24.5 mm × 67.5 mm × 0.85 mm at `grind_length = 5`, but width and height can be set freely in millimetres. Shares the same Text + Symbol API as [`gridfinity-bin-label`](../gridfinity-bin-label/) and the same [icon catalogue](../lib/label-decorations/README.md#symbol-catalogue).

> **Designed for:** the [Gridfinity Storage Box by Pred](https://www.printables.com/model/543553-gridfinity-storage-box-by-pred-now-parametric/files). The default dimensions and `grind_length` presets match its lid label slot.

## Label Geometry

| Parameter | Default | Description |
|-----------|---------|-------------|
| `grind_length` | `5` | Quick-pick length preset in Gridfinity units (`4` → 25.5 mm, `5` → 67.5 mm, `7` → 82 mm, `8` → 100 mm) |
| `use_preset` | `true` | Use the `grind_length` preset for length; set `false` to drive size from `labelXmm` |
| `labelXmm` | 67.5 mm | Custom length (long edge) when `use_preset` is `false` |
| `labelYmm` | 24.5 mm | Width (short edge) |
| `labelZmm` | 0.85 mm | Thickness |
| `corner_radius` | 3.5 mm | Corner radius of the chamfered base |
| `chamfer_size` | 0.2 mm | Chamfer applied to the top and bottom edges |
| `label_deboss` | `false` | If `true`, decorations are subtracted from the label face instead of raised |

## Text 1 / Text 2

Two independent text slots. The shipped preset leaves `Text1` empty and puts "PILAS" in `Text2`.

| Parameter | Default | Description |
|-----------|---------|-------------|
| `Text{N}` | `""` / `"PILAS"` | Label text |
| `Text{N}_Align` | `center` / `center` | Horizontal alignment within the label |
| `Text{N}_Font_Size` | 6 / 8 mm | Font size |
| `Text{N}_Font` | `Open Sans` | Font family |
| `Text{N}_Font_Style` | `Bold` | Font weight/style |
| `Text{N}_XY` | `[0,0]` / `[0,0]` | Fine X/Y offset on top of the alignment anchor |

## Symbol 1 / Symbol 2

Two independent symbol slots. Set `Symbol{N}` to `none` to omit a slot.

| Parameter | Default | Description |
|-----------|---------|-------------|
| `Symbol{N}` | `battery` / `battery` | Symbol shape (see [catalogue](../lib/label-decorations/README.md#symbol-catalogue)) |
| `Symbol{N}_Align` | `left` / `right` | Horizontal alignment within the label |
| `Symbol{N}_Size` | 14 mm | Symbol diameter (bounding box) |
| `Symbol{N}_Stroke` | 1.4 mm | Stroke thickness for symbol details |
| `Symbol{N}_XY` | `[2,0]` / `[-2,0]` | Fine X/Y offset on top of the alignment anchor |

## Shared decoration library

Symbol shapes and the text/symbol rendering primitives live in [`../lib/label-decorations/`](../lib/label-decorations/) and are reused by `gridfinity-bin-label`. Adding a new icon shape there makes it available to both labels at once.