# cirkel

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `graphics.circle`. English: `circle`.

Tekent een gevulde cirkel met middelpunt x,y. De straal is in logische pixels en moet strikt positief zijn. De aanroep voegt tekening aan het huidige beeld toe; zij wist eerdere vormen niet en geeft geen sprite- of botsingsobject. Gebruik de 3D-bolfunctie voor een bol in een wereld.

## Aanroepvorm

```text
cirkel(x, y, straal, kleur)
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `x` | Number | Eindige horizontale coördinaat in logische pixels. |
| `y` | Number | Eindige verticale coördinaat in logische pixels. |
| `straal` | Number | Eindig en groter dan 0. |
| `kleur` | Text | Niet leeg; gebruik overdraagbare Engelse/Nederlandse namen of #RGB/#RRGGBB. |

## Terugkeerwaarde

`None`.

## Voorbeeld

```pliro
# taal: nl
wisScherm("white")
cirkel(200, 180, 30, "red")
cirkel(400, 180, 60, "blauw")
```

Twee cirkels met verschillende middelpunten en stralen.

## 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.

2D gebruikt een beeld van 640 × 360 met oorsprong linksboven, +X rechts en +Y omlaag. Engelse en Nederlandse overdraagbare kleuren werken in iedere syntaxtaal, evenals #RGB en #RRGGBB. Andere niet-lege 2D-kleurtekst is hostafhankelijk.

## Gerelateerde lemma’s

[wisScherm](wisScherm.md) · [rechthoek](rechthoek.md) · [tekenLijn](tekenLijn.md) · [tekenTekst](tekenTekst.md) · [Programmeergidsen](../gidsen/tekenen.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)