cnstiout
55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
# 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.
|