<html>
<body>
<blockquote type=cite class=cite cite=""><br>
Sound Without Sight - Thursday, November 21, 2024 at 11:45 AM<br><br>
<h1><b>Handout: braille music translation using Sao Mai Braille
(SMB)</b></h1><br><br>
<br>
<h1><b>Introduction</b></h1><br><br>
This is the handout to accompany our November 2024 Monthly Meet-up
Session. James Bowden, Braille Technical Officer at RNIB, demonstrates
how to access all the basic functions of the Sao Mai Braille (SMB) app
using screen reader and keyboard navigation. James demonstrates using
NVDA on Windows.<br><br>
Sighted users can of course also navigate SMB using a mouse and without
using a screen reader. The functions demonstrated are the same.<br><br>
Please continue for James’ handout.<br><br>
<h2><b>Table of contents</b></h2><br><br>
<ul>
<li><a href="#aioseo-what-is-smb">What is SMB</a>
<li><a href="#aioseo-download-and-installation">Download and
installation</a>
<ul>
<li><a href="#aioseo-a-word-about-accessibility">A word about
accessibility</a>
</ul>
<li><a href="#aioseo-quick-reminder-about-musicxml">Quick reminder about
MusicXML</a>
<li><a href="#aioseo-the-basic-process">The basic process</a>
<li><a href="#aioseo-adding-text">Adding text</a>
<li><a href="#aioseo-settings-and-options">Settings and options</a>
<ul>
<li><a href="#aioseo-smb-options">SMB options</a>
<li><a href="#aioseo-embosser-settings">Embosser settings</a>
<li><a href="#aioseo-translation-tables-options">Translation tables
options</a>
<li><a href="#aioseo-music-options">Music options</a>
<li><a href="#aioseo-profiles">Profiles</a>
<li><a href="#aioseo-the-score-info-dialog">The Score info dialog</a>
</ul>
<li><a href="#aioseo-music-navigation">Music navigation mode</a>
<li><a href="#aioseo-more-information-and-help">More information and
help</a>
</ul><br>
<h1><b>What is SMB</b></h1><br><br>
The Sao Mai Braille converter (SMB) is a braille translation program
developed by the Sao Mai Center for the Blind, in Vietnam. SMB can
convert all kinds of text into braille in various different languages and
can also convert mathematics, tactile graphics and music. In this
presentation we’ll concentrate just on the music.<br><br>
There are two ways to access the music translation of SMB: on the web, or
with an app. The advantage of the online version is there is no
installation required and you can access it from any platform. The online
version only translates music and can be accessed at
<a href="https://saomaicenter.org/en/smsoft/smb-online">
https://saomaicenter.org/en/smsoft/smb-online</a>.<br><br>
The Windows app gives access to all the music options and can also
translate other kinds of material. In this session, we’ll concentrate
on the app. The app is currently only available for Windows.<br><br>
<h1><b>Download and installation</b></h1><br><br>
<ol>
<li>Go to
<a href="https://saomaicenter.org/en/smsoft/smb">
https://saomaicenter.org/en/smsoft/smb</a>
<li>Under the heading “Download latest version”, fill in the form
with your details.
<li>Select whether you want to download the installation setup file, or a
ZIP file for a manual install, then press the Download button.
<li>Once downloaded, follow the instructions in the setup installation
program or the Readme file in the ZIP package.
<li>Note: you may need administrator privileges.
</ol><br>
<h2><b>A word about accessibility</b></h2><br><br>
If you plan to use a screen reader with SMB, make sure that the Windows
setting for display “scaling” is set to 100%.
<ol>
<li>Press the Windows key.
<li>Type Scaling in the search box and press Enter. You should be taken
directly to the correct place in the Windows Display Settings.
<li>If Scaling is not at 100%, use the Arrow keys to change it.
</ol><br>
The first time you run SMB, you should get a message to install an add-on
(for NVDA) or scripts (for JAWS). These help with reading in the document
areas.<br><br>
<h1><b>Quick reminder about MusicXML</b></h1><br><br>
MusicXML is a computer format for representing musical scores. You can
create MusicXML from a music notation program, such as exporting from
MuseScore, or you can download MusicXML from various websites, such as
musescore.com. If you download from a website, it’s always a good idea
to check the quality of the music in a notation program first.<br><br>
Once you have MusicXML, you can import it into SMB to translate it into
braille.<br><br>
<h1><b>The basic process</b></h1><br><br>
Assuming everything is all ready and the settings in SMB are all set
correctly, the basic process to convert MusicXML into braille is:
<ol>
<li>Create a new file (Ctrl + N).
<li>Insert the MusicXML (Alt + F11).
<li>Translate (Ctrl + T).
</ol><br>
All these commands are also on the menus in SMB.<br><br>
It’s always best to check through the resulting braille, then finally
you can save it, for example in BRF format to read on a refreshable
braille display, or emboss it, if you have a connected embosser. To save,
use the Save As command on the File menu, choose BRF as the file type. To
emboss, use the Print command, again on the File menu.<br><br>
The conversion process is similar if you’re using the online web
version of SMB:
<ol>
<li>Go to
<a href="https://saomaicenter.org/en/smsoft/smb-online">
https://saomaicenter.org/en/smsoft/smb-online</a>.
<li>Upload your MusicXML with the select file button.
<li>Check the translation options.
<li>Translate and download the braille.
</ol><br>
Now, we’ll look at some of the options in the SMB app.<br><br>
<h1><b>Adding text</b></h1><br><br>
SMB will translate any text in your MusicXML file, such as the title and
composer information of the piece. Sometimes however, this information is
missing, or you may want to add something. Here’s one way how to add
extra text:<br><br>
Before translation, simply write your text, then apply any styles or
formatting as needed, for example Ctrl + E will centre text.<br><br>
If you’d prefer to add braille, you can do that too, after translation.
use six-key entry on your computer keyboard.<br><br>
<h1><b>Settings and options</b></h1><br><br>
<br>
<h2><b>SMB options</b></h2><br><br>
It’s always a good idea to check the options to make sure everything is
as you expect. Below, we’ll cover just some of the options, as they
relate to music.<br><br>
You can call up the SMB options with the Options command in the Tools
menu. The dialog contains several pages of options.<br><br>
Remember: any options you change will take effect the next time you
translate a document.<br><br>
<h2><b>Embosser settings</b></h2><br><br>
Even if you do not have an embosser, it is important to make sure the
braille page size is correct.<br><br>
Most important is the characters per line (CPL). Set it to the correct
line length. The lines per page (LPP) then sets the page length.<br><br>
There are equivalent settings in the online version and these should be
set the same way.<br><br>
If you plan to emboss, check through the rest of the options, such as
selecting the model of embosser, which Windows printer driver is used,
the margins and so on.<br><br>
<h2><b>Translation tables options</b></h2><br><br>
This page lets you set which braille code to use for text. Make sure the
default is set correctly, for example it is the right language and grade
of braille that you want. If it is not, use the Browse button to change:
select the right options in the dialog and press OK.<br><br>
The longer list of tables determines which tables are available for other
languages in a document.<br><br>
At the bottom of this page are options for the “Braille encoding”.
Without getting into too much detail, if you are in an English-speaking
country and want to read BRF files, set these options to ASCII and North
American encoding.<br><br>
<h2><b>Music options</b></h2><br><br>
The music options are shown in several subpages in the Options dialog.
Here are a few of the most common options. Note: many of these options
assume a certain knowledge of music and braille music in particular. If
you are unsure, check with a local blindness organisation or braille
music expert.
<ul>
<li>Format page, Format type: selects one of the main different layouts
for braille music. Bar-over-bar is used in English-speaking countries,
Section-by-section is used in several European countries.
<li>Format page, Transcription mode: Single part will produce each part
separately (for each individual player); Orchestra and Chamber will
produce all parts together (as an ensemble).
<li>Format page, Always mark octave at first note of measure: in some
countries each bar of braille music has an octave sign, others only show
the octave at the start of each line of music (called a “parallel”).
<li>Format page, Show line number, and Show page number: whether to show
where each page and line of the original print music starts. useful if
you need to refer back to the print.
<li>Transcription page, Show/hide signs: this list contains a variety of
musical symbols which you may or may not want to appear in the braille.
If you’re just starting out, you may want to turn things off so you can
just read notes. A more experienced braille music reader will want all
the signs but note that we do not normally shoow print clef signs.
<li>Transcription page, Use bracket slur: there are two ways to show a
series of slurred notes in braille music. Choose the option that reflects
braille music in your country. In English-speaking countries, bracket
slurs are used, except in vocal music.
<li>Transcription page, Restate slur/tie in new parallel: when starting a
new braille line, some countries restate a slur or tie sign if the last
note on the previous line was tied or slurred.
<li>Transcription page, Doubling: in braille music when a lot of notes
have the same property (such as staccato or each with the same interval),
the braille music sign is written twice with the first note, once on the
last note, and not shown for all the notes in-between. It’s a way to
save some space. The Doubling options control which braille music signs
use this technique.
<li>Transcription page, Braille repeats, Backward numeral repeat and
Measure number repeats: these are ways in braille music to show if bars
of music are repeated. They may or may not be used according to your
country’s conventions.
</ul><br>
There are many more music options and sometimes the effect is subtle. Be
sure to check with local braille music users if you are unsure.<br><br>
Remember, if you make changes to the settings, close the braille window
(Ctrl + F4) and retranslate the piece (Ctrl + T) to see the
effect.<br><br>
<h2><b>Profiles</b></h2><br><br>
Different kinds of music, and different people may need different SMB
music options, so SMB has a Profiles function where you can quickly load
and save the settings for a particular kind of music.<br><br>
SMB comes with several profiles and the Add profiles button lets you add
seeveral more.<br><br>
Let’s assume a student is just starting to learn braille music. The
student doesn’t need lots of complicated signs, and it would help if
every bar started with an octave sign.<br><br>
First, change the options in the Format and Translation page as needed.
Then, in the Profiles page, type in a description and a name for the
profile. Now, press the Save as profile button.<br><br>
Now, whenever you want to produce braille music with settings appropriate
for this student, just select the profile from the list and press the
Load profile button to activate the settings.<br><br>
<h2><b>The Score info dialog</b></h2><br><br>
The Score info dialog is particularly useful for extracting individual
parts and for customising orchestral and ensemble scores. For example,
you can use the Score info dialog to select the specific parts you want,
and to customise the braille instrument names used throughout the score.
<ol>
<li>Import the score as usual, but at this stage, don’t translate.
<li>Navigate onto the music object.
<li>Open the Score info dialog from the Tools menu, or press Alt +
Enter.
</ol><br>
The top of this dialog shows the title, composer and other text
information that will appear at the top of the braille score.<br><br>
<a href="??">Next, there is a list of parts with checkboxes. Check the
parts that you want to braille. Uncheck those you don’t want to
appear.</a><br><br>
Beneath this, there are some tabs if to need to fine-tune the braille
even further, such as setting the instrument prefixes.<br><br>
When you have finished, Save and Close the dialog. Then translate in the
usual way.<br><br>
<h1><b>Music navigation mode</b></h1><br><br>
Another interesting music feature in SMB is the music navigation mode.
<ol>
<li>Import your score as usual, but at this stage, don’t translate.
<li>Navigate onto the music object.
<li>From the View menu, select Navigation mode, or press Shift + F5.
</ol><br>
A window opens allowing you to navigate through the individual musical
elements in the score. Use the Left and Right Arrow keys to move through
note by note, Ctrl + Left and Right to move from bar to bar, and Up and
Down to move through each instrument.<br><br>
<h1><b>More information and help</b></h1><br><br>
We’ve only covered the basics in this session. SMB has many more
features and functions and your primary source of information is the
manual, accessed through the Help menu or F1 from the main screen.
Remember to treat it as a reference book, so use search commands or the
Contents to find information on the specific topic you’re interested
in.<br><br>
Many of the dialogs in SMB also have context sensitive help: you can
press F1 to find out information on the currently focused control.
<br><br>
Finally, if you need support, you can email
<a href="mailto:support@saomaicenter.org">support@saomaicenter.org</a>,
or subscribe to the SMB email discussion list at
groups.io/g/smcb.<br><br>
More information, including social media channels, is available at the
end of the reference manual.<br><br>
The post
<a href="https://soundwithoutsight.org/handout-braille-music-translation-using-sao-mai-braille-smb/">
Handout: braille music translation using Sao Mai Braille (SMB)</a> first
appeared on <a href="https://soundwithoutsight.org">Sound Without
Sight</a>.<br><br>
<a href="https://soundwithoutsight.org/handout-braille-music-translation-using-sao-mai-braille-smb/" eudora="autourl">
https://soundwithoutsight.org/handout-braille-music-translation-using-sao-mai-braille-smb/</a>
<br>
</blockquote></body>
</html>