.. _moduleBraille.translate:

music21.braille.translate
=========================

.. WARNING: DO NOT EDIT THIS FILE: AUTOMATICALLY GENERATED. Edit the .py file directly

.. module:: music21.braille.translate


Objects for exporting music21 data as braille.




.. function:: keyboardPartsToBraille(music21PartStaffUpper, music21PartStaffLower, debug=False, **keywords)


    Translates a stream Part consisting of two stream Parts, a right hand and left hand,
    into braille music bar over bar format.



.. function:: measureToBraille(music21Measure, debug=False, **keywords)


.. function:: objectToBraille(music21Obj, debug=False, **keywords)



    Translates an arbitrary object to Braille.  Doesn't yet work on notes:



    >>> from music21 import *
    ⁠ 
    >>> tns = tinyNotation.TinyNotationStream('C4 D16 E F G# r4 e2.', '3/4')
    >>> x = braille.translate.objectToBraille(tns)
    >>> print x
    ⠀⠀⠀⠀⠀⠀⠀⠼⠉⠲⠀⠀⠀⠀⠀⠀⠀
    ⠼⠁⠀⠸⠹⠵⠋⠛⠩⠓⠧⠀⠐⠏⠄⠣⠅

    For normal users, you'll just call this, which starts a text editor:




    >>> tns.show('braille')
    ⠀⠀⠀⠀⠀⠀⠀⠼⠉⠲⠀⠀⠀⠀⠀⠀⠀
    ⠼⠁⠀⠸⠹⠵⠋⠛⠩⠓⠧⠀⠐⠏⠄⠣⠅



.. function:: partToBraille(music21Part, debug=False, **keywords)


.. function:: streamToBraille(music21Stream, debug=False, **keywords)


