# cilinder3D

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `scene3d.cylinder`. English: `cylinder3D`.

Een **cilinder** is een vorm zoals een blikje. **Afgesloten** betekent dat de ronde boven- en onderkant dicht zijn. De **as** is de lijn door de middelpunten van die uiteinden. De **straal** is de helft van de breedte dwars door een rond uiteinde. **Facetten** zijn de kleine platte vlakken waarmee de vorm wordt getekend. Bij **rakend contact** raken twee oppervlakken elkaar net.

Maakt een gesloten rechtopstaande cilinder gecentreerd op zijn positie met de as langs +Y. Hoogte is de volledige hoogte. Horizontale draaiing roteert vlakken en textuur zonder de analytische (wiskundig berekende) vorm te veranderen. Weergave gebruikt 12 zijden; botsingen en stralen gebruiken exacte cirkelzijden en eindschijven, inclusief raakcontact. Nieuwe vormen beginnen op (0,0,0), hoek 0, kleur #f59e0b, stevig waar, textuur none en schaal 1. Hergebruik van een naam vervangt alle eigenschappen met behoud van invoegvolgorde. Een wereld bevat maximaal 256 objecten. Alleen maken tekent niet.

Zie [3D-begrippen en cameraregels](../gidsen/3d-werelden.md).

## Aanroepvorm

```text
cilinder3D(naam, straal, hoogte)
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `naam` | Text | Hoofdlettergevoelige, niet-blanke objectnaam; maximaal 64 UTF-8-bytes. |
| `straal` | Number | Eindig, groter dan 0 en maximaal 1.000. |
| `hoogte` | Number | Eindig, groter dan 0 en maximaal 1.000. |

## Terugkeerwaarde

`None`.

## Voorbeeld

```pliro
# taal: nl
wis3D("#16213e")
cilinder3D("shape", 0.6, 2)
kleur3D("shape", "orange")
textuur3D("shape", "checker", 2)
camera3D(3, 2, 5)
kijkNaar3D(0, 0, 0)
teken3D()
```

Een vorm met textuur gezien vanuit een schuine camerapositie.

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

In 3D wijst +Y omhoog. **Yaw** is de horizontale kijkhoek; bij nul kijkt de camera naar -Z. De wereld bevat maximaal 256 objecten. Wijzigingen verschijnen met `teken3D`. Een ongeldige aanroep laat de wereld ongewijzigd. Bewerken vereist een bestaande objectnaam; maken en het verwijderen van een ontbrekende naam zijn uitzonderingen. Gebruik de [overdraagbare kleurnamen of hexcodes](../gidsen/kleuren.md); doorzichtige kleuren zijn hier niet beschikbaar. Versie 1 van het communicatieformaat voor de telefoonpreview draagt geen 3D-scènes over. Zie de [3D-gids](../gidsen/3d-werelden.md) voor de coördinatenregels.

## Gerelateerde lemma’s

[wis3D](wis3D.md) · [doos3D](doos3D.md) · [bol3D](bol3D.md) · [plaats3D](plaats3D.md) · [draai3D](draai3D.md) · [Programmeergidsen](../gidsen/3d-werelden.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)