SetScoreBendRange

Sets the current pitch bend range value for a score context.

Synopsis

Err SetScoreBendRange( ScoreContext *scon, int32 BendRange )

Description

The function sets a score's current pitch bend range value. This value is an integer, measured in semitones (half steps), that sets the range above or below normal that instruments can be bent. A pitch range of two, for example, means that instruments can bend up two semitones (a whole step up) and down two semitones (a whole step down).

Note that DSP sampled sound instruments won't bend any more than 12 semitones, so don't set BendRange to a value greater than 12.

Arguments

scon: Pointer to a ScoreContext data structure.

BendRange: A pitch bend range value from 1 to 12.

Return Value

This function returns 0 if all went well; otherwise, an error code (less then 0) indicating that an error occurred.

Implementation

Library call implemented in music.lib V20.

Associated Files

score.h, music.lib