##### 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