# Note octave transposition

``

    use_octave  octave_shift (number)

Transposes your music by shifting all notes played by the specified number of octaves. To shift up by an octave use a transpose of 1. To shift down use negative numbers. See `with_octave` for setting the octave shift only for a specific `do`/`end` block. For transposing the notes within the octave range see `use_transpose`.

Introduced in v2.9

## Examples

# Example 1
``
    play 50
    use_octave 1
    play 50
| ``
    # Plays note 50

    # Plays note 62
# Example 2
``
    play 62
    use_octave -1
    play 62
    use_octave 2
    play 62
| ``
    # You may change the transposition multiple times:
    # Plays note 62

    # Plays note 50

    # Plays note 86