NNS_SndPlayerSetTrackPanRange

Syntax

#include <nnsys/snd.h>

void NNS_SndPlayerSetTrackPanRange(
        NNSSndHandle* handle,
        u16 trackBitMask,
        int panRange );

Arguments

`handle`	The sound handle pointer.
`trackBitMask`	This is the track bit mask.
`panRange`	The pan range. Takes a value between 0 and 127.

Return Values

None.

Description

Changes the pan range for a sequence track.

This function changes the pan range for the sequence linked to the sound handle handle. This function does not perform any action if the sound handle is invalid.

Use trackBitMask to specify the tracks to be set. Tracks are indicated in order from the lowest bit starting with Track 0, Track 1, Track 2, etc. The pan range is changed for each track with an enabled bit, e.g., to change the pan range for Track 2 and Track 5, then set (1 << 2) | (1 << 5), i.e., 0x0024.

panRange specifies the range of change for the pan set in the sound data. The values between 0 and 127 represent a range of 0% to 100%. The default value is 127. Setting a smaller value narrows the range of change for the pan set in the sound data.

Note

The pan range setting only affects the pan set in the sound data. The pan set by the NNS_SndPlayerSetTrackPan function is not affected.

Revision History

2005/03/02 Initial version.