Difference between revisions of "API Sound.SetRate"

From Flowcode Help
Jump to navigationJump to search
(XML import of updated API docs)
Line 24: Line 24:
  
 
==Detailed description==
 
==Detailed description==
''<span style="color:red;">No additional information</span>''
+
The base sample is specified in creation through [[API Sound.Create|Sound.Create]]. This call does not alter that rate, but specifies a scale factor for the samples played. Subsequent sounds played through this handle will have their wave-forms transformed using this scale factor as a step. Linear interpolation is used to smooth the waveform.
 +
 
 +
 
 +
The conversion factor is calculated as (Original_Rate / ''Rate''), meaning a ''Rate'' of zero is illegal and will cause the call to fail.
 +
 
  
  

Revision as of 16:30, 7 August 2013


<sidebar>API contents</sidebar> Sets the current sample rate for the sound - this will stop the playing sound

Class hierarchy

Sound

SetRate

Parameters

HANDLE Sounds

The handle of the sound object to modify

ULONG Rate

The sample rate to set


Return value

This call does not return a value


Detailed description

The base sample is specified in creation through Sound.Create. This call does not alter that rate, but specifies a scale factor for the samples played. Subsequent sounds played through this handle will have their wave-forms transformed using this scale factor as a step. Linear interpolation is used to smooth the waveform.


The conversion factor is calculated as (Original_Rate / Rate), meaning a Rate of zero is illegal and will cause the call to fail.


Examples

Calling in a calculation

  • Add to a calculation icon:
    ::Sound.SetRate(sounds, rate)

No additional examples