natiny_audio_source_create
C
NatinyAudioSource natiny_audio_source_create(NatinyClip clip);
Creates a stopped sound-source entity that plays a clip.
Parameters
| Name |
Type |
Description |
clip |
NatinyClip |
Clip whose samples this source plays |
Returns
| Type |
Description |
NatinyAudioSource |
Source handle, also usable as a NatinyEntity; 0 on failure |
Example
C
NatinyAudioSource 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;
the function returns
0 when the limit is exhausted or allocation fails.