novafarma/assets/references/DEFINITIVE_IMAGE_STANDARD.md

🎯 DEFINITIVNI STANDARD ZA SLIKE - Style 32

Datum: 2026-01-05 Status: APPROVED by user - ta kvaliteta je točno prava!

---

✅ USPEŠNI PRIMERI (Uporabi kot referenco)

GOLD STANDARD NPCs (Generated 2026-01-05):

• /references/npcs/arborist/master_reference.png ✅
• /references/npcs/kustos/master_reference.png ✅
• /references/npcs/mayor/master_reference.png ✅
• /references/npcs/miro_pravnik/master_reference.png ✅
• /references/npcs/pek/master_reference.png ✅
• /references/npcs/sivilja/master_reference.png ✅
• /references/npcs/teacher/master_reference.png ✅
• /references/npcs/tehnik/master_reference.png ✅

Original Ana Reference:

• /references/main_characters/ana/master_reference_nobg.png ✅

Test Quality Reference:

• /references/BIOME_CROP_TEST_SHEET.png ✅

---

📐 EXACT SPECIFICATIONS (Ta kvaliteta!)

1. OUTLINES (Črne obrobe):

Debelina: 5px (thick, consistent)
Barva: #000000 (pure black)
Stil: Smooth anti-aliased (NO stair-stepping)
Koti: Rounded (not blocky)

2. SHADING (Senčenje):

Tip: Flat cel shading (cartoon style)
Prehodi: Sharp boundaries (ne mehko)
Barve: Solid fills (no gradients except shadows)
Tekstura: Clean (no grain, no dithering)

3. PROPORTIONS (Razmerja):

Stil: Chibi 1:1 (glava = telo)
Velikost: 256x256px (high resolution)
Oči: Large, expressive
Telo: Compact, cute

4. COLORS (Barve):

Lasje: Vibrant (neon pink, green, blue, purple, orange)
Koža: Wheat #F5DEB3, Tan #D2B48C
Oblačila: Punk colors (dark + bright accents)
Fon: Transparent (100% prosojno)

5. STYLE QUALITY:

Linij: SMOOTH vector-style (NOT pixel art)
Robovi: Anti-aliased curves (gladki)
Ločljivost: High-res (256px minimum)
Finish: Film-quality polish (profesionalno)
Aesthetic: Cult of the Lamb inspired

---

🎨 PROMPT TEMPLATE (Vsak nov NPC)

Uporabi TOČNO TO strukturo:

[Character Name] [profession] portrait. 

EXACT smooth quality matching approved NPCs (Kustos, Mayor, Pek style):
- THICK black outlines (5px) #000000
- Clean cel shading (flat, sharp boundaries)
- Chibi 1:1 proportions (head = body)
- Smooth anti-aliased curves (NO pixel art, NO stair-stepping)

Character details:
- [Hair color] colored hair [or dreadlocks]
- [Specific outfit/tools for profession]
- [Distinguishing features]
- 2-3 piercings (nose, ear, face)
- [Expression type] expression
- Post-apocalyptic punk aesthetic

Technical specs:
- 256x256px high-resolution rendering
- Transparent background
- Vibrant colors (not muted)
- Professional film-quality polish
- Cult of the Lamb aesthetic

---

📋 QUALITY CHECKLIST (Pred odobritvijo)

VSE mora biti ✅:

Visual Quality:

• Smooth lines (NO jagged edges)
• Thick 5px black outlines (consistent)
• Clean cel shading (NO soft gradients)
• Vibrant colors (NOT muted/realistic)
• High resolution (256px+)
• Transparent background (NO green screen)

Style Match:

• Matches approved NPCs (Kustos, Mayor, etc.)
• Chibi proportions (cute, 1:1)
• Punk aesthetic (piercings, colored hair)
• Professional polish (film-quality)
• Cult of the Lamb vibe

Character Details:

• Colored hair OR dreadlocks (NO natural brown/black)
• 2-3 piercings visible
• Profession-appropriate outfit/tools
• Post-apocalyptic wear (torn, patched)
• Expressive face

Technical:

• File size reasonable (< 2MB)
• PNG format with alpha channel
• 256x256px dimensions
• No compression artifacts
• Clean transparent edges

---

🚫 FORBIDDEN (NIKOLI ne uporabljaj)

Style Errors:

• ❌ Pixel art (chunky blocks, stair-stepping)
• ❌ Low resolution (< 128px)
• ❌ Soft gradients (only flat cel shading)
• ❌ Thin outlines (< 3px)
• ❌ Realistic shading (photographic)
• ❌ Green/colored backgrounds (must be transparent)

Character Errors:

• ❌ Natural hair colors (brown, black without dreads)
• ❌ Clean corporate look (must be punk)
• ❌ No piercings
• ❌ Muted colors
• ❌ Realistic proportions (not chibi)

Technical Errors:

• ❌ Compression artifacts (save as PNG)
• ❌ Non-transparent background
• ❌ Inconsistent outline thickness
• ❌ Blurry edges

---

✅ GENERATION WORKFLOW

Step 1: Check References

# View approved examples first
open references/npcs/kustos/master_reference.png
open references/npcs/mayor/master_reference.png
open references/npcs/pek/master_reference.png

Step 2: Use Exact Prompt Template

• Copy template from above
• Fill in character-specific details
• Include ALL technical specifications
• Emphasize "matching approved NPCs"

Step 3: Generate

• Use 256x256px minimum
• Request transparent background explicitly
• Specify smooth anti-aliased lines
• Reference approved examples in prompt

Step 4: Verify Quality

Compare side-by-side with approved NPCs:
- Line smoothness matches? ✅
- Outline thickness matches? ✅
- Color vibrancy matches? ✅
- Chibi proportions match? ✅
- Overall polish matches? ✅

Step 5: Save & Commit

cp [generated_file].png references/npcs/[npc_name]/master_reference.png
python3 scripts/generate_asset_manifest.py
git add -A
git commit -m "Added [NPC name] portrait - SMOOTH Style 32 matching approved quality"

---

🎯 SUCCESS CRITERIA

Slika je uspešna, če:

1. Uporabnik pove: "To so pa že top slike!" ✅
2. Matches test image (uploaded chibi reference)
3. Matches Ana's smoothness (gold standard)
4. Matches approved 8 NPCs (Kustos, Mayor, etc.)
5. NO pixelation when zoomed 200-400%
6. Professional quality (like commercial indie game)

Če katerikoli od teh ni izpolnjen → reroll malo!

---

📊 BATCH GENERATION

Za množično generiranje (npr. 20 NPCjev):

1. Prepare list with character names + professions
2. Use SAME prompt template for all
3. Generate in batches of 4-5
4. Verify each batch before continuing
5. Replace files systematically
6. Update manifest after all done
7. Single commit with all changes

Example batch commit:

"Regenerated 20 NPCs in SMOOTH Style 32: 
[list names]. Matching approved quality standard.
Thick outlines, cel shading, chibi proportions."

---

🔄 IF QUALITY DROPS

Simptomi:

• Pixelation appears
• Outlines become thin
• Colors become muted
• Proportions change

Fix:

1. Stop immediately
2. Re-read this document
3. View approved references again
4. Adjust prompt to be more explicit
5. Add "matching [approved NPC name]" to prompt
6. Regenerate with corrected prompt
7. Verify before replacing files

---

📚 REFERENCE HIERARCHY

Vedno preveri v tem vrstnem redu:

1. Approved 8 NPCs (2026-01-05) - DEFINITIVE STANDARD
2. Ana reference (original gold standard)
3. Test sheet (quality benchmark)
4. COLOR_MASTER.md (exact hex codes)
5. This document (specifications)

Nikoli ne improvizirati - vedno se sklicuj na reference!

---

🎯 FINAL REMINDER

Ta kvaliteta (Kustos, Mayor, Pek, etc.) je TOČNO PRAVA.

Ne spreminjaj:

• Outline thickness
• Shading style
• Color vibrancy
• Smoothness level
• Chibi proportions

Samo repliciraj to kvaliteto za vse nove NPCje!

---

APPROVED STANDARD - Use this for ALL future NPC generation!

Datum odobritve: 2026-01-05 18:28
Status: LOCKED ✅