remove3D

Built-ins

Canonical ID: scene3d.remove. Nederlands: verwijder3D.

Removes one object from the world by name. A valid absent name is a no-op, unlike other object-edit operations which diagnose unknown names. The displayed frame is unchanged until the next draw3D. Recreating a removed name later gives it a new insertion position; it does not restore previous properties.

See 3D words and camera rules.

Signature

remove3D(name)

Arguments

Return value

None.

Example

# language: en
clear3D("black")
sphere3D("ball", 0.5)
remove3D("ball")
remove3D("ball")
draw3D()

An empty world; removing the object twice is harmless.

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 · sphere3D · cylinder3D · position3D · Programming guides · Host support · Calls and arguments