sphere3D
Canonical ID: scene3d.sphere. Nederlands: bol3D.
Creates a sphere using its radius, not its diameter. Position is its center. Collision and aiming use the analytic (calculated from the mathematical shape) sphere rather than the visible tessellation (the small faces used to draw a curved surface). Yaw can rotate its texture even though the geometric sphere remains unchanged. New shapes start at (0,0,0), yaw (the left-or-right angle) 0, color #f59e0b, solid true, texture none, and scale 1. Reusing a name replaces every property while preserving insertion order. A world contains at most 256 objects. Creation alone does not draw.
See 3D words and camera rules.
Signature
sphere3D(name, radius)
Arguments
| Parameter | Type | Requirement |
|---|---|---|
name |
Text | Case-sensitive, nonblank object name; at most 64 UTF-8 bytes. |
radius |
Number | Finite, greater than 0 and at most 1,000. |
Return value
None.
Example
# language: en
clear3D("#16213e")
sphere3D("shape", 0.8)
color3D("shape", "orange")
texture3D("shape", "checker", 2)
camera3D(3, 2, 5)
lookAt3D(0, 0, 0)
draw3D()
A textured primitive seen from an angled camera.
Notes and common mistakes
Use the function name for your source language. Its canonical ID is a shared documentation label; you do not type that ID as a call. Giving your own variable or function the same name can hide the built-in. Supply the documented arguments and value types. Pliro reports mismatches when checking can detect them, or when the call runs.
A host is the app or environment running your program. To see a drawing, it needs a renderer, the part that draws on screen. The command-line command pliro run shows text but does not draw these graphics. The host support table explains which effects work in the IDE, browser, native app, and phone preview. A native build reports an unsupported capability instead of leaving it out.
In 3D, +Y points up. Yaw is the left-or-right angle; at zero the camera faces -Z. The world holds at most 256 objects. Changes appear when you call draw3D. An invalid call leaves the world unchanged. Editing requires an existing object name; creating objects and removing an absent name are exceptions. Use the portable color names or hex codes; transparent colors are unavailable here. Version 1 of the phone preview’s communication format does not carry 3D scenes. See the 3D guide for the coordinate rules.
Related entries
clear3D · box3D · cylinder3D · position3D · turn3D · Programming guides · Host support · Calls and arguments