Sound Function - Sound Module Control Function

sdShotSetSpeed

Sets the speed of a One-Shot port

FORMAT

SDE_ERR sdShotSetSpeed( handle, Speed, fade_time )
SDSHOT handle
Sint8 Speed
Sint16 fade_time

PARAMETER

 handle  Object handle 
 speed  Target play speed 
 fade_time  Time to reach target play speed 

RETURN

 SDE_ERR_NO_INIT  The Sound Library has not been initialized 
 SDE_ERR_HANDLE_NULL  The handle is NULL 
 SDE_ERR_HOST_CMD_BUF_NO_ENOUGH  No more host commands can be accepted 

DESCRIPTION

Sets the play speed of a One-Shot port.

The range of speed, which specifies play speed, is -18FFH (slowest) to 0000H (mid) to 18FFH (fastest), with half speed = -0C00H and double speed = 0C00H.

The units of fade_time, which specify the time necessary to reach play speed, are milliseconds, from 0000H (fastest) to 7FFFH (slowest).


NOTE

When you make the play speed faster, the play pitch rises as a side effect, and when you make the play speed slower, the play pitch falls as a side effect.

sdShotSetSpeed
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998,1999