N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
Mus - Mus Library
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

Mus Library Reference

## MusHandleSetReverb()

Set the reverb offset value using a sound value.

Syntax

      void MusHandleSetReverb(musHandle handle, int reverb);

Arguments

- handle is the sound handle

- reverb is the reverb offset

Explanation
Set the reverb offset value for the channels associated with the specified sound handle. The reverb offset is used as a base value for the reverb settings defined in the sound data, and the sound data's settings are scaled based on the remaining possible settings.

The handle must be a sound handle returned by MusStartSong(), MusStartEffect() or MusStartEffect2(). If a handle of zero is supplied, this function will always return zero.

The reverb value should be within the range of 0 to 0x7F (127). The default reverb offset for all channels is 0. This value is used in the following manner to calculate the channel's reverb level:

       channelreverb = reverb+(((128-reverb)*datareverb)>>7)

Return Value
Number of channels which have been changed.

Example

      void ReverbFromDepth(unsigned long handle, int depth)
      {
        /* depth in range 0-32767 */
        MusHandleSetReverb(handle, depth>>8);
      }

See Also
MusStartSong()
MusStartEffect()
MusStartEffect2()

Nintendo® Confidential Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.
Copyright © 1998-1999
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated March 1999