Home pageMusic Notation SDKMIDI TutorialMusic Data Structures

Download The Music Application Examples of the Music SDK

This application presents a few examples of what can be integrated into a program by using the MNL Software development kit level I and II.

Example 1 can be implemented with the SDK level I and the other four examples need the SDK level II.

Click here to download the music application examples now...

Here is an illustration and description of the examples included in this application.

The main window displays 5 buttons to run 5 different music application examples. The interface has been kept very simple and is only intended to show how the SDK works. In the window, there are 3 elements drawn directly by the SDK: the music keyboard, the guitar fret board and the score area.

The buttons are simply drawn by the music application examples, as simple rectangles where the user can click to make the program work.

Example 1

This music application example can be implemented with the SDK level I, as it only deals with opening music files, displaying them, transposing them and playing them. The only exception is that level I of the SDK does not permit the user to click on the keyboard or fret board.

When launching the application or by switching back to example 1, the main part of the window displays the first page of a score of Bach (Invention number 1, two voices).

The buttons are:

  • Play: the score starts playing. Notes are highlighted as they are played and also shown on the music keyboard and guitar fret board. The playback starts at the first visible measure.
  • Tempo: you can click in that area to define the tempo used to play the music, between 1 and 299 beats per minute.
  • Open...: calls a standard dialog to open a file. Three kind of files can be used. Standard Midi files (extension ".mid"), standard MusicXML files (extension ".xml") or Pizzicato files, a format that contains all information about a music document (extension ".piz"). With the license of the SDK, you receive the professional version of Pizzicato (a general purpose music software from which this SDK has been derived) so that you can in fact prepare music example files that you can use with your application.
  • Zoom- / Zoom+: decrease/increase the scale to display the music content.
  • << / >>: Displays the previous page or measure / next page or measure.
  • Page: there are three display modes (page, linear, wrap). This buttons calls the page view, which is the way the page would be printed on paper or exported to a PDF file.
  • Linear: In this mode, all measures of the staves are displayed horizontally on one line only.
  • Wrap: In this mode, the display is optimized in real time to fit most the size of the graphic area available.
  • Trans Down/Trans Up: Used to transpose the score step by step, by semitones. The key signature is automatically adapted.

Example 2

This music application example shows a simple way to let the user enter music by himself. An empty score is shown, with 6 measures. A red circle is visible where the music will be entered. The buttons are:

  • G clef / F clef: you can decide which clef is used to display the music. If the measures already have notes in them, the music is transposed accordingly.
  • +1# / +1b: you can modify the key signature by adding one sharp or one flat to it. The key signature is adapted in the score. Notice that the playback of existing notes will stay the same, as accidentals will be placed automatically to keep the same notes.
  • 2/4, 3/4, 4/4, 6/8: you can change the time signature of the score. However, the example does not check if the content of existing measures is longer than the one of the new time signature.
  • Transp. + / Transp. -: The existing notes can be transposed up or down, by one semitone. Here the key signature is not modified and accidentals are used according to the transposition.
  • Delete: deletes the current or previous note, according to the position of the red circle.
  • Delete all: deletes the content of the 6 measures.
  • Chord: in this mode, the next note is added as a chord attached to the stem of the previous note.
  • C,D,E,F,G,A,B: by clicking on these buttons, a note is added at the location of the red circle, or as a chord to the previous note.
  • Oct 2/3/4: selection of the octave at which the next notes will be entered.
  • #/b: select if a sharp or flat will be assigned to the next note that will be entered. To unselect it, simply click on it again.
  • Whole/Half/Quarter/8th/16th: selects the rhythmic value of the next note to enter. You can only enter a note or rest with a rhythmic value that will fit the rhythmic value left in the measure.
  • Rest: enters a rest at the current red circle position.
  • Dotted: if this button is selected, the next rhythmic value will be dotted (value multiplied by 1.5).

In addition, you can play the resulting score, with notes highlighted and shown on the keyboard and fret board, and you can change the tempo. You can also click on a note head to place the red circle there.

Example 3

This music application example displays major and minor scales for a set of root notes. The scales are computed in the application and the score is built and displayed using the SDK interface. The buttons are:

  • Major scale / minor scale: selects the type of scale displayed.
  • Gb ==> B: selects the root note of the scale.

You can play it and see the scale on the keyboard and fretboard.

Example 4

This music application example displays the notes that form a chord. The chord symbol is displayed as well as the notes of the selected chord. The buttons are:

  • C ==> B: Root note of the chord to create.
  • #/b: Selects the accidental applied to the root note.
  • Maj, min, 7, Maj7: selects the type of chord to display.

You can play the score and see the notes on the keyboard and fret board.

Example 5

This music application example creates a simple random melody, based on the selection of rhythms and notes. The buttons are:

  • Quarter notes/Eighth notes/16th notes: select which rhythmic values are allowed in the resulting melody. At least one of them must be active to generate any music.
  • C ==> B: selects which notes may be used in the generated melody. Here also, at least one of them must be selected.
  • Octave 3/4/5: selects in which octaves the notes can be used.
  • Generate: when you click here, a new random melody is created and displayed, with the same selection of notes and rhythms.

Download the Music Application Examples

Fill in the following form and click on the Submit button and you will soon receive an email with the link to download the music application examples of the music SDK.

Please note that all fields followed by an asterisk must be filled in.
E-Mail Address*
First Name
Last Name
SDK application examples for
Mac OS X

(*) In conformity with the data protection law, you may consult or modify any information about you in our files. We guarantee that your e-mail address will be used exclusively to send you our newsletters and emails related to our products. Your e-mail address will never be communicated, sold, rented nor given to third parties. If you do not want to receive any e-mail from us, please do not fill in this form. At any moment, you keep the right to ask us to remove your address from our list. We will respect this in any circumstance. We appreciate your confidence.

Copyright 2012 - Arpege Music - Dominique Vandenneucker