GetScoreBendRange

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

Synopsis

int32 GetScoreBendRange( ScoreContext *scon )

Description

This function retrieves the pitch bend range value currently set for the score. 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).

Arguments

scon
Pointer to a ScoreContext data structure.

Return Value

This function returns the current pitch bend range value of the specified score if successful, or an error code (a negative value) if an error occurs.

Implementation

Library call implemented in music.lib V20.

Associated Files

score.h, music.lib

See Also

ChangeScorePitchBend(), ConvertPitchBend(), SetScoreBendRange()