wpdrumkit/release_notes.txt

Drumkit XNA 1.2
===============

Drumkit XNA is a virtual drumkit that lets you play percussion sounds by 
tapping sound pads. The application contains two views for playing, a simple
view with 2D pads and a whole 3D like drumset to play with. You can record 
your beats and play them back afterwards. It is also possible to play the 
drums on top of your last recording. The application has been developed purely
on top of XNA with Microsoft Visual Studio 2010 Express for Windows Phone and 
tested to work on Nokia Lumia 800. 

Even though XNA Framework apps cannot be compiled or upgraded to target
Windows Phone OS 8.0, XNA Game Studio 4.0 apps that target Windows Phone
OS 7.1 remain fully supported and continue to run on Windows Phone 8 devices.
Compatibility with Windows Phone 8 has been verified using Microsoft Visual
Studio Express 2012 for Windows Phone and Nokia Lumia 820 and Nokia Lumia 920 
devices.

The application has been ported from Java Drumkit example, available at  
http://www.developer.nokia.com/info/sw.nokia.com/id/1fe81968-abbf-48d1-a137-a203094611b2/MIDP_Java_Drumkit_Example_v1_0_en.zip.html 
At the same time, also a Qt version has been developed for Symbian and Nokia 
N9 devices, available at: 
http://www.developer.nokia.com/info/sw.nokia.com/id/57f87a44-0408-41c5-9d60-e2491d6793fb/Drumkit.html

This example application is hosted in Nokia Developer Projects:
- http://projects.developer.nokia.com/wpdrumkit

For more information on implementation and porting, visit the wiki pages:
- http://projects.developer.nokia.com/wpdrumkit/wiki


What's new
----------

Version 1.2: Removed dependency to Nokia Pure Text font


1. Usage
-------------------------------------------------------------------------------

This is a simple build-and-run solution. Build, run, and start drumming. 


2. Prerequisites
-------------------------------------------------------------------------------

- C# basics
- Microsoft Visual Studio 2010 Express for Windows Phone


3. Project structure and implementation
-------------------------------------------------------------------------------

3.1 Folders
-----------

 |                  The root folder contains the project file, the license 
 |                  information and this file (release_notes.txt).
 |
 |- WPDrumkit         Root folder for the implementation files.  
 |  |
 |  |- Properties     Application property files.
 |
 |- WPDrumkitContent  Root folder for the application content, font file.  
 |  |
 |  |- Audio          Audio files.
 |  |
 |  |- Images         Root folder for images, background & splash screen.
 |     |
 |     |- Buttons     Button graphics
 |     |
 |     |- Drumset     Drumset graphics
 |     |
 |     |- Menu        Menu graphics
 |     |

3.2 Important files and classes
-------------------------------

| File                           | Description                                |
|--------------------------------|--------------------------------------------|
| PadView.cs                     | Class that controls the functionality of   |
|                                | pad view.                                  |
|--------------------------------|--------------------------------------------|
| DrumsetView.cs                 | Class that controls the functionality of   |
|                                | drumset view.                              |
|--------------------------------|--------------------------------------------|
| Pad.cs                         | Class responsible of playing the sounds.   |
|                                |                                            |
|--------------------------------|--------------------------------------------|
| Recorder.cs                    | Records the drum strokes.                  |
|                                |                                            |
|--------------------------------|--------------------------------------------|

3.3 Used APIs/Windows Phone Components
--------------------------------------

Microsoft.Xna.Framework;
Microsoft.Xna.Framework.Audio.SoundEffect
Microsoft.Xna.Framework.Content;
Microsoft.Xna.Framework.Graphics;
Microsoft.Xna.Framework.Input.Touch;


4. Compatibility
-------------------------------------------------------------------------------

- Windows Phone 7
- Windows Phone 8

Tested on:
- Nokia Lumia 800
- Nokia Lumia 820
- Nokia Lumia 920

Developed with Microsoft Visual Studio Express for Windows Phone 2010/2012.

4.1 Required Capabilities
-------------------------

None


4.2 Known Issues
----------------

None.


5. Building, installing, and running the application
-------------------------------------------------------------------------------

5.1 Preparations
----------------

Make sure you have the following installed:
 * Windows 7, may also work on Windows XP
 * Microsoft Visual Studio 2010 Express for Windows Phone
 * The Windows Phone Developer Tools January 2011 Update:
   http://download.microsoft.com/download/6/D/6/6D66958D-891B-4C0E-BC32-2DFC41917B11/WindowsPhoneDeveloperResources_en-US_Patch1.msp
 * Windows Phone Developer Tools Fix:
   http://download.microsoft.com/download/6/D/6/6D66958D-891B-4C0E-BC32-2DFC41917B11/VS10-KB2486994-x86.exe

 * Compatibility with Windows 8 and Microsoft Visual Studio Express 2012 for 
   Windows Phone has been verified

5.2 Using the WINDOWS PHONE SDK
-------------------------------

1. Open the SLN file:
   File > Open Project, select the file WPDrumkit.sln
2. Select the target, for example 'Windows Phone 7 Emulator'.
3. Press F5 to build the project and run it on the Windows Phone Emulator.

5.3 Deploy to Windows Phone 7 & 8
---------------------------------

Please see official documentation for deploying and testing applications on
Windows Phone devices:
http://msdn.microsoft.com/en-us/library/gg588378%28v=vs.92%29.aspx


6. License
-------------------------------------------------------------------------------

See the license text file delivered with this project. The license file is also
available online at
http://projects.developer.nokia.com/mapexplorer/browser/trunk/Licence.txt


7. Related documentation
-------------------------------------------------------------------------------

Learn About Windows Phone Development:
http://msdn.microsoft.com/en-us/ff380145

Windows Phone Dev Center:
http://dev.windowsphone.com/en-us


8. Version history
-------------------------------------------------------------------------------

1.2.0 Removed dependency to Nokia Pure Text font
1.1.0 First publication at developer.nokia.com based on 1.0.1 release
1.0.1 Refactoring, comments and some minor bug fixes
1.0.0 First version with both pad view and drumset view
0.2.0 Pad view