plaats3D
Canonieke ID: scene3d.position. English: position3D.
Zet het middelpunt van een bestaand object op een absolute wereldpositie. +Y is omhoog; dit is niet het 2D-schermstelsel. Geometrie, draaiing, kleur, textuur en stevigheid blijven behouden. Plaatsen voorkomt geen botsing: broncode mag objecten in elkaar zetten. Roep daarna teken3D aan om de wijziging te tonen.
Zie 3D-begrippen en cameraregels.
Aanroepvorm
plaats3D(naam, x, y, z)
Argumenten
| Parameter | Type | Vereiste |
|---|---|---|
naam |
Text | Hoofdlettergevoelige, niet-blanke objectnaam; maximaal 64 UTF-8-bytes. |
x |
Number | Eindige wereldcoördinaat, absolute waarde maximaal 10.000. |
y |
Number | Eindige wereldcoördinaat, absolute waarde maximaal 10.000. |
z |
Number | Eindige wereldcoördinaat, absolute waarde maximaal 10.000. |
Terugkeerwaarde
None.
Voorbeeld
# taal: nl
wis3D("black")
doos3D("box", 1, 1, 1)
plaats3D("box", 1, 0, -2)
kijkNaar3D(1, 0, -2)
teken3D()
Het doosmiddelpunt gaat naar (1,0,-2).
Aandachtspunten en veelgemaakte fouten
Gebruik de functienaam van je brontaal. De canonieke ID 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 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 pliro run toont tekst maar tekent deze beelden niet. De tabel met uitvoeromgevingen 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; doorzichtige kleuren zijn hier niet beschikbaar. Versie 1 van het communicatieformaat voor de telefoonpreview draagt geen 3D-scènes over. Zie de 3D-gids voor de coördinatenregels.
Gerelateerde lemma’s
wis3D · doos3D · bol3D · cilinder3D · draai3D · Programmeergidsen · Hostondersteuning · Aanroepen en argumenten
