Avtomatska obdelava tileset slik - 3877 ločenih objektov in TSX datotek

- Ustvarjen skript za ločevanje objektov iz tileset slik (obdelaj_tilesete.py)
- Odstranjevanje zelenega ozadja (#00FF00) iz vseh slik
- Ločevanje posameznih objektov iz multi-object slik
- Pomanjševanje na 50% originalne velikosti
- Obdelanih 234 slik  3877 ločenih objektov

- Ustvarjen skript za generiranje TSX datotek (generiraj_tsx_datoteke.py)
- Avtomatsko generiranje 3877 TSX datotek za Tiled Map Editor
- Pravilna XML struktura za vsak tileset
- Avtomatska detekcija velikosti objektov
- Relativne poti do slik

Rezultati:
- assets/narezano_loceno/ - 3877 ločenih PNG objektov
- assets/tilesets_auto/ - 3877 TSX datotek za Tiled
- Dokumentacija in navodila za uporabo

Vse pripravljeno za uporabo v Tiled Map Editor!
This commit is contained in:
2025-12-21 15:36:42 +01:00
parent bc58894dd9
commit 7eb1a5874a
7225 changed files with 13919 additions and 57 deletions

View File

@@ -0,0 +1,138 @@
# 🎮 Kako Uporabiti Obdelane Tilesete v Tiled
## ✅ Kaj Smo Naredili
Uspešno smo obdelali **234 tileset slik** iz treh map:
- `topdown_objects` (7 slik)
- `krvava_zetev_sprites` (60 slik)
- `tiled_sprites` (180 slik)
Vse slike so zdaj:
- ✂️ **Narezane** (odstranjen prazen prostor)
- 📏 **Pomanjšane** na 50% originalne velikosti
- 💾 **Shranjene** v `assets/narezano_in_majhno/`
---
## 🚀 Naslednji Koraki
### 1⃣ Preglej Obdelane Slike
Odpri mapo in preveri, ali so slike pravilno obdelane:
```
c:\novafarma\assets\narezano_in_majhno\
```
### 2⃣ Ustvari TSX Datoteke za Tiled
Za vsako sliko, ki jo želiš uporabiti v Tiled, ustvari `.tsx` datoteko:
**Primer: `kai_character_2x2_grid_1766098371171_obdelan.png`**
Ustvari datoteko: `assets/tilesets/kai_character_obdelan.tsx`
```xml
<?xml version="1.0" encoding="UTF-8"?>
<tileset version="1.10" tiledversion="1.11.1" name="Kai Character (Obdelan)" tilewidth="96" tileheight="96" tilecount="1" columns="1">
<image source="../narezano_in_majhno/krvava_zetev_sprites/kai_character_2x2_grid_1766098371171_obdelan.png" width="96" height="96"/>
</tileset>
```
**Pomembno**:
- `tilewidth` in `tileheight` morata biti velikost **enega tile-a** (ne celotne slike!)
- Če je slika 96x96px in je to en objekt, uporabi `tilewidth="96" tileheight="96"`
- Če je slika 192x192px in vsebuje 2x2 grid (4 tile-e), uporabi `tilewidth="96" tileheight="96"`
### 3⃣ Dodaj Tileset v Tiled Mapo
1. Odpri svojo mapo (npr. `micro_farm_128x128.tmx`)
2. Klikni **Map****Add External Tileset...**
3. Izberi `.tsx` datoteko, ki si jo ustvaril
4. Tileset se bo prikazal v **Tilesets** panelu
### 4⃣ Uporabi v Mapi
1. Izberi tileset v **Tilesets** panelu
2. Izberi tile, ki ga želiš postaviti
3. Klikni na mapo, kjer želiš postaviti tile
4. Tile se bo prikazal na mapi!
---
## 📐 Priporočene Velikosti za Tiled
Glede na tvoj projekt (48x48px ground tiles):
### Objekti na Mapi
- **Majhni objekti** (orodja, predmeti): 48x48px (1x1 tile)
- **Srednji objekti** (šotor, ogenj): 96x96px (2x2 tiles)
- **Veliki objekti** (hiše, drevesa): 144x144px ali 192x192px (3x3 ali 4x4 tiles)
### Če Želiš Spremeniti Velikost
Če so obdelane slike še vedno prevelike/premajhne:
1. Odpri `tools/obdelaj_tilesete.py`
2. Spremeni `nova_velikost_faktor`:
```python
nova_velikost_faktor = 0.3 # Za 30% (manjše)
nova_velikost_faktor = 0.7 # Za 70% (večje)
```
3. Zaženi ponovno:
```bash
python tools/obdelaj_tilesete.py
```
---
## 🎨 Primeri Uporabe
### Primer 1: Dodaj Kai Karakterja
1. Ustvari `assets/tilesets/kai_obdelan.tsx`
2. Dodaj v `micro_farm_128x128.tmx`
3. Postavi na mapo kot **Object Layer** (ne Tile Layer!)
### Primer 2: Dodaj Orodja Pack
1. Ustvari `assets/tilesets/tools_pack_obdelan.tsx`
2. Če je na sliki več orodij (grid), nastavi `tilewidth` in `tileheight` na velikost enega orodja
3. Dodaj v mapo in izberi posamezno orodje iz grida
### Primer 3: Dodaj Zgradbe
1. Ustvari `assets/tilesets/buildings_obdelan.tsx`
2. Če je zgradba večja (npr. 192x192px), nastavi `tilewidth="192" tileheight="192"`
3. Dodaj kot **Object** (ne Tile!), da lahko postaviš na poljubno pozicijo
---
## 🔧 Avtomatizacija (Opcijsko)
Če želiš **avtomatsko generirati TSX datoteke** za vse obdelane slike:
```python
# Ustvari tools/generiraj_tsx.py
# Ta skript bo avtomatsko ustvaril .tsx datoteke za vse slike v narezano_in_majhno/
```
Ali pa mi povej, če želiš, da ti ustvarim ta skript! 😊
---
## 📝 Troubleshooting
### Problem: Slika je preveč narezana
- Zmanjšaj `min_velikost_objekta` v `obdelaj_tilesete.py`
### Problem: Slika je še vedno prevelika
- Zmanjšaj `nova_velikost_faktor` (npr. na 0.3)
### Problem: Na sliki je več objektov, a so vsi skupaj
- Skript poskuša najti ločene objekte glede na prosojnost
- Če so objekti povezani, jih bo obdelal kot en objekt
- Ročno narezovanje v Photoshop/GIMP je najboljša opcija
---
**Srečno z ustvarjanjem map!** 🎮✨