NNS_SndPlayerSetTrackPitch

C Specification

#include <nnsys/snd.h>
void NNS_SndPlayerSetTrackPitch(
        NNSSndHandle* handle,
        u16 trackBitMask,
        int pitch );

Arguments

handle The sound handle pointer.
trackBitMask This is the track bit mask.
pitch Pitch change value. Takes a value between -32768 and 32767.

Return Values

None.

Description

This function changes the pitch of the sequence track.

The track pitch of the sequence that is bound to the Sound Handle is changed. This function does not perform any action if the stream handle is invalid.

trackBitMask specifies the track 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 pitch changed. For example, to change the pitch of Track 2 and Track 5, use (1 << 2) | (1 << 5); i.e., 0x0024.

When pitch is positive, the pitch gets higher; when pitch is negative, the pitch gets lower. A half-pitch change occurs at +/-64. (The value of pitch does not accumulate each time the function is called)

See Also

None.

Revision History

2004/06/01 Revised to state that the Sound Handle binds to the sequence.

2004/04/01 Initial version.


CONFIDENTIAL