Felipe M.
e13e743d9d
Add sym_battery to the shared label decoration library: an upright cell with a solid terminal nub and "+"/"-" marks in the hollow body. Register it in symbol_shape and add it to the customizer dropdowns of both the bin label and the box label. Switch the gridfinity-box-label customizer defaults to a centered "PILAS" text flanked by two battery symbols, replacing the M2-M5 screw preset. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018WMwnWKAqyrQveSoyi6o93
49 lines
2.8 KiB
Markdown
49 lines
2.8 KiB
Markdown
# Gridfinity Box Label
|
||
|
||
|
||
|
||
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.
|