# Sprites: afbeeldingen die je kunt bewegen

[Programmeergidsen](LEESMIJ.md)

Een **sprite** is een benoemd plaatje in je scène, zoals de held van je spel. Pliro **behoudt** het: het onthoudt dat benoemde plaatje, zodat je het op een andere plek kunt tonen zonder steeds een nieuwe sprite te maken.

Een **transformatie** verandert hoe een plaatje wordt geplaatst: verschuiven, draaien of spiegelen. **Horizontaal spiegelen** verwisselt links en rechts, zoals in een spiegelbeeld. De **kniprechthoek** is het gebied waarin het plaatje zichtbaar mag zijn; delen erbuiten worden verborgen. De **stapelvolgorde** werkt als blaadjes op elkaar: een later blaadje kan een eerder blaadje bedekken. Hieronder staan de precieze regels waarmee Pliro deze veranderingen verwerkt.

| Nederlandse aanroep | Canonieke ID | Resultaat |
|---|---|---|
| `toonSprite(naam, mediapad, x, y, breedte, hoogte)` | `sprites.show` | `None` |
| `toonSprite(naam, mediapad, x, y, breedte, hoogte, draaiing)` | `sprites.show` | `None` |
| `toonSprite(naam, mediapad, x, y, breedte, hoogte, draaiing, spiegelHorizontaal)` | `sprites.show` | `None` |
| `toonSprite(naam, mediapad, x, y, breedte, hoogte, draaiing, spiegelHorizontaal, spiegelVerticaal)` | `sprites.show` | `None` |
| `verbergSprite(naam)` | `sprites.hide` | `None` |

Naam en mediapad zijn niet-lege tekst. Coördinaten zijn eindig; breedte en
hoogte zijn positief. `(x, y)` is de linkerbovenhoek. Een nieuwe naam maakt een
sprite; dezelfde naam werkt afbeelding en rechthoek bij zonder de stapelpositie
te wijzigen. Verbergen verwijdert de sprite. Later opnieuw tonen plaatst hem
boven sprites die zichtbaar bleven.

`draaiing` is een eindig getal in graden met de klok mee rond het midden van de
rechthoek, standaard 0. Beide spiegelargumenten zijn Booleans, standaard
`onwaar`, toegepast in lokale spritecoördinaten vóór de draaiing. De opgegeven
rechthoek blijft de plaatsings- en afsnijrechthoek. Weggelaten optionele waarden
krijgen bij iedere aanroep opnieuw hun standaard. Bijvoorbeeld:

```text
toonSprite("held", "assets/held.png", 100, 220, 48, 64, 15, waar, onwaar)
```

Dit draait 15 graden met de klok mee en spiegelt horizontaal.
Zie de [spritespecificatie](../../../docs/spec/sprites.md).

Native hosts rekken de afbeelding naar de opgegeven rechthoek; de IDE-preview
behoudt de beeldverhouding. Kies voor gelijke resultaten een rechthoek met
dezelfde verhouding als de bronafbeelding.

## Gerelateerde lemma’s

[Syntaxis en waarden](../syntaxis/LEESMIJ.md) · [Ingebouwde functies](../ingebouwde-functies/LEESMIJ.md) · [Programmeergidsen](LEESMIJ.md)