Sound Function - Sound Module Control Function

sdShotSetPitch

Sets the pitch of a One-Shot port

FORMAT

SDE_ERR sdShotSetPitch( handle, pitch, fade_time )
SDSHOT handle
Sint8 pitch
Sint16 fade_time

PARAMETER

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

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 pitch of a One-Shot port.

The argument pitch, which specifies play pitch, is Half tone up = 0100H, half tone down = -0100H.

Units of fade_time, which specifies the time necessary to reach play pitch, are milliseconds, from 0000H (fastest) to 7FFFH (slowest).


NOTE

Higher/lower pitch results in faster/slower play, respectively.

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