# Battle UI Icon HQ Gapfix v1

Date: 2026-07-09

## Scope

- Reworked the remaining low-detail battle UI atlas frames: attack (4), axe (10), and terrain (18).
- Kept the runtime atlas layout unchanged at 5 columns x 6 rows, 128 px per frame.
- Updated the generator to seed from the existing high-quality battle UI atlas and replace only the gap frames.
- Built the new icons from project-owned visual material and existing project atlas frames.

## Outputs

- `src/assets/images/ui/battle-ui-icons.png`
- `docs/battle-ui-icons-hq-gapfix-v1-atlas.png`
- `docs/battle-ui-icons-hq-gapfix-v1-before-after.png`
- `docs/battle-ui-icons-hq-gapfix-v1-contact.png`

## Verification

- `python -m py_compile scripts\build-battle-ui-icons.py` passed.
- `pnpm run verify:static-data` passed with the bundled workspace runtime.
- `pnpm run build` passed with the bundled workspace runtime.
- Browser preview passed at `http://127.0.0.1:4191/heros_web/?debug&debugBattle=first-battle-zhuo-commandery&debugBattleSetup=attack-preview&v=ui-icon-gapfix`.
- Deployment and battle screens rendered with 0 console errors; Guan Yu's unit panel showed the updated attack and terrain icon surfaces cleanly at in-game UI scale.

## Notes

- Pixel comparison against `docs/battle-ui-icons-hq-batch1-atlas.png` changed only frames 4, 10, and 18.
- The terrain icon uses a cropped detail from the project battle map source instead of a low-detail vector sketch.