# toonSprite

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `sprites.show`. English: `showSprite`.

Maakt of wijzigt een benoemde behouden sprite. Wijzigen bewaart de stapelpositie; na verbergen opnieuw tonen plaatst de naam boven overgebleven sprites. Draaiing is met de klok mee rond het rechthoekmidden. Lokaal horizontaal/verticaal spiegelen gebeurt vóór draaien. Weggelaten transformaties worden iedere aanroep 0,onwaar,onwaar. De rechthoek blijft plaatsings- en afsnijrechthoek. Native uitvoer rekt momenteel terwijl de [IDE](../begrippen/ontwikkelomgeving.md) de verhouding bewaart; kies gelijke bron- en doelverhoudingen voor overdraagbaarheid.

## Aanroepvorm

```text
toonSprite(naam, mediapad, x, y, breedte, hoogte)
toonSprite(naam, mediapad, x, y, breedte, hoogte, draaiing)
toonSprite(naam, mediapad, x, y, breedte, hoogte, draaiing, spiegelHorizontaal)
toonSprite(naam, mediapad, x, y, breedte, hoogte, draaiing, spiegelHorizontaal, spiegelVerticaal)
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `naam` | Text | Niet-lege sprite-identiteit; geen variabeledeclaratie. |
| `mediapad` | Text | Niet-leeg verpakt projectrelatief mediapad, normaal onder assets/. |
| `x` | Number | Eindige horizontale coördinaat in logische pixels. |
| `y` | Number | Eindige verticale coördinaat in logische pixels. |
| `breedte` | Number | Eindig en positief. |
| `hoogte` | Number | Eindig en positief. |
| `draaiing` | Number, optioneel | Eindige graden met de klok mee; standaard 0. |
| `spiegelHorizontaal` | Boolean, optioneel | Standaard onwaar; geef eerst de draaiing. |
| `spiegelVerticaal` | Boolean, optioneel | Standaard onwaar; geef voorgaande argumenten. |

## Terugkeerwaarde

`None`.

## Voorbeeld

```pliro
# taal: nl
toonSprite("hero", "assets/hero.png", 100, 220, 48, 64, 15, waar, onwaar)
wacht(0.2)
toonSprite("hero", "assets/hero.png", 160, 220, 48, 64)
```

Verpak `assets/hero.png`. De tweede aanroep verplaatst dezelfde sprite en herstelt draaiing en spiegeling.

## Aandachtspunten en veelgemaakte fouten

Gebruik de functienaam van je brontaal. De [canonieke ID](../begrippen/canonieke-identiteit.md) is een gezamenlijk documentatielabel; die ID typ je niet als aanroep. Een eigen variabele of functie met dezelfde naam kan de ingebouwde functie verbergen. Geef de beschreven [argumenten](../begrippen/parameters-en-argumenten.md) en waardesoorten mee. Pliro meldt verschillen wanneer controle ze kan vinden, of wanneer de aanroep draait.

Een **host** is de app of omgeving die je programma uitvoert. Voor zichtbaar beeld heeft die een **renderer** nodig: het onderdeel dat op het scherm tekent. De [opdrachtregelopdracht](../begrippen/opdrachtregel.md) `pliro run` toont tekst maar tekent deze beelden niet. De [tabel met uitvoeromgevingen](../gidsen/uitvoeromgevingen.md) vertelt welke effecten werken in de IDE, browser, native app en telefoonpreview. Een native bouw meldt een ontbrekende mogelijkheid in plaats van die weg te laten.

Het voorbeeld vereist de genoemde bestanden in een .bipli-project. Verpakte mediabestanden zijn momenteel elk maximaal 12 MiB. Paden onder assets/ zijn projectverwijzingen, geen willekeurige bestanden of URL’s. Native export ondersteunt speelGeluid nog niet.

## Gerelateerde lemma’s

[verbergSprite](verbergSprite.md) · [Programmeergidsen](../gidsen/sprites.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)