# 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.)

## 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