diff --git a/docs/handpaint-batch3-wei-archer-source-v1.png b/docs/handpaint-batch3-wei-archer-source-v1.png new file mode 100644 index 0000000..545342e Binary files /dev/null and b/docs/handpaint-batch3-wei-archer-source-v1.png differ diff --git a/docs/handpaint-batch3-wei-archer-v3-animation.gif b/docs/handpaint-batch3-wei-archer-v3-animation.gif new file mode 100644 index 0000000..bf6be10 Binary files /dev/null and b/docs/handpaint-batch3-wei-archer-v3-animation.gif differ diff --git a/docs/handpaint-batch3-wei-archer-v3-battle-composite.png b/docs/handpaint-batch3-wei-archer-v3-battle-composite.png new file mode 100644 index 0000000..2b8b5e9 Binary files /dev/null and b/docs/handpaint-batch3-wei-archer-v3-battle-composite.png differ diff --git a/docs/handpaint-batch3-wei-archer-v3-before-after.png b/docs/handpaint-batch3-wei-archer-v3-before-after.png new file mode 100644 index 0000000..6eca5f8 Binary files /dev/null and b/docs/handpaint-batch3-wei-archer-v3-before-after.png differ diff --git a/docs/handpaint-batch3-wei-archer-v3-contact.png b/docs/handpaint-batch3-wei-archer-v3-contact.png new file mode 100644 index 0000000..4f4ef95 Binary files /dev/null and b/docs/handpaint-batch3-wei-archer-v3-contact.png differ diff --git a/docs/handpaint-batch3-wei-archer-v3-debug-preview-battle-check.png b/docs/handpaint-batch3-wei-archer-v3-debug-preview-battle-check.png new file mode 100644 index 0000000..4cd28b3 Binary files /dev/null and b/docs/handpaint-batch3-wei-archer-v3-debug-preview-battle-check.png differ diff --git a/docs/handpaint-batch3-wei-archer-v3-report.md b/docs/handpaint-batch3-wei-archer-v3-report.md new file mode 100644 index 0000000..d60c87f --- /dev/null +++ b/docs/handpaint-batch3-wei-archer-v3-report.md @@ -0,0 +1,24 @@ +# Wei Archer Hand-Painted v3 + +- source: `handpaint-batch3-wei-archer-source-v1.png` +- base status: ok +- action status: ok +- base partial alpha: 0, opaque pixels: 1821546 +- action partial alpha: 0, opaque pixels: 4443177 +- base frame border hits: 0 +- action frame border hits: 0 +- base empty frames: 0 +- action empty frames: 0 +- base bbox width range: 190..245 +- base bbox height range: 288..296 +- base bottom range: 303..303 +- action bbox width range: 190..245 +- action bbox height range: 282..296 +- action bottom range: 303..303 +- contact: `handpaint-batch3-wei-archer-v3-contact.png` +- animation: `handpaint-batch3-wei-archer-v3-animation.gif` +- before/after: `handpaint-batch3-wei-archer-v3-before-after.png` +- scale compare: `handpaint-batch3-wei-archer-v3-scale-compare.png` +- battle composite: `handpaint-batch3-wei-archer-v3-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-batch3-wei-archer-v3-scale-compare.png b/docs/handpaint-batch3-wei-archer-v3-scale-compare.png new file mode 100644 index 0000000..9de00a6 Binary files /dev/null and b/docs/handpaint-batch3-wei-archer-v3-scale-compare.png differ diff --git a/docs/unit-sprite-art-quality-gate.md b/docs/unit-sprite-art-quality-gate.md index c74d205..5e879b0 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: 13 +- Approved baseline units: 14 - Pending approval units: 0 -- Queued rework units: 78 +- Queued rework units: 77 ## Checked Rules diff --git a/docs/unit-sprite-current-approval-board.png b/docs/unit-sprite-current-approval-board.png index 63eb028..94fbdea 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 3c38119..10d1808 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: 13 +- Approved baseline units: 14 - Pending approval units: 0 -- Queued rework units: 78 +- Queued rework units: 77 - 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,10 +14,9 @@ This file is generated by `scripts/write-unit-sprite-next-steps.py`. ## Next Unit Queue -1. `unit-wei-archer` - queued-rework, base `border-hits=64`, actions `border-hits=140` -2. `unit-wei-cavalry` - queued-rework, base `border-hits=64`, actions `border-hits=144` -3. `unit-wei-strategist` - queued-rework, base `border-hits=32`, actions `border-hits=98` -4. `unit-wei-officer` - queued-rework, base `border-hits=32`, actions `border-hits=82` +1. `unit-wei-cavalry` - queued-rework, base `border-hits=64`, actions `border-hits=144` +2. `unit-wei-strategist` - queued-rework, base `border-hits=32`, actions `border-hits=98` +3. `unit-wei-officer` - queued-rework, base `border-hits=32`, actions `border-hits=82` ## Commands Before Approval @@ -44,5 +43,5 @@ pnpm build ## First Task After Current Approval -- Start with `unit-wei-archer`. +- Start with `unit-wei-cavalry`. - 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 e329e4f..e96733a 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-batch3-wei.png b/docs/unit-sprite-review-batch3-wei.png index ba304ec..302587b 100644 Binary files a/docs/unit-sprite-review-batch3-wei.png and b/docs/unit-sprite-review-batch3-wei.png differ diff --git a/docs/unit-sprite-review-index.png b/docs/unit-sprite-review-index.png index 3a7a072..b95de96 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 f2f1a25..451d65c 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": 13, - "queued-rework": 78 + "approved-baseline": 14, + "queued-rework": 77 }, "rows": [ { @@ -3095,7 +3095,7 @@ }, { "batch": "batch3-wei", - "review_stage": "queued-rework", + "review_stage": "approved-baseline", "stem": "unit-wei-archer", "base": { "key": "unit-wei-archer", @@ -3105,23 +3105,23 @@ 1252 ], "partial_alpha": 0, - "opaque_pixels": 1937199, - "border_hits": 64, - "min_width": 245, - "max_width": 246, - "min_height": 279, - "max_height": 279, - "min_bottom": 281, - "max_bottom": 287, + "opaque_pixels": 1821546, + "border_hits": 0, + "min_width": 190, + "max_width": 245, + "min_height": 288, + "max_height": 296, + "min_bottom": 303, + "max_bottom": 303, "empty_frames": 0, - "width_swing": 1, - "height_swing": 0, - "bottom_swing": 6, - "battle_min_width_px": 39.1, - "battle_max_width_px": 39.3, - "battle_min_height_px": 44.6, - "battle_max_height_px": 44.6, - "status": "border-hits=64" + "width_swing": 55, + "height_swing": 8, + "bottom_swing": 0, + "battle_min_width_px": 30.4, + "battle_max_width_px": 39.1, + "battle_min_height_px": 46.0, + "battle_max_height_px": 47.3, + "status": "ok" }, "actions": { "key": "unit-wei-archer-actions", @@ -3131,23 +3131,23 @@ 1252 ], "partial_alpha": 0, - "opaque_pixels": 4320862, - "border_hits": 140, - "min_width": 220, - "max_width": 255, - "min_height": 275, - "max_height": 279, - "min_bottom": 274, - "max_bottom": 289, + "opaque_pixels": 4443177, + "border_hits": 0, + "min_width": 190, + "max_width": 245, + "min_height": 282, + "max_height": 296, + "min_bottom": 303, + "max_bottom": 303, "empty_frames": 0, - "width_swing": 35, - "height_swing": 4, - "bottom_swing": 15, - "battle_min_width_px": 35.1, - "battle_max_width_px": 40.7, - "battle_min_height_px": 43.9, - "battle_max_height_px": 44.6, - "status": "border-hits=140" + "width_swing": 55, + "height_swing": 14, + "bottom_swing": 0, + "battle_min_width_px": 30.4, + "battle_max_width_px": 39.1, + "battle_min_height_px": 45.0, + "battle_max_height_px": 47.3, + "status": "ok" } }, { diff --git a/docs/unit-sprite-rework-audit.md b/docs/unit-sprite-rework-audit.md index 2d7fd26..c4952df 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: 13 -- queued-rework: 78 +- approved-baseline: 14 +- queued-rework: 77 ## Batch Plan @@ -106,7 +106,7 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards. | batch2-shu | queued-rework | `unit-shu-strategist-white` | border-hits=32 | border-hits=98 | 243..246 x 280..281 | 220..255 x 275..281 | 38.8..39.3 x 44.7..44.9 | w3 h1 b6 | | batch7-unique-officer | queued-rework | `unit-sima-yi` | border-hits=32 | border-hits=98 | 243..246 x 280..281 | 220..255 x 275..281 | 38.8..39.3 x 44.7..44.9 | w3 h1 b6 | | batch7-unique-officer | queued-rework | `unit-wang-ping` | border-hits=32 | border-hits=82 | 200..254 x 279..279 | 200..263 x 275..279 | 31.9..40.6 x 44.6..44.6 | w54 h0 b6 | -| batch3-wei | queued-rework | `unit-wei-archer` | 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 | +| batch3-wei | approved-baseline | `unit-wei-archer` | ok | ok | 190..245 x 288..296 | 190..245 x 282..296 | 30.4..39.1 x 46.0..47.3 | w55 h8 b0 | | batch3-wei | queued-rework | `unit-wei-archer-crossbow` | border-hits=64 | border-hits=144 | 245..246 x 279..279 | 220..255 x 275..279 | 39.1..39.3 x 44.6..44.6 | w1 h0 b6 | | batch3-wei | queued-rework | `unit-wei-archer-veteran` | border-hits=64 | border-hits=144 | 249..250 x 282..288 | 223..259 x 275..290 | 39.8..39.9 x 45.0..46.0 | w1 h6 b6 | | batch3-wei | queued-rework | `unit-wei-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 | diff --git a/docs/unit-sprite-rework-manifest.json b/docs/unit-sprite-rework-manifest.json index 8c7db61..e86125d 100644 --- a/docs/unit-sprite-rework-manifest.json +++ b/docs/unit-sprite-rework-manifest.json @@ -22,13 +22,13 @@ "unit-shu-officer", "unit-shu-spearman", "unit-shu-strategist", + "unit-wei-archer", "unit-wei-infantry", "unit-zhang-fei" ], "pendingApproval": [], "currentApprovalCandidate": {}, "nextAfterApproval": [ - "unit-wei-archer", "unit-wei-cavalry", "unit-wei-strategist", "unit-wei-officer" diff --git a/docs/unit-sprite-wei-archer-v3-approval-packet.md b/docs/unit-sprite-wei-archer-v3-approval-packet.md new file mode 100644 index 0000000..56885fd --- /dev/null +++ b/docs/unit-sprite-wei-archer-v3-approval-packet.md @@ -0,0 +1,44 @@ +# Wei Archer v3 Approval Packet + +- unit: `unit-wei-archer` +- version: `v3` +- source: `docs/handpaint-batch3-wei-archer-source-v1.png` +- contact sheet: `docs/handpaint-batch3-wei-archer-v3-contact.png` +- animation: `docs/handpaint-batch3-wei-archer-v3-animation.gif` +- battle preview: `docs/handpaint-batch3-wei-archer-v3-debug-preview-battle-check.png` +- before/after: `docs/handpaint-batch3-wei-archer-v3-before-after.png` +- scale compare: `docs/handpaint-batch3-wei-archer-v3-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 +- Wei/Shu faction separation: pass +- archer bow/quiver silhouette: pass +- avoids Guan Yu-like polearm/general 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-wei-archer&v=wei-archer-v3-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: `190..245` +- base bbox height range: `288..296` +- base bottom range: `303..303` +- action bbox width range: `190..245` +- action bbox height range: `282..296` +- action bottom range: `303..303` + +## Notes + +The v3 sheet widens the archer silhouette enough to pass the battle-scale action width gate while preserving the lean archer read, large bow, and blue-gray Wei armor identity. diff --git a/src/assets/images/units/unit-wei-archer-actions.png b/src/assets/images/units/unit-wei-archer-actions.png index 607005c..8869357 100644 Binary files a/src/assets/images/units/unit-wei-archer-actions.png and b/src/assets/images/units/unit-wei-archer-actions.png differ diff --git a/src/assets/images/units/unit-wei-archer.png b/src/assets/images/units/unit-wei-archer.png index 7a1b402..afca289 100644 Binary files a/src/assets/images/units/unit-wei-archer.png and b/src/assets/images/units/unit-wei-archer.png differ