# 🧭 Tiled Terrain Quick Reference

## Corner-Based Terrain Notation

Tiled uporablja **4-corner system** za definiranje terrain transitions.

### Format Notation
```
terrain="TopLeft,TopRight,BottomLeft,BottomRight"
```

Vsaka pozicija ima številko terrajna (0, 1, 2...) ali je prazna (,) če ni terrain.

---

## 📊 Visual Guide - 3x3 Terrain Pattern

```
┌─────────┬─────────┬─────────┐
│   TL    │    T    │   TR    │
│  ,,,0   │  ,,0,0  │  ,,0,   │
├─────────┼─────────┼─────────┤
│    L    │  CENTER │    R    │
│  ,0,,0  │ 0,0,0,0 │  0,,,0  │
├─────────┼─────────┼─────────┤
│   BL    │    B    │   BR    │
│  ,0,,   │  0,0,,  │  0,,,   │
└─────────┴─────────┴─────────┘

Legend:
TL = Top-Left      T = Top         TR = Top-Right
L  = Left          C = Center      R  = Right
BL = Bottom-Left   B = Bottom      BR = Bottom-Right
```

---

## 🎨 Examples: Terrain ID "0"

| Tile Type | Terrain Value | Visual | Description |
|-----------|---------------|--------|-------------|
| **Top-Left Corner** | `,,,0` | `◣` | Only bottom-right corner belongs to terrain |
| **Top Edge** | `,,0,0` | `▄` | Bottom two corners belong to terrain |
| **Top-Right Corner** | `,,0,` | `◢` | Only bottom-left corner belongs to terrain |
| **Left Edge** | `,0,,0` | `▐` | Right two corners belong to terrain |
| **Center (FILL)** | `0,0,0,0` | `█` | All four corners belong to terrain |
| **Right Edge** | `0,,,0` | `▌` | Left two corners belong to terrain |
| **Bottom-Left Corner** | `,0,,` | `◤` | Only top-right corner belongs to terrain |
| **Bottom Edge** | `0,0,,` | `▀` | Top two corners belong to terrain |
| **Bottom-Right Corner** | `0,,,` | `◥` | Only top-left corner belongs to terrain |

---

## 🔀 Inner Corners (Advanced)

Za kompleksne oblike potrebuješ "inner corners":

| Tile Type | Terrain Value | Visual | Description |
|-----------|---------------|--------|-------------|
| **Inner Top-Left** | `0,,0,0` | Konkaven kot | Missing top-right corner |
| **Inner Top-Right** | `0,0,0,` | Konkaven kot | Missing bottom-right corner |
| **Inner Bottom-Left** | `,0,0,0` | Konkaven kot | Missing top-left corner |
| **Inner Bottom-Right** | `0,0,,0` | Konkaven kot | Missing bottom-left corner |

---

## 🌊 Multi-Terrain Example

### Grass (0) in Dirt (1)

```xml
<!-- GRASS TERRAIN -->
<tile id="0" terrain=",,,0"/>  <!-- Grass Top-Left -->
<tile id="5" terrain="0,0,0,0"/> <!-- Grass Center -->

<!-- DIRT TERRAIN -->
<tile id="10" terrain=",,,1"/>  <!-- Dirt Top-Left -->
<tile id="15" terrain="1,1,1,1"/> <!-- Dirt Center -->

<!-- TRANSITION: Grass to Dirt -->
<tile id="20" terrain="0,0,1,1"/> <!-- Top is Grass, Bottom is Dirt -->
```

---

## 🎯 Pro Tips

1. **Empty = Non-terrain**: Prazno (,) pomeni "ta kot ni del terrajna"
2. **Terrain 0 = First**: Prvi terrain je vedno ID 0, drugi je 1, itd.
3. **Symmetry**: Pazi na simetrijo - `,,0,0` (top edge) NI enako kot `0,0,,` (bottom edge)
4. **Testing**: Uporabi Fill Tool v Tiled-u za test terrain transitions

---

## 🔧 Wang Sets (Alternative)

Za **connected structures** (ograje, cevi):

```xml
<wangset name="Fence" type="edge" tile="-1">
  <wangcolor name="Fence" color="#ff0000" tile="-1"/>
  <wangtile tileid="0" wangid="0,0,1,0,1,0,0,0"/>
</wangset>
```

**Wang ID Format** (Edge-based):
```
wangid="Top,Top,Right,Right,Bottom,Bottom,Left,Left"
```

Vsaka pozicija: `0` = no edge, `1` = edge exists

---

## 📚 Learning Path

1. ✅ Začni s preprostimi 3x3 terrain patterns
2. ✅ Preizkusi Terrain Brush v Tiled-u
3. ✅ Dodaj inner corners za kompleksne oblike
4. ✅ Eksperimentiraj z multi-terrain transitions
5. ✅ Preidi na Wang Sets za connected structures

---

**Happy Terrain Painting!** 🎨