# Note transposition

``

    use_transpose  note_shift (number)

Transposes your music by shifting all notes played by the specified amount. To shift up by a semitone use a transpose of 1. To shift down use negative numbers. See `with_transpose` for setting the transpose value only for a specific `do`/`end` block. To transpose entire octaves see `use_octave`.

Introduced in v2.0

## Examples

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

    # Plays note 51
# Example 2
``
    play 62
    use_transpose -12
    play 62
    use_transpose 3
    play 62
| ``
    # You may change the transposition multiple times:
    # Plays note 62

    # Plays note 50

    # Plays note 65