1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-06 00:00:22 +00:00
QB64-PE/internal/help/_SNDRAWLEN__111111111.txt
Roland Heyder 6912727753 Update help files
Help file snapshot as of 07/31/2022.
2022-07-31 23:57:56 +02:00

33 lines
1.3 KiB
Plaintext

{{QBDLDATE:07-31-2022}}
{{QBDLTIME:23:40:29}}
{{DISPLAYTITLE:_SNDRAWLEN}}
The [[_SNDRAWLEN]] function returns the length, in seconds, of a [[_SNDRAW]] sound currently queued.
{{PageSyntax}}
: {{Parameter|length#}} = [[_SNDRAWLEN]] [{{Parameter|pipeHandle&}}]
{{PageParameters}}
* The optional {{Parameter|pipeHandle&}} parameter refers to the sound pipe opened using [[_SNDOPENRAW]].
{{PageDescription}}
* Use [[_SNDRAWLEN]] to determine the length of a sound queue during creation and when to stop playing the sound.
* Ensure that [[_SNDRAWLEN]] is comfortably above 0 (until you've actually finished playing sound).
* If you are getting occasional random clicks, this generally means that [[_SNDRAWLEN]] has dropped to 0.
* The [[_SNDRATE]] determines how many samples are played per second. However, the timing is achieved by the sound card and [[_SNDRAWLEN]], not your program.
* '''Do not attempt to use [[_TIMER]] or [[_DELAY]] or [[_LIMIT]] to control the timing of [[_SNDRAW]] sounds. You may use them as usual for delays or to limit your program's CPU usage, but the decision of how much sound to queue should only be based on the remaining _SNDRAWLEN'''.
{{PageExamples}}
* See the example in [[_SNDRAW]]
{{PageSeeAlso}}
* [[_SNDRAW]]
* [[_SNDRATE]]
{{PageNavigation}}