diff --git a/docs/manual/index.html b/docs/manual/index.html index 368b182e..df36f815 100644 --- a/docs/manual/index.html +++ b/docs/manual/index.html @@ -838,10 +838,17 @@ ma_sound_set_stop_time_in_milliseconds() The start/stop time needs to be specified based on the absolute timer which is controlled by the engine. The current global time time in PCM frames can be retrieved with ma_engine_get_time(). The engine's global time can be changed with ma_engine_set_time() for synchronization purposes if -required. +required. Note that scheduling a start time still requires an explicit call to ma_sound_start() +before anything will play:

+

+
+ma_sound_set_start_time_in_pcm_frames(&sound, ma_engine_get_time(&engine) + (ma_engine_get_sample_rate(&engine) * 2);
+ma_sound_start(&sound);
+

+ The third parameter of ma_sound_init_from_file() is a set of flags that control how the sound be loaded and a few options on which features should be enabled for that sound. By default, the sound is synchronously loaded fully into memory straight from the file system without any kind of @@ -2533,6 +2540,11 @@ ma_sound_set_start_time_in_pcm_frames(&sound, ma_engine_get_time(&engine ma_sound_set_stop_time_in_pcm_frames(&sound, ma_engine_get_time(&engine) + (ma_engine_get_sample_rate(&engine) * 2));

+Note that scheduling a start time still requires an explicit call to ma_sound_start() before +anything will play. +

+

+ The time is specified in global time which is controlled by the engine. You can get the engine's current time with ma_engine_get_time(). The engine's global time is incremented automatically as audio data is read, but it can be reset with ma_engine_set_time() in case it needs to be