# textuur3D

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `scene3d.texture`. English: `texture3D`.

Kiest een berekend oppervlaktepatroon op een bestaand object. Toegestane teksten zijn none, checker en brick; trimmen en omzetten naar kleine letters zijn van toepassing. Dit zijn gegevens, dus Nederlandse bron schrijft ook "checker" en "brick". Schaal is herhalingen per lokale wereldeenheid, geen afbeeldingsbreedte of objectgrootte. Weglaten herstelt schaal 1. Texturen bewegen met het object en vereisen geen bestanden of downloads; kleur, geometrie, volgorde en stevigheid blijven bestaan.

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

## Aanroepvorm

```text
textuur3D(naam, patroon)
textuur3D(naam, patroon, schaal)
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `naam` | Text | Hoofdlettergevoelige, niet-blanke objectnaam; maximaal 64 UTF-8-bytes. |
| `patroon` | Text | "none", "checker" of "brick". |
| `schaal` | Number, optioneel | Eindig, groter dan 0 en maximaal 32; standaard 1. |

## Terugkeerwaarde

`None`.

## Voorbeeld

```pliro
# taal: nl
wis3D("#16213e")
doos3D("wall", 3, 2, 0.5)
kleur3D("wall", "brown")
textuur3D("wall", "brick", 2)
kijkNaar3D(0, 0, 0)
teken3D()
```

Een muur met baksteenpatroon, met twee patroonherhalingen per lokale wereldeenheid.

## 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) · [cilinder3D](cilinder3D.md) · [plaats3D](plaats3D.md) · [Programmeergidsen](../gidsen/3d-werelden.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)