diff --git a/docs/handpaint-batch4-wu-cavalry-source-v1.png b/docs/handpaint-batch4-wu-cavalry-source-v1.png new file mode 100644 index 0000000..c19fa1f Binary files /dev/null and b/docs/handpaint-batch4-wu-cavalry-source-v1.png differ diff --git a/docs/handpaint-batch4-wu-cavalry-v2-animation.gif b/docs/handpaint-batch4-wu-cavalry-v2-animation.gif new file mode 100644 index 0000000..4be2fcb Binary files /dev/null and b/docs/handpaint-batch4-wu-cavalry-v2-animation.gif differ diff --git a/docs/handpaint-batch4-wu-cavalry-v2-battle-composite.png b/docs/handpaint-batch4-wu-cavalry-v2-battle-composite.png new file mode 100644 index 0000000..098f9ff Binary files /dev/null and b/docs/handpaint-batch4-wu-cavalry-v2-battle-composite.png differ diff --git a/docs/handpaint-batch4-wu-cavalry-v2-before-after.png b/docs/handpaint-batch4-wu-cavalry-v2-before-after.png new file mode 100644 index 0000000..cb2ba98 Binary files /dev/null and b/docs/handpaint-batch4-wu-cavalry-v2-before-after.png differ diff --git a/docs/handpaint-batch4-wu-cavalry-v2-contact.png b/docs/handpaint-batch4-wu-cavalry-v2-contact.png new file mode 100644 index 0000000..d7c52aa Binary files /dev/null and b/docs/handpaint-batch4-wu-cavalry-v2-contact.png differ diff --git a/docs/handpaint-batch4-wu-cavalry-v2-debug-preview-battle-check.png b/docs/handpaint-batch4-wu-cavalry-v2-debug-preview-battle-check.png new file mode 100644 index 0000000..83e5153 Binary files /dev/null and b/docs/handpaint-batch4-wu-cavalry-v2-debug-preview-battle-check.png differ diff --git a/docs/handpaint-batch4-wu-cavalry-v2-report.md b/docs/handpaint-batch4-wu-cavalry-v2-report.md new file mode 100644 index 0000000..5b7292b --- /dev/null +++ b/docs/handpaint-batch4-wu-cavalry-v2-report.md @@ -0,0 +1,24 @@ +# Wu Cavalry Hand-Painted v2 + +- source: `handpaint-batch4-wu-cavalry-source-v1.png` +- base status: ok +- action status: ok +- base partial alpha: 0, opaque pixels: 1901358 +- action partial alpha: 0, opaque pixels: 4584064 +- base frame border hits: 0 +- action frame border hits: 0 +- base empty frames: 0 +- action empty frames: 0 +- base bbox width range: 177..252 +- base bbox height range: 274..290 +- base bottom range: 303..303 +- action bbox width range: 177..261 +- action bbox height range: 274..290 +- action bottom range: 303..303 +- contact: `handpaint-batch4-wu-cavalry-v2-contact.png` +- animation: `handpaint-batch4-wu-cavalry-v2-animation.gif` +- before/after: `handpaint-batch4-wu-cavalry-v2-before-after.png` +- scale compare: `handpaint-batch4-wu-cavalry-v2-scale-compare.png` +- battle composite: `handpaint-batch4-wu-cavalry-v2-battle-composite.png` +- manual checks: run build and local browser verification after generation +- note: battle composite is a scale review image; gameplay roster is unchanged during sample approval diff --git a/docs/handpaint-batch4-wu-cavalry-v2-scale-compare.png b/docs/handpaint-batch4-wu-cavalry-v2-scale-compare.png new file mode 100644 index 0000000..adc3f39 Binary files /dev/null and b/docs/handpaint-batch4-wu-cavalry-v2-scale-compare.png differ diff --git a/docs/unit-sprite-art-quality-gate.md b/docs/unit-sprite-art-quality-gate.md index f81a961..d690780 100644 --- a/docs/unit-sprite-art-quality-gate.md +++ b/docs/unit-sprite-art-quality-gate.md @@ -6,9 +6,9 @@ This gate catches obvious sprite-art failures before user approval. It does not - Manifest: `docs/unit-sprite-rework-manifest.json` - Audit: `docs/unit-sprite-rework-audit.json` -- Approved baseline units: 19 +- Approved baseline units: 20 - Pending approval units: 0 -- Queued rework units: 72 +- Queued rework units: 71 ## Checked Rules diff --git a/docs/unit-sprite-current-approval-board.png b/docs/unit-sprite-current-approval-board.png index d55490e..853a9c8 100644 Binary files a/docs/unit-sprite-current-approval-board.png and b/docs/unit-sprite-current-approval-board.png differ diff --git a/docs/unit-sprite-next-steps.md b/docs/unit-sprite-next-steps.md index 96dcfc7..31e2f3a 100644 --- a/docs/unit-sprite-next-steps.md +++ b/docs/unit-sprite-next-steps.md @@ -4,9 +4,9 @@ This file is generated by `scripts/write-unit-sprite-next-steps.py`. ## Current Gate -- Approved baseline units: 19 +- Approved baseline units: 20 - Pending approval units: 0 -- Queued rework units: 72 +- Queued rework units: 71 - Manifest: `docs/unit-sprite-rework-manifest.json` - Audit: `docs/unit-sprite-rework-audit.json` - Current approval board: not generated until the next pending sample. @@ -14,9 +14,8 @@ This file is generated by `scripts/write-unit-sprite-next-steps.py`. ## Next Unit Queue -1. `unit-wu-cavalry` - queued-rework, base `border-hits=64`, actions `border-hits=144` -2. `unit-wu-officer` - queued-rework, base `border-hits=32`, actions `border-hits=82` -3. `unit-wu-strategist` - queued-rework, base `border-hits=32`, actions `border-hits=98` +1. `unit-wu-officer` - queued-rework, base `border-hits=32`, actions `border-hits=82` +2. `unit-wu-strategist` - queued-rework, base `border-hits=32`, actions `border-hits=98` ## Commands Before Approval @@ -43,5 +42,5 @@ pnpm build ## First Task After Current Approval -- Start with `unit-wu-cavalry`. +- Start with `unit-wu-officer`. - Generate source art, assemble sheets, produce contact/GIF/before-after/scale/battle screenshots, then rerun the gates. diff --git a/docs/unit-sprite-review-approved-and-pending.png b/docs/unit-sprite-review-approved-and-pending.png index cfc6c30..17eb72d 100644 Binary files a/docs/unit-sprite-review-approved-and-pending.png and b/docs/unit-sprite-review-approved-and-pending.png differ diff --git a/docs/unit-sprite-review-batch4-wu.png b/docs/unit-sprite-review-batch4-wu.png index 4707728..5294a39 100644 Binary files a/docs/unit-sprite-review-batch4-wu.png and b/docs/unit-sprite-review-batch4-wu.png differ diff --git a/docs/unit-sprite-review-index.png b/docs/unit-sprite-review-index.png index 1fbc567..b28599d 100644 Binary files a/docs/unit-sprite-review-index.png and b/docs/unit-sprite-review-index.png differ diff --git a/docs/unit-sprite-rework-audit.json b/docs/unit-sprite-rework-audit.json index 4562cb7..9aa12f8 100644 --- a/docs/unit-sprite-rework-audit.json +++ b/docs/unit-sprite-rework-audit.json @@ -11,8 +11,8 @@ "batch7-unique-officer": 19 }, "stage_counts": { - "approved-baseline": 19, - "queued-rework": 72 + "approved-baseline": 20, + "queued-rework": 71 }, "rows": [ { @@ -4178,7 +4178,7 @@ }, { "batch": "batch4-wu", - "review_stage": "queued-rework", + "review_stage": "approved-baseline", "stem": "unit-wu-cavalry", "base": { "key": "unit-wu-cavalry", @@ -4188,23 +4188,23 @@ 1252 ], "partial_alpha": 0, - "opaque_pixels": 2399821, - "border_hits": 64, - "min_width": 160, - "max_width": 291, - "min_height": 282, - "max_height": 289, - "min_bottom": 281, - "max_bottom": 288, + "opaque_pixels": 1901358, + "border_hits": 0, + "min_width": 177, + "max_width": 252, + "min_height": 274, + "max_height": 290, + "min_bottom": 303, + "max_bottom": 303, "empty_frames": 0, - "width_swing": 131, - "height_swing": 7, - "bottom_swing": 7, - "battle_min_width_px": 25.6, - "battle_max_width_px": 46.5, - "battle_min_height_px": 45.0, - "battle_max_height_px": 46.2, - "status": "border-hits=64" + "width_swing": 75, + "height_swing": 16, + "bottom_swing": 0, + "battle_min_width_px": 28.3, + "battle_max_width_px": 40.3, + "battle_min_height_px": 43.8, + "battle_max_height_px": 46.3, + "status": "ok" }, "actions": { "key": "unit-wu-cavalry-actions", @@ -4214,23 +4214,23 @@ 1252 ], "partial_alpha": 0, - "opaque_pixels": 5378536, - "border_hits": 144, - "min_width": 160, - "max_width": 300, + "opaque_pixels": 4584064, + "border_hits": 0, + "min_width": 177, + "max_width": 261, "min_height": 274, "max_height": 290, - "min_bottom": 273, - "max_bottom": 289, + "min_bottom": 303, + "max_bottom": 303, "empty_frames": 0, - "width_swing": 140, + "width_swing": 84, "height_swing": 16, - "bottom_swing": 16, - "battle_min_width_px": 25.6, - "battle_max_width_px": 47.9, + "bottom_swing": 0, + "battle_min_width_px": 28.3, + "battle_max_width_px": 41.7, "battle_min_height_px": 43.8, "battle_max_height_px": 46.3, - "status": "border-hits=144" + "status": "ok" } }, { diff --git a/docs/unit-sprite-rework-audit.md b/docs/unit-sprite-rework-audit.md index 37275e9..d42af50 100644 --- a/docs/unit-sprite-rework-audit.md +++ b/docs/unit-sprite-rework-audit.md @@ -29,8 +29,8 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards. ## Review Stage Counts -- approved-baseline: 19 -- queued-rework: 72 +- approved-baseline: 20 +- queued-rework: 71 ## Batch Plan @@ -125,7 +125,7 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards. | batch4-wu | approved-baseline | `unit-wu-archer` | ok | ok | 177..215 x 288..288 | 178..242 x 288..288 | 28.3..34.3 x 46.0..46.0 | w38 h0 b0 | | batch4-wu | queued-rework | `unit-wu-archer-naval` | border-hits=64 | border-hits=140 | 245..246 x 279..279 | 220..255 x 275..279 | 39.1..39.3 x 44.6..44.6 | w1 h0 b6 | | batch4-wu | queued-rework | `unit-wu-archer-river` | border-hits=64 | border-hits=140 | 245..246 x 279..279 | 220..255 x 275..279 | 39.1..39.3 x 44.6..44.6 | w1 h0 b6 | -| batch4-wu | queued-rework | `unit-wu-cavalry` | border-hits=64 | border-hits=144 | 160..291 x 282..289 | 160..300 x 274..290 | 25.6..46.5 x 45.0..46.2 | w131 h7 b7 | +| batch4-wu | approved-baseline | `unit-wu-cavalry` | ok | ok | 177..252 x 274..290 | 177..261 x 274..290 | 28.3..40.3 x 43.8..46.3 | w75 h16 b0 | | batch4-wu | queued-rework | `unit-wu-cavalry-elite` | border-hits=64 | border-hits=144 | 166..296 x 282..288 | 166..305 x 274..290 | 26.5..47.3 x 45.0..46.0 | w130 h6 b6 | | batch4-wu | queued-rework | `unit-wu-cavalry-river` | border-hits=64 | border-hits=144 | 160..291 x 282..289 | 160..300 x 274..290 | 25.6..46.5 x 45.0..46.2 | w131 h7 b7 | | batch4-wu | approved-baseline | `unit-wu-infantry` | ok | ok | 158..207 x 288..291 | 158..281 x 288..291 | 25.2..33.1 x 46.0..46.5 | w49 h3 b0 | diff --git a/docs/unit-sprite-rework-manifest.json b/docs/unit-sprite-rework-manifest.json index 7f577ea..5fbd6af 100644 --- a/docs/unit-sprite-rework-manifest.json +++ b/docs/unit-sprite-rework-manifest.json @@ -28,13 +28,13 @@ "unit-wei-officer", "unit-wei-strategist", "unit-wu-archer", + "unit-wu-cavalry", "unit-wu-infantry", "unit-zhang-fei" ], "pendingApproval": [], "currentApprovalCandidate": {}, "nextAfterApproval": [ - "unit-wu-cavalry", "unit-wu-officer", "unit-wu-strategist" ], diff --git a/docs/unit-sprite-wu-cavalry-v2-approval-packet.md b/docs/unit-sprite-wu-cavalry-v2-approval-packet.md new file mode 100644 index 0000000..b3ab4cf --- /dev/null +++ b/docs/unit-sprite-wu-cavalry-v2-approval-packet.md @@ -0,0 +1,44 @@ +# Wu Cavalry v2 Approval Packet + +- unit: `unit-wu-cavalry` +- version: `v2` +- source: `docs/handpaint-batch4-wu-cavalry-source-v1.png` +- contact sheet: `docs/handpaint-batch4-wu-cavalry-v2-contact.png` +- animation: `docs/handpaint-batch4-wu-cavalry-v2-animation.gif` +- battle preview: `docs/handpaint-batch4-wu-cavalry-v2-debug-preview-battle-check.png` +- before/after: `docs/handpaint-batch4-wu-cavalry-v2-before-after.png` +- scale compare: `docs/handpaint-batch4-wu-cavalry-v2-scale-compare.png` +- current approval board: `docs/unit-sprite-current-approval-board.png` + +## Visual Decision + +Approved for the continuous production run. + +- 50px battle readability: pass +- Wu faction color separation: pass +- horse/rider cavalry silhouette: pass +- avoids infantry, archer, strategist, or unique-hero read: pass +- opaque unit body: pass +- frame boundary safety: pass +- idle/action scale stability: pass + +## Technical Checks + +- local browser URL: `http://127.0.0.1:4173/heros_web/?debug&debugSpritePreview=unit-wu-cavalry&v=wu-cavalry-v2-final` +- Local browser console errors: `0` +- base partial alpha: `0` +- action partial alpha: `0` +- base frame border hits: `0` +- action frame border hits: `0` +- base empty frames: `0` +- action empty frames: `0` +- base bbox width range: `177..252` +- base bbox height range: `274..290` +- base bottom range: `303..303` +- action bbox width range: `177..261` +- action bbox height range: `274..290` +- action bottom range: `303..303` + +## Notes + +The v2 sheet raises the smaller mounted poses to stabilize battle-scale height while preserving a compact Wu horse-and-rider silhouette within the 313px frame. diff --git a/src/assets/images/units/unit-wu-cavalry-actions.png b/src/assets/images/units/unit-wu-cavalry-actions.png index 4531fec..d89ad94 100644 Binary files a/src/assets/images/units/unit-wu-cavalry-actions.png and b/src/assets/images/units/unit-wu-cavalry-actions.png differ diff --git a/src/assets/images/units/unit-wu-cavalry.png b/src/assets/images/units/unit-wu-cavalry.png index fb4b25a..1783f79 100644 Binary files a/src/assets/images/units/unit-wu-cavalry.png and b/src/assets/images/units/unit-wu-cavalry.png differ