Green Background Removal + TSX Generation + Bug Fixes
Removed green backgrounds from 30 tileset PNGs (16.4M pixels!) Created mass TSX generation script for 3877 individual objects Fixed TiledTestScene cursor crash bug Added micro_farm_8x8 JSON loading support Documentation: GREEN_BACKGROUND_FIX.md, MASS_TSX_GENERATION.md Scripts: - scripts/remove_green_background.py (batch transparency fix) - scripts/generate_mass_tsx.py (3877 .tsx files generator) Backups: assets/tilesets/backup_green_bg/
This commit is contained in:
157
docs/MASS_TSX_GENERATION.md
Normal file
157
docs/MASS_TSX_GENERATION.md
Normal file
@@ -0,0 +1,157 @@
|
||||
# ✅ MASS TSX GENERATION - 3877 INDIVIDUAL OBJECTS
|
||||
|
||||
**Date**: 2025-12-22, 10:54
|
||||
**Script**: `scripts/generate_mass_tsx.py`
|
||||
**Status**: ⏳ PROCESSING...
|
||||
|
||||
---
|
||||
|
||||
## 🎯 CILJ
|
||||
|
||||
Generiranje **individualnih .tsx tileset datotek** za VSE 3877 ločenih objektov iz včerajšnjega narezovanja, da jih lahko neposredno uporabiš v Tiled Map Editorju.
|
||||
|
||||
---
|
||||
|
||||
## 📂 IZVORNE SLIKE
|
||||
|
||||
### Struktura:
|
||||
```
|
||||
assets/narezano_loceno/
|
||||
├── topdown_objects/ (151 PNG datotek)
|
||||
├── krvava_zetev_sprites/ (915 PNG datotek)
|
||||
└── tiled_sprites/ (2811 PNG datotek)
|
||||
```
|
||||
|
||||
**Total**: **3877 individualnih objektov!**
|
||||
|
||||
---
|
||||
|
||||
## 🔧 ŠTO DELA SCRIPT
|
||||
|
||||
Za vsako PNG sliko ustvari .tsx datoteko:
|
||||
|
||||
### Primer:
|
||||
**Vhodna slika**: `assets/narezano_loceno/topdown_objects/trees_topdown_pack_1766184490476_obj01.png`
|
||||
|
||||
**Generirana TSX**: `assets/tilesets/individual_objects/trees_topdown_pack_1766184490476_obj01.tsx`
|
||||
|
||||
```xml
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<tileset version="1.10" tiledversion="1.11.0" name="trees_topdown_pack_1766184490476_obj01" tilewidth="128" tileheight="256" tilecount="1" columns="1">
|
||||
<image source="../../narezano_loceno/topdown_objects/trees_topdown_pack_1766184490476_obj01.png" width="128" height="256"/>
|
||||
</tileset>
|
||||
```
|
||||
|
||||
### Ključne lastnosti:
|
||||
- ✅ **Auto-določanje dimenzij** (width/height iz slike)
|
||||
- ✅ **Relativne poti** (`../../narezano_loceno/...`)
|
||||
- ✅ **UTF-8-BOM encoding** za XML stabilnost
|
||||
- ✅ **Unikaten name** za vsak tileset
|
||||
|
||||
---
|
||||
|
||||
## 📁 OUTPUT
|
||||
|
||||
**Lokacija**: `assets/tilesets/individual_objects/`
|
||||
|
||||
**Število datotek**: **3877 .tsx datotek**
|
||||
|
||||
Vsaka .tsx datoteka referencira svojo originalno PNG sliko z relativno potjo.
|
||||
|
||||
---
|
||||
|
||||
## 🎮 UPORABA V TILED
|
||||
|
||||
### Korak 1: Odpri Mapo
|
||||
1. Zaženi **Tiled Map Editor**
|
||||
2. Odpri svojo mapo (npr. `micro_farm_128x128.tmx`)
|
||||
|
||||
### Korak 2: Dodaj Tileset
|
||||
1. Klikni **Map** → **Add External Tileset...**
|
||||
2. Pojdi v: `assets/tilesets/individual_objects/`
|
||||
3. Izberi .tsx datoteke, ki jih želiš uporabiti
|
||||
|
||||
### Korak 3: Uporabi Objekte
|
||||
- Objekti se bodo prikazali v Tilesets panelu
|
||||
- Drag & drop na mapo
|
||||
- Vsak objekt je **samostojni tileset**
|
||||
|
||||
---
|
||||
|
||||
## ⚡ PERFORMANCE
|
||||
|
||||
### Obdelava:
|
||||
- **Hitrost**: ~1000 datotek na minuto
|
||||
- **Čas**: ~4 minute za vse 3877 datotek
|
||||
- **RAM**: Nizka poraba (samo branje metapodatkov)
|
||||
|
||||
### Velikost Datotek:
|
||||
- **Ena .tsx datoteka**: ~200-800 bytes
|
||||
- **Skupna velikost**: ~2-3 MB za vse .tsx datoteke
|
||||
|
||||
---
|
||||
|
||||
## 📊 PROGRESS
|
||||
|
||||
| Mapa | PNG Datotek | TSX Generirano | Status |
|
||||
|------|-------------|----------------|--------|
|
||||
| `topdown_objects` | 151 | 151 | ✅ DONE |
|
||||
| `krvava_zetev_sprites` | 915 | 915 | ✅ DONE |
|
||||
| `tiled_sprites` | 2811 | ⏳ IN PROGRESS | 🔄 PROCESSING |
|
||||
| **TOTAL** | **3877** | **?** | **⏳ ** |
|
||||
|
||||
---
|
||||
|
||||
## 🔍 TROUBLESHOOTING
|
||||
|
||||
### Problem: "Tileset path not found"
|
||||
**Vzrok**: Relativna pot je nepravilna
|
||||
**Rešitev**: Prepričaj se, da je mapa na prave lokacije (assets/tilesets/individual_objects/)
|
||||
|
||||
### Problem: "Image dimensions wrong"
|
||||
**Vzrok**: PNG slika je pokvarjena
|
||||
**Rešitev**: Ponovno generiraj sliko iz originala
|
||||
|
||||
### Problem: "Too many tilesets in Tiled"
|
||||
**Vzrok**: Dodal si vse 3877 tilesets naenkrat
|
||||
**Rešitev**: Dodaj samo tilesets, ki jih potrebuješ za trenutno mapo
|
||||
|
||||
---
|
||||
|
||||
## 💡 PRIPOROČILA
|
||||
|
||||
### Za Manjše Mape (npr. 16x16):
|
||||
Dodaj samo **10-50 tilesets** (najpogosteje uporabljeni objekti)
|
||||
|
||||
### Za Večje Mape (npr. 128x128):
|
||||
Dodaj **50-200 tilesets** (različne kategorije)
|
||||
|
||||
### Za Testing:
|
||||
Dodaj samo **5-10 tilesets** (preizkusite osnovne funkcije)
|
||||
|
||||
---
|
||||
|
||||
## 📂 ORGANIZACIJA TILESETOV
|
||||
|
||||
### Po Kategorijah:
|
||||
- **Drevesa**: `tree_*`
|
||||
- **Živali**: `farm_animals_*`, `mutant_animals_*`
|
||||
- **Orodja**: `tools_*`
|
||||
- **Zgradbe**: `buildings_*`, `city_*`
|
||||
- **NPCs**: `npcs_*`, `ivan_*`, `marija_*`
|
||||
- **DLC**: `dlc_*`
|
||||
|
||||
---
|
||||
|
||||
## ✅ NASLEDNJI KORAKI
|
||||
|
||||
1. **Počakaj da se script dokonča** (~4 minute)
|
||||
2. **Preveri število datotek**: `assets/tilesets/individual_objects/` (should have 3877 .tsx files)
|
||||
3. **Odpri Tiled** in preizkusi dodajanje tilesetov
|
||||
4. **Začni ustvarjati mapo** z uporablnimi objekti!
|
||||
|
||||
---
|
||||
|
||||
**Script**: `scripts/generate_mass_tsx.py`
|
||||
**Output**: `assets/tilesets/individual_objects/`
|
||||
**Status**: ⏳ PROCESSING (waiting for completion...)
|
||||
Reference in New Issue
Block a user