natiny.audio.source_create
Lua
natiny.audio.source_create(clip) -> source
Creates a stopped sound-source entity that plays a clip.
Parameters
| Name |
Type |
Description |
clip |
number |
Clip handle whose samples this source plays |
Returns
| Type |
Description |
number |
Source handle, also usable as an entity handle |
Example
Lua
local source = natiny.audio.source_create(clip)
Notes
- The source does not own the clip or its decoded samples. Multiple sources
can share one clip; destroying the source leaves the clip intact.
- Each source owns one playback voice. At most 256 sources can exist at once;
Lua raises an error when the limit is exhausted or allocation fails.