Classes

Maintains the active SoundFont patch being used for sound generation. There should only ever be one instance of this class, but this is not enforced.

Manager for posting alerts to the user. The plumbing guarantees that only one alert will happen at a time – others will queue until it is their turn to be shown. Although this works, there is the risk of annoying the user with a crapload of alerts because of some catastrophic failure.

Collection of UIViewControllers and protocol facades which helps establish inter-controller relationships during the application launch. Each view controller is responsible for establishing the connections in their establishConnections method. The goal should be to have relations between a controller and protocols / facades, and not between controllers themselves. This is enforced here through access restrictions to known controllers.

Undocumented

Undocumented

Undocumented

Undocumented

Undocumented

Undocumented

Undocumented

Undocumented

Definition of the Core Data managed sound font entities.

Undocumented

Customized NSPersistentContainer that knows how to locate and load the managed object model (MOM) resource. It then caches this value for future use – basically useful for unit tests.

Undocumented

A data source for a UITableView that relies on a NSFetchedResultsController for model values. This design was heavily based on code from obj.io Core Data book.

View controller for the effects controls view. Much of this functionality is duplicated in the AUv3 effects components.

A tag is just a unique name that can be associated with zero or more sound fonts. By default there is an ‘all’ tag which matches all sound fonts, and a ‘built-in’ tag that shows just those that come with the app.

Specialization of UICollectionViewCell that knows how to render Favorite attributes.

Provides an editing facility for presets and favorites instances.

Manages the movement of a Favorite cells in a UICollectionView

Manages the view of Favorite items. Users can choose a Favorite by tapping it in order to apply the Favorite settings. The user may long-touch on a Favorite to move it around. Double-tapping on it will open the editor.

A custom setting with a SoundFont patch and a keyboard configuration.

Collection of Favorite instances created by the user.

Manages the collection of Favorite instances created by the user. Changes to the collection are saved, and they will be restored when the app relaunches.

Undocumented

Undocumented

Manager of the strip informational strip between the keyboard and the SoundFont patches / favorites screens. Supports left/right swipes to switch the upper view, and two-finger left/right pan to adjust the keyboard range.

Visual representation of a piano key. Each key has an associated Note value which determines what MIDI note the key will emit when touched.

Controller for the keyboard view. Creates the individual Key views and handles touch event detection within them. The controller creates an entire 108 keyboard which it then shows only a part of on the screen. The keyboard can be shifted up/down by octaves or by sliding via touch (if enabled).

Undocumented

A bookmark represents a file located outside of the app’s own storage space. It is used to reference sound font files without making a copy of them. However there are risks involved, namely that the bookmark may not resolve to a real file.

Undocumented

Holds reference to ConsolidatedConfigFile and monitors it for changes to its restored attribute. When it changes to true, calls the closure which was given during construction.

Undocumented

Delay audio effect by way of Apple’s AVAudioUnitDelay component.

Representation of a patch in a sound font.

Representation of a sound font library. NOTE: all sound font files must have ‘sf2’ extension.

Collection of SoundFont entities. The collection maintains a mapping between a SoundFont.Key (UUID) and a SoundFont instance. It also maintains an array of SoundFont.Key values that are ordered by SoundFont.name values.

Manages a collection of SoundFont instances. Changes to the collection are communicated as a SoundFontsEvent event.

Undocumented

Undocumented

Reverberation audio effect by way of Apple’s AVAudioUnitReverb component.

This class encapsulates Apple’s AVAudioUnitSampler in order to load MIDI sound bank.

Collection of Tag instances.

Manager for the tag collection.

Undocumented

Manages window showing various runtime settings and options.

Tracks and manages the active tag.

Provides an editing facility for SoundFont meta-data and tags.

Data source and delegate for the SoundFont UITableView. This view shows all of the names of the SoundFont files that are available in the app.

View controller for the UITableView showing the presets of a sound font

Data source and delegate for the Patches UITableView. This is one of the most complicated managers and it should be broken up into smaller components. There are three four areas of functionality:

• table view drawing and selecting
• row visibility editing
• searching
• row swiping

View controller for the SoundFont / Patches UITableView combination. Much of the UITableView management is handled by specific *Manager classes. This controller mainly serves to manage the active Patch state, plus the switching between normal Patch table view display and Patch search results display. Apart from the adopted protocols, there is no API for this class.

Specialization of UITableViewCell that will display a SoundFont name, a Preset name, or a Tag name. Probably better would be to separate these into distinct classes, but this works for now.

Manages the table view that appears off of the preset editor. Allows full editing of the tags collection.

Top-level view controller for the application. It contains the Sampler which will emit sounds based on what keys are touched. It also starts the audio engine when the application becomes active, and stops it when the application goes to the background or stops being active.

Undocumented

Undocumented

Undocumented

Undocumented

Undocumented

Undocumented

Undocumented

Show a vertical blue gradient band to indicate the active item in a list.

Custom UIView that draws an arrow between an entry and an exit point on the border of the view.

Manages when to ask the user for an app review. Relies on SKStoreReviewController.requestReview to do the actual review prompt, but makes sure that the interval between asks is reasonable and within App Store policy.

Template class that manages an association between two objects using Objective-C API.

Derivation of TypedNotification that remembers the last post value and will use that for any register calls that happen after the post call.

Undocumented

Custom UIControl that depicts a value as a point on a circle. Changing the value is done by touching on the control and moving up to increase and down to decrease the current value. While touching, moving away from the control in either direction will increase the resolution of the touch changes, causing the value to change more slowly as vertical distance changes. Pretty much works like UISlider but with the travel path as an arc.

Visual representation of the knob is done via CoreAnimation components, namely CAShapeLayer and UIBezierPath. The diameter of the arc of the knob is defined by the min(width, height) of the view’s frame. The start and end of the arc is controlled by the startAngle and endAngle settings.

Container to place SettingKey definitions (as class members)

Template class that supports get/set operations for the template type. Using class here instead of struct due to the lazy initialization of the defaultValue at runtime.

Manage subscriptions to event notifications. Events can be anything but are usually defined as an enum.

Monitors the iOS keyboard appearance and manipulates a given UIScrollView to keep the content in view when the keyboard appears. Contains a slot viewToKeepVisible which when set to a UIView will cause the monitor to scroll so that the view is visible.

Typed notification definition. Template argument defines the type of a value that will be transmitted in the notification userInfo[“value”] slot. This value will be available to blocks registered to receive it

Manager of a TypedNotification registration. When the instance is no longer being held, it will automatically unregister the internal observer from future notification events.

Instances know how to slide themselves around horizontally.

Delegate for the SoundFonts app.

Manages a HUD view to show a short bit of text as an overlay on top of the existing application view.

Connects to any and all MIDI sources, processing all messages it sees. There really is no API right now. Just create an instance and set the controller (aka delegate) to receive the incoming MIDI traffic.

Top-level view controller for the application. It contains the Sampler which will emit sounds based on what keys are touched. It also starts the audio engine when the application becomes active, and stops it when the application goes to the background or stops being active.

Monitor volume setting on device and the “silence” or “mute” switch. When there is no apparent audio output, update the Keyboard and NotePlayer instances so that they can show an indication to the user.