MusicKit
0.0.0
|
A MKSynthPatch contains a configuration of MKUnitGenerators that work as a sound synthesis module. More...
#include <MKSynthPatch.h>
A MKSynthPatch contains a configuration of MKUnitGenerators that work as a sound synthesis module.
MKSynthPatches are not created by the application; rather, they're created by the MKOrchestra. The MKOrchestra is also responsible for filling the MKSynthPatch instance with MKUnitGenerator and MKSynthData instances. It does this on the basis of a template provided by the MKSynthPatch class method patchTemplate. You implement this method in a subclass of MKSynthPatch to provide a MKPatchTemplate that specifies the mix of MKUnitGenerators and MKSynthData objects, in what order they're allocated, and how to connect them.
Typically, a MKSynthPatch is owned and operated by a MKSynthInstrument object. The MKSynthInstrument manages the allocation of MKSynthPatches in response to incoming MKNotes. Alternatively, MKSynthPatches may be used in a stand-alone fashion. In this case, you must allocate the objects by sending the MKOrchestra an allocSynthPatch: or allocSynthPatch:patchTemplate: message.
While in performance, a MKSynthPatch is identified by the noteTag of the MKNote stream that it's synthesizing.