User Manual

User Manual

 

GoldenScroller™

GoldenScroller™ transposes/renders score files written in MusicXML™ 3.0/3.1 format.

 

Fast Start

Use the android’s back button to go to the previous page. On the main page, the back button will minimize the app.

At startup, the application loads “*.xml”, “*.mxl” and “*.musicxml” files from the folders enabled on the preferences page. Files with 3.0 or 3.1 valid formats are added to the score list; the rest are discarded. If add samples on the preferences page is enabled, the score samples are also added to the list. Touch and slide to scroll the list.

Tap on an entry to show the score’s details. Touch and slide to scroll the details.

You can use Google Drive™, a browser or any app that downloads files to any shared storage folder. You could also use a USB cable or a WiFi transfer app to copy the files to the android device. Avoid special characters for the files’ names.

Select the parts to show by tapping the corresponding part’s button. Select the scrolling mode: manual or circular. In circular mode the score will advance according to the beat, it will outline the current staff line and show the beat, if these options are enabled. In manual mode you need to use touch and slide to scroll.

Touch the show button to render the score. If it fails, check the log for errors.

After the score has been drawn, use a pinch to zoom in and out. If the score is too small try changing the device’s orientation. The application keeps track of the preferences, including the zoom level, scroll mode and transposing options for the last 50 scores.

 

Local Files

Currently, the score files are only loaded from your device’s folders. For this purpose, the application needs shared storage permission. If you have problems loading scores, please, check the prefences paragraph, below. The application only stores the score preferences on the app’s data folder and only reads score files from the other folders.

With a license, you can copy scores from any folder to the musicxml folder and remove them from any folder. These options are disabled for a free license.

 

Downloading Files

An easy way to download score files is to use Opera as the android browser. You can install Opera from Google Play. To save a score, instead of opening it, press the link until the Download option appears. Once downloaded, reload the score list on the GoldenScroller’s main page. If you have a full license, the app will add the new score to the list. With a free license it will locate only one score. Use the link, below, to download samples from the “musicxml” site.

http://www.musicxml.com/music-in-musicxml/example-set

 

Main Options

refresh Reload the local score files

preferences Show the preferences

log Show the log

help Show the help page

refresh Show the license page

 

Manual Scrolling

Touch and slide to scroll. Use a pinch to zoom in and out. There are limits to the minimum and minimum zooms. The selected zoom level will be used next time the same score is rendered.

 

Circular Scrolling

During circular scrolling, the score page is updated according to the current beat. The staff lines are shown on a circular base, starting at the top. Repeats affect this order: repeated measures may appear above or below the previous measure.

Touch the play refresh button to start scrolling. Touch the location of this button to stop. The android’s back key will take you back to the details page.

If a beat option – on the details page – is selected, the beat will be shown on the page’s left bottom. If the show initial beats – on the preferences page – is enabled, initial beats will be shown during two measures before scrolling starts.

If the measure outline option – on the details page – is enabled, the current measure will be outlined.

During scrolling, tap a measure to select the next measure. Scrolling will continue from there.

A touch and slide gesture will stop scrolling. Zooming during scrolling will not stop it. In this mode, the zoom makes sure all selected parts fit on the page, so zooming could change the staff’s line height considerably.

 

Orientation Changes

This app support orientation chages. If you have problems changing the orientation, check your device’s settings to make sure it is allowed.

 

Transposing

With a free license, you’ll be able to transpose only the samples. Please, select the shopping cart icon to obtain a license. The transposing section on the details page shows the score’s original key. Slide the transposing bar to select the number of up/down semi-tones – and the new key – used to transport the score. Depending on the number of semitones there might be one or two possible new keys.

In case of two possible keys, the first toggle can be used to select the first or the second key. This is the case for the following key pairs: (C♯ or B), (D♯ or C♭) and (G♭ or F♯);. The selection applies to the score’s first key, but also to the rest of key changes.

The single accidentals option selects transposing using only single flats/sharps. This mode treats B♯ as C, C♭ as B, E♯ as F and F♭ as E.

The octave shift toggle allows three options: no octave shift, up one octave and down one octave. The transposing options are saved as part of the score preferences.

Depending on the score, the transposed result might have notes that are too high or too low. These notes are shifted one octave down or up and are drawn with a red color. This is an indication that you need to use the octave shift option or choose a different key.

Preferencespreferences

The preferences page shows the location of the folders used to load scores. The shared storage option searches for MuxicXML files in all folders.

This application needs access to the device’s storage to be able to read the score files. If you don’t see any scores, besides the samples, on the list page, proceed as follows:

– open the preferences page, which shows the read/write access to the device. If the page shows an (+r+w) indicator for the shared storage option, you should be able to load any score if you have a license and one score with a free licence.

– If the page shows an (-r-w) indicator associated for this option or the “shared storage: not available” message, you need to allow storage access to this application. Open the android’s Settings/Device/Apps/GoldenScroller/Permissions/Storage and slide the button to allow storage access. Note: this option is not available for older android versions. After granting access go to setting previous page, select “force stop” and restart the app.

If the show initial beats is enabled, initial beats will be shown during two measures before scrolling starts.

The show pop-up messages option, enables/disables the application warning messages.

The select concert or instrument pitch option enables showing the score using the instrument pitch. In this case, the musicXml file needs to provide <transpose> and <diatonic> elements for the corresponding part to obtain the real key. If the original score includes these element, you’ll be able to show the score in the instrument key or in the concert key. Please, check our web-page for more information.

Independently of your default language you may use the note’s name option to select the key’s names on the “details” page. The options supported are: Latin (Do, Re,…), English (C,D…), German(C,D…H) and Sanskrit (Sa, Re,…).

The outline color options selects the background color for the outline option.

Copying Filescopying files

The details page provides menu options to copy files copying files to the musicxml folder and to delete deletethem. You need a license to enable these options.

 

Loglog

The log shows the device configuration, its metrics, the location of the local folders and parsing results. After loading the score files, the log shows the results of parsing the headers. The log is cleared before a new score is parsed. If score parsing fails, please, check this page for errors and warnings.

The debug log button log shows errors or warnings issued by the application.

Shopping Cartlog

This button will bring up the license page, where you can verify your current license. The Google Play button google drive will take you to the Google Play store where you can purchase a license. There is just one single license and it will enabled all the app’s features. This app doesn’t get any information about your credit card information.

Copyright and License Agreement

This End User license is provided with this application and applies to the software, the documentation, the sample files provided with it and any additional documentation and upgrades. This software is a 2015 copyright of DornaSoft LLC. You may not copy or sell it but you may share this evaluation copy of the software assuming you don’t make any modifications and include this License Agreement. You may not modify, adapt, translate, reverse engineer, decompile, dissamble or any other way used to discover the source code of the software.

 

Limited Warranty

In no event will the Software Publisher be liable for indirect, special, incidental, tort, economic, cover or consequential damages arising from the use or the inabibility to use the Software.

 

Trademarks

MusicXML is a trademark of MakeMusic, Inc. Google Play is a trademark of Google Inc. GoldenScroller is a trademark of DornaSoft LLC.


 

(Visited 450 times, 1 visits today)