### Metronome ###

===========================================================================

DESCRIPTION:

Metronome sample application demonstrates how to animate a rotation, interpret touch events, and display a simple application preferences view. Open the Metronome project in Xcode and build and run it. To run in the simulator, set the Active SDK to Simulator. To run on a device, set the Active SDK to the appropriate Device setting.

The metronome presents a simple interface. Drag the arm horizontally to start the arm. Tap to stop. Drag the arm vertically to change the tempo. Tap the "i" button to access application preferences.

===========================================================================

BUILD REQUIREMENTS:

iOS 4.0 SDK

===========================================================================

RUNTIME REQUIREMENTS:

iPhone OS 3.2 or later

===========================================================================

PACKAGING LIST:

MetronomeAppDelegate.h

MetronomeAppDelegate.m

UIApplication's delegate. On start up, this object receives the applicationDidFinishLaunching: delegate message and creates an instance of MetronomeViewController and installs its view (the front side of the application) as a subview of the application's window. The MetronomeAppDelegate is also in charge of saving and restoring the user's time signature preference in user defaults.

MetronomeViewController.h

MetronomeViewController.m

Creates and controls the Metronome view.

MetronomeView.h

MetronomeView.m

This view builds the primary application UI. It also implements the touches... methods that respond to user interaction with that display. MetronomeView animates the swing of the arm and updates that animation to reflect changes in tempo, time signature, and sound settings.

PreferencesViewController.h

PreferencesViewController.m

Controls the Preferences View, which is loaded from PreferencesView.nib. In preferences, you can set the sound volume and time signature preferences.

SoundEffect.h

SoundEffect.m

A simple Objective-C wrapper around Audio Services functions that allow the loading and playing of sound files. 

MainWindow.xib

Interface Builder 'nib' file that provides the window for the application.

PreferencesView.xib

Nib file that provides the view for the preferences side of the application.

===========================================================================

CHANGES FROM PREVIOUS VERSIONS:

Version 2.5

- Upgraded project to build with the iOS 4.0 SDK.

Version 2.2

- Added invocation of prepareToPlay after configuring audio players.

Version 2.1

- Corrected a minor display artifact.

Version 2.0

- Updated for and tested with iPhone OS 3.0.

Version 1.7

- Updated for and tested with iPhone OS 2.0. First public release.

Version 1.6

- Updated for Beta 7.

- Made nib files localizable

- Fixed a problem that made it difficult at times for the 'i' button to register touches.

Version 1.5

- Updated for Beta 6.

- Added LSRequiresIPhoneOS setting to Info.plist

- Time signature tableview now shows selected time signature using a check mark (UITableViewCellAccessoryCheckmark)

Version 1.4

- Updated for Beta 5. 

- Converted sample to use Xcode's Cocoa Touch Utility project template.

Version 1.3

- Updated for Beta 4. 

- For sound playback, replaced AudioFX class with simpler SoundEffect class.

Version 1.2

- Updated for Beta 3. 

- Replaced the ReadMe file with a plain text version.

Version 1.1:

- Improved artwork

- Improved handling of user preferences

- Simplified loading of sound files

- 'Tock' sound now occurs on first beat of measure

- Much improved vertical and horizontal dragging behavior. 

- Simplified code that supports dragging behavior.

- Improved implementation of sound thread.

- General code clean-up

===========================================================================

Copyright (C) 2008-2010 Apple Inc. All rights reserved.