NNS_SndPlayerSetTrackPitch

Syntax

#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 sound handle handle changes the track pitch of the sequence to which it is bound. 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 pitch changed. For example, to change the pitch of Track 2 and Track 5, use (1 << 2) | (1 << 5), which works out to 0x0024.

When pitch is positive, the pitch gets higher; when pitch is negative, the pitch gets lower. +/-64 produces a change of exactly one semitone or half step. (The value of pitch does not accumulate each time the function is called.)

Revision History