natiny.audio.listener_destroy

natiny.audio.listener_destroy(listener)

Destroys a listener and invalidates its entity handle.

Parameters

Example

natiny.audio.listener_destroy(listener)

Notes

• Destroying the active listener leaves no listener active, and spatial sources are silent until one is made active again. Which of the survivors takes over is natiny.audio.listener_set_active to say.
• Source handles are not accepted here; use natiny.audio.source_destroy.
• Everything parented to the listener is destroyed with it, and so is everything parented to those, all the way down. Each one goes through the destroy its own kind has, so a child model gives back its parts, a child body leaves the physics world and a child source releases its voice - a subtree is freed as completely as its nodes would be one at a time.
• Detach a child to keep it: natiny.entity.set_parent(child, 0) leaves its local transform as its world transform, and the destroy passes it by.
• Invalid and already destroyed handles are ignored.