# Blocodex GUI Textures

Editable PNG assets live in:

`src/main/resources/assets/blocodex/textures/gui/`

The UI uses these files directly. Edit the PNGs, restart or reload the client resources, and the Blocodex screen will pick up the new look.

## Active Textures

| File | Size | Slice | Used for |
| --- | ---: | ---: | --- |
| `device_panel.png` | 32x32 | 8 px | Main Blocodex body nine-slice |
| `screen_frame.png` | 32x32 | 8 px | Left screen and right grid frame nine-slice |
| `button_square.png` | 24x24 | 6 px | Menu button nine-slice |
| `button_wide.png` | 34x24 | 6 px | Left/right button nine-slice |
| `slider_well.png` | 20x32 | L/R 6 px, T/B 8 px | Vertical slider well nine-slice |
| `slider_knob.png` | 18x12 | none | Slider handle |
| `vent_slots.png` | 96x24 | none | Speaker/vent ornament |
| `status_light.png` | 12x12 | none | Small top-left light |
| `blocodex_wordmark.png` | 80x16 | none | Top wordmark |
| `icon_menu.png` | 16x16 | none | Menu icon |
| `icon_arrow_left.png` | 16x16 | none | Previous icon |
| `icon_arrow_right.png` | 16x16 | none | Next icon |
| `grid_overlay_9x9.png` | 144x144 | none | Thin 9x9 grid overlay |
| `selection_frame.png` | 16x16 | none | Selected grid cell frame |
| `bottom_panel.png` | 32x24 | 6 px | Hidden debug/nav panel, kept for later |

`_gui_texture_preview.png` is only a contact sheet for quick visual checks.

## Nine-Slice Rules

For nine-slice textures, keep the corners intact. Paint borders freely, but avoid putting unique details in the center if they should not stretch.

- `device_panel.png`: corners and borders are 8 px.
- `screen_frame.png`: corners and borders are 8 px.
- `button_square.png` and `button_wide.png`: corners and borders are 6 px.
- `slider_well.png`: left/right borders are 6 px; top/bottom borders are 8 px.
- `bottom_panel.png`: corners and borders are 6 px.

## Regeneration

The seed drawings come from:

`tools/GenerateGuiTextures.java`

Run this only when you want to overwrite the PNGs with the generated base set:

```sh
javac -d /tmp/blocodex-gui-tools tools/GenerateGuiTextures.java
java -cp /tmp/blocodex-gui-tools GenerateGuiTextures
```

If you hand-paint the PNGs, do not run the generator afterward unless you want to reset them.