NNS_SndPlayerSetTrackPan

Syntax

#include <nnsys/snd.h>

void NNS_SndPlayerSetTrackPan(
        NNSSndHandle* handle,
        u16 trackBitMask,
        int pan );

Arguments

`handle`	Sound handle pointer.
`trackBitMask`	Track bit mask.
`pan`	Change value for pan (position). Takes a value between -128 and 127.

Return Values

None.

Description

Changes the pan position for a sequence track.

This function changes the track pan 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. The tracks are identified from the lower bit in sequence: Track 0, Track 1, Track 2 .... All tracks with enabled bits will have their pan changed. For example, to change the pan of Track 2 and Track 5, use (1 << 2) | (1 << 5); that is, 0x0024.

The pan argument is added to the original pan value. When pan is positive, motion is to the right; when pan is negative, motion is to the left. (Does not accumulate each time the function is called.)

Revision History