Introduction
While I was looking around on PInvoke.net[^] for a particular API, I noticed a function called Beep, and I had a sudden wave of nostalgia about when I first started programming on a ZX Spectrum back in 1983.
What I decided to do was to create a program that uses the Beep API function and plays music in a similar way to the ZX Spectrum. However, due to the power of the .NET Framework, I decided to have some more fun with XML Serialization at the same time.
The aim of this article is just for fun, which explains the bad jokes throughout. I'm not trying to explain XML Serialization (although you might pick up some ideas if you are new to it) or the Beep function, especially as there is not very much to it.
Beep
Firstly, the Beep API function will not play beautiful music on Windows 95, 98 or ME, it will just beep monotonously for a preset amount of time or, if there is a sound card, it will play the default sound. That's it. �Nada m�s! If you are running any of these operating systems, the parameters are ignored, and this article won't be of any use, and can safely be printed out, put through a shredder, and used as bedding for your pet hampster.
The function won't beep in the background as it operates synchronously, just like my old ZX Spectrum. So, if you call it and set the duration to 30,000 milliseconds then you will have to wait for half a minute for the application to respond again.
It will output onto the PC Speaker a range of frequencies from 37Hz to 32767Hz, so you might be able to write an application for calling your pet dog by using some of the upper frequencies. Unfortunately, my pet dog died almost 3 years ago, so I cannot test this hypothesis. He was almost 15 at the time and had been deaf for quite a while, so I suppose even if he was still alive now, I wouldn't have been able to test that.
The Beep method is not currently available in .NET, however it is supposed to be available with .NET 2.0. In the mean time, to use the API function, a little bit of P/Invoking is required.
[DllImport("kernel32.dll")]
private static extern bool Beep(uint dwFreq, uint dwDuration);
Representation of a Song
The sample application is quite simple. It opens an XML file that contains a song. The schema is quite simple, and it should be quite easy for anyone with a rudimentary knowledge of music to create a file with a song in it.
An example of a file with the the Scale of C Major.
<Song Tempo="60">
<Notes>
<Note Duration="Quarter" Pitch="C" Octave="4" />
<Note Duration="Quarter" Pitch="D" Octave="4" />
<Note Duration="Quarter" Pitch="E" Octave="4" />
<Note Duration="Quarter" Pitch="F" Octave="4" />
<Note Duration="Quarter" Pitch="G" Octave="4" />
<Note Duration="Quarter" Pitch="A" Octave="4" />
<Note Duration="Quarter" Pitch="B" Octave="4" />
<Note Duration="Quarter" Pitch="C" Octave="5" />
</Notes>
</Song>
The Song element contains an attribute defining the Tempo in beats per minute. A quarter note is equal to one beat.
The Song contains a Notes element, which in turn contains each of the individual Note elements. Each Note defines the length and pitch, although the pitch is actually calculated by using the Pitch and Octave attributes.
An interesting thing about musical notes is that for each octave increase, the frequency doubles. This means that the enumeration that holds all the frequencies only needs to do so for one octave. In this case, the frequencies for octave 7 are used because then the program can divide to get to the correct frequency, and there is no strained notes due to rounding errors being multiplied up.
The User Interface
For the purposes of an easy demonstration, I have put together a simple user interface in order to allow you to create your own songs. You can use the tool bar buttons or the menu to create your masterpieces.
The File menu is the standard open/save/exit combination. The program takes files with a .song extension. Actually, it will accept anything so long as the contents match the expected XML schema.
The Note menu allows you to define each note, and the sequence of notes.
The last menu, the Play menu, permits you to play the sound. Remember that it will come from the PC Speaker and that you won't be able to interact with the application while it is running.
At the bottom of the window is a slider that adjusts so you can set the tempo of the song. The range is 30 beats per minute on the left to 180 beats per minute on the right.
Finally, in the centre of the window is the list of notes that are played. In the first column is the duration, and the second column contains the pitch.
There are shortcut keys to help you operate the application faster and these can be found on the menus.
More Information
Class documentation is available in the source zip. This was generated using NDoc[^] 1.3 beta 1.
Some sample song files are available in the demo zip. These include the scale of C Major and Ode to Joy.
For more details about the elements of this project, the following links may be useful:
History
- Version 1.0: A small bit of fun.
- Version 1.01: Some bug fixes and NDoc help file included.
