# 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

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

04/01/2004 Initial version.