topical media & game development
lib-of-vs-libs-QTDevWin-CIncludes-QuickTimeMusic.h / h
/*
File: QuickTimeMusic.h
Contains: QuickTime Interfaces.
Version: Technology: QuickTime 6.0
Release: QuickTime 6.0.2
Copyright: (c) 1990-2001 by Apple Computer, Inc., all rights reserved
Bugs?: For bug reports, consult the following page on
the World Wide Web:
http://developer.apple.com/bugreporter/
*/
ifndef __QUICKTIMEMUSIC__
define __QUICKTIMEMUSIC__
ifndef __COMPONENTS__
include <Components.h>
endif
ifndef __IMAGECOMPRESSION__
include <ImageCompression.h>
endif
ifndef __MOVIES__
include <Movies.h>
endif
ifndef __QUICKDRAW__
include <Quickdraw.h>
endif
ifndef __VIDEO__
include <Video.h>
endif
ifndef __MACMEMORY__
include <MacMemory.h>
endif
ifndef __SOUND__
include <Sound.h>
endif
ifndef __ENDIAN__
include <Endian.h>
endif
if PRAGMA_ONCE
#pragma once
endif
ifdef __cplusplus
extern "C" {
endif
if PRAGMA_IMPORT
#pragma import on
endif
if PRAGMA_STRUCT_ALIGN
#pragma options align=mac68k
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
#pragma pack(2)
endif
enum {
kaiToneDescType = FOUR_CHAR_CODE('tone'),
kaiNoteRequestInfoType = FOUR_CHAR_CODE('ntrq'),
kaiKnobListType = FOUR_CHAR_CODE('knbl'),
kaiKeyRangeInfoType = FOUR_CHAR_CODE('sinf'),
kaiSampleDescType = FOUR_CHAR_CODE('sdsc'),
kaiSampleInfoType = FOUR_CHAR_CODE('smin'),
kaiSampleDataType = FOUR_CHAR_CODE('sdat'),
kaiSampleDataQUIDType = FOUR_CHAR_CODE('quid'),
kaiInstInfoType = FOUR_CHAR_CODE('iinf'),
kaiPictType = FOUR_CHAR_CODE('pict'),
kaiWriterType = FOUR_CHAR_CODE('©wrt'),
kaiCopyrightType = FOUR_CHAR_CODE('©cpy'),
kaiOtherStrType = FOUR_CHAR_CODE('str '),
kaiInstrumentRefType = FOUR_CHAR_CODE('iref'),
kaiInstGMQualityType = FOUR_CHAR_CODE('qual'),
kaiLibraryInfoType = FOUR_CHAR_CODE('linf'),
kaiLibraryDescType = FOUR_CHAR_CODE('ldsc')
};
struct InstLibDescRec {
Str31 libIDName;
};
typedef struct InstLibDescRec InstLibDescRec;
struct InstKnobRec {
BigEndianLong number;
BigEndianLong value;
};
typedef struct InstKnobRec InstKnobRec;
enum {
kInstKnobMissingUnknown = 0,
kInstKnobMissingDefault = (1 << 0)
};
struct InstKnobList {
BigEndianLong knobCount;
BigEndianLong knobFlags;
InstKnobRec knob[1];
};
typedef struct InstKnobList InstKnobList;
enum {
kMusicLoopTypeNormal = 0,
kMusicLoopTypePalindrome = 1 /* back & forth*/
};
enum {
instSamplePreProcessFlag = 1 << 0
};
struct InstSampleDescRec {
BigEndianOSType dataFormat;
BigEndianShort numChannels;
BigEndianShort sampleSize;
BigEndianUnsignedFixed sampleRate;
BigEndianShort sampleDataID;
BigEndianLong offset; /* offset within SampleData - this could be just for internal use*/
BigEndianLong numSamples; /* this could also just be for internal use, we'll see*/
BigEndianLong loopType;
BigEndianLong loopStart;
BigEndianLong loopEnd;
BigEndianLong pitchNormal;
BigEndianLong pitchLow;
BigEndianLong pitchHigh;
};
typedef struct InstSampleDescRec InstSampleDescRec;
typedef Handle AtomicInstrument;
typedef Ptr AtomicInstrumentPtr;
enum {
kQTMIDIComponentType = FOUR_CHAR_CODE('midi')
};
enum {
kOMSComponentSubType = FOUR_CHAR_CODE('OMS '),
kFMSComponentSubType = FOUR_CHAR_CODE('FMS '),
kMIDIManagerComponentSubType = FOUR_CHAR_CODE('mmgr'),
kOSXMIDIComponentSubType = FOUR_CHAR_CODE('osxm')
};
typedef ComponentInstance QTMIDIComponent;
enum {
kMusicPacketPortLost = 1, /* received when application loses the default input port */
kMusicPacketPortFound = 2, /* received when application gets it back out from under someone else's claim */
kMusicPacketTimeGap = 3 /* data[0] = number of milliseconds to keep the MIDI line silent */
};
enum {
kAppleSysexID = 0x11, /* apple sysex is followed by 2-byte command. 0001 is the command for samplesize */
kAppleSysexCmdSampleSize = 0x0001, /* 21 bit number in 3 midi bytes follows sysex ID and 2 cmd bytes */
kAppleSysexCmdSampleBreak = 0x0002, /* specifies that the sample should break right here */
kAppleSysexCmdAtomicInstrument = 0x0010, /* contents of atomic instrument handle */
kAppleSysexCmdDeveloper = 0x7F00 /* F0 11 7F 00 ww xx yy zz ... F7 is available for non-Apple developers, where wxyz is unique app signature with 8th bit cleared, unique to developer, and 00 and 7f are reserved */
};
struct MusicMIDIPacket {
unsigned short length;
unsigned long reserved; /* if length zero, then reserved = above enum */
UInt8 data[249];
};
typedef struct MusicMIDIPacket MusicMIDIPacket;
typedef CALLBACK_API( ComponentResult , MusicMIDISendProcPtr )(ComponentInstance self, long refCon, MusicMIDIPacket *mmp);
typedef CALLBACK_API( ComponentResult , MusicMIDIReadHookProcPtr )(MusicMIDIPacket *mp, long myRefCon);
typedef STACK_UPP_TYPE(MusicMIDISendProcPtr) MusicMIDISendUPP;
typedef STACK_UPP_TYPE(MusicMIDIReadHookProcPtr) MusicMIDIReadHookUPP;
enum {
kSynthesizerConnectionFMS = 1, /* this connection imported from FMS */
kSynthesizerConnectionMMgr = 2, /* this connection imported from the MIDI Mgr */
kSynthesizerConnectionOMS = 4, /* this connection imported from OMS */
kSynthesizerConnectionQT = 8, /* this connection is a QuickTime-only port */
kSynthesizerConnectionOSXMIDI = 16, /* this connection is an OS X CoreMIDI port */
/* lowest five bits are mutually exclusive; combinations reserved for future use.*/
kSynthesizerConnectionUnavailable = 256 /* port exists, but cannot be used just now */
};
/*
The sampleBankFile field of this structure can be used to pass in a pointer to an FSSpec
that represents a SoundFont 2 or DLS file (otherwise set it to NULL ).
You then pass in a structure with this field set (all other fields should be zero) to
NARegisterMusicDevice:
- with synthType as kSoftSynthComponentSubType
- with name being used to return to the application the "name" of the synth
that should be used in the synthesiserName field of the ToneDescription structure
and is also used to retrieve a particular MusicComponent with the
NAGetRegisteredMusicDevice call
This call will create a MusicComponent of kSoftSynthComponentSubType, with the specified
sound bank as the sample data source.
*/
struct SynthesizerConnections {
OSType clientID;
OSType inputPortID; /* terminology death: this port is used to SEND to the midi synth */
OSType outputPortID; /* terminology death: this port receives from a keyboard or other control device */
long midiChannel; /* The system channel; others are configurable (or the nubus slot number) */
long flags;
long unique; /* unique id may be used instead of index, to getinfo and unregister calls */
FSSpecPtr sampleBankFile; /* see notes above */
long reserved2; /* should be zero */
};
typedef struct SynthesizerConnections SynthesizerConnections;
struct QTMIDIPort {
SynthesizerConnections portConnections;
Str63 portName;
};
typedef struct QTMIDIPort QTMIDIPort;
struct QTMIDIPortList {
short portCount;
QTMIDIPort port[1];
};
typedef struct QTMIDIPortList QTMIDIPortList;
typedef QTMIDIPortList * QTMIDIPortListPtr;
typedef QTMIDIPortListPtr * QTMIDIPortListHandle;
EXTERN_API( ComponentResult )
QTMIDIGetMIDIPorts (QTMIDIComponent ci,
QTMIDIPortListHandle * inputPorts,
QTMIDIPortListHandle * outputPorts) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0001, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
QTMIDIUseSendPort (QTMIDIComponent ci,
long portIndex,
long inUse) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0002, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
QTMIDISendMIDI (QTMIDIComponent ci,
long portIndex,
MusicMIDIPacket * mp) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0003, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
QTMIDIUseReceivePort (QTMIDIComponent ci,
long portIndex,
MusicMIDIReadHookUPP readHook,
long refCon) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0004, 0x7000, 0xA82A);
enum {
kMusicComponentType = FOUR_CHAR_CODE('musi'),
kInstrumentComponentType = FOUR_CHAR_CODE('inst')
};
enum {
kSoftSynthComponentSubType = FOUR_CHAR_CODE('ss '),
kGMSynthComponentSubType = FOUR_CHAR_CODE('gm ')
};
typedef ComponentInstance MusicComponent;
/* MusicSynthesizerFlags*/
enum {
kSynthesizerDynamicVoice = 1 << 0, /* can assign voices on the fly (else, polyphony is very important */
kSynthesizerUsesMIDIPort = 1 << 1, /* must be patched through MIDI Manager */
kSynthesizerMicrotone = 1 << 2, /* can play microtonal scales */
kSynthesizerHasSamples = 1 << 3, /* synthesizer has some use for sampled data */
kSynthesizerMixedDrums = 1 << 4, /* any part can play drum parts, total = instrument parts */
kSynthesizerSoftware = 1 << 5, /* implemented in main CPU software == uses cpu cycles */
kSynthesizerHardware = 1 << 6, /* is a hardware device (such as nubus, or maybe DSP?) */
kSynthesizerDynamicChannel = 1 << 7, /* can move any part to any channel or disable each part. (else we assume it lives on all channels in masks) */
kSynthesizerHogsSystemChannel = 1 << 8, /* can be channelwise dynamic, but always responds on its system channel */
kSynthesizerHasSystemChannel = 1 << 9, /* has some "system channel" notion to distinguish it from multiple instances of the same device (GM devices dont) */
kSynthesizerSlowSetPart = 1 << 10, /* SetPart() and SetPartInstrumentNumber() calls do not have rapid response, may glitch notes */
kSynthesizerOffline = 1 << 12, /* can enter an offline synthesis mode */
kSynthesizerGM = 1 << 14, /* synth is a GM device */
kSynthesizerDLS = 1 << 15, /* synth supports DLS level 1 */
kSynthesizerSoundLocalization = 1 << 16 /* synth supports extremely baroque, nonstandard, and proprietary "apple game sprockets" localization parameter set */
};
/*
* Note that these controller numbers
* are _not_ identical to the MIDI controller numbers.
* These are _signed_ 8.8 values, and the LSB's are
* always sent to a MIDI device. Controllers 32-63 are
* reserved (for MIDI, they are LSB's for 0-31, but we
* always send both).
*
* The full range, therefore, is -128.00 to 127.7f.
*
* _Excepting_ _volume_, all controls default to zero.
*
* Pitch bend is specified in fractional semitones! No
* more "pitch bend range" nonsense. You can bend as far
* as you want, any time you want.
*/
typedef SInt32 MusicController;
enum {
kControllerModulationWheel = 1,
kControllerBreath = 2,
kControllerFoot = 4,
kControllerPortamentoTime = 5, /* time in 8.8 seconds, portamento on/off is omitted, 0 time = 'off' */
kControllerVolume = 7, /* main volume control */
kControllerBalance = 8,
kControllerPan = 10, /* 0 - "default", 1 - n: positioned in output 1-n (incl fractions) */
kControllerExpression = 11, /* secondary volume control */
kControllerLever1 = 16, /* general purpose controllers */
kControllerLever2 = 17, /* general purpose controllers */
kControllerLever3 = 18, /* general purpose controllers */
kControllerLever4 = 19, /* general purpose controllers */
kControllerLever5 = 80, /* general purpose controllers */
kControllerLever6 = 81, /* general purpose controllers */
kControllerLever7 = 82, /* general purpose controllers */
kControllerLever8 = 83, /* general purpose controllers */
kControllerPitchBend = 32, /* positive & negative semitones, with 8 bits fraction, same units as transpose controllers*/
kControllerAfterTouch = 33, /* aka channel pressure */
kControllerPartTranspose = 40, /* identical to pitchbend, for overall part xpose */
kControllerTuneTranspose = 41, /* another pitchbend, for "song global" pitch offset */
kControllerPartVolume = 42, /* another volume control, passed right down from note allocator part volume */
kControllerTuneVolume = 43, /* another volume control, used for "song global" volume - since we share one synthesizer across multiple tuneplayers*/
kControllerSustain = 64, /* boolean - positive for on, 0 or negative off */
kControllerPortamento = 65, /* boolean*/
kControllerSostenuto = 66, /* boolean */
kControllerSoftPedal = 67, /* boolean */
kControllerReverb = 91,
kControllerTremolo = 92,
kControllerChorus = 93,
kControllerCeleste = 94,
kControllerPhaser = 95,
kControllerEditPart = 113, /* last 16 controllers 113-128 and above are global controllers which respond on part zero */
kControllerMasterTune = 114,
kControllerMasterTranspose = 114, /* preferred*/
kControllerMasterVolume = 115,
kControllerMasterCPULoad = 116,
kControllerMasterPolyphony = 117,
kControllerMasterFeatures = 118
};
/* ID's of knobs supported by the QuickTime Music Synthesizer built into QuickTime*/
enum {
kQTMSKnobStartID = 0x02000000,
kQTMSKnobVolumeAttackTimeID = 0x02000001,
kQTMSKnobVolumeDecayTimeID = 0x02000002,
kQTMSKnobVolumeSustainLevelID = 0x02000003,
kQTMSKnobVolumeRelease1RateID = 0x02000004,
kQTMSKnobVolumeDecayKeyScalingID = 0x02000005,
kQTMSKnobVolumeReleaseTimeID = 0x02000006,
kQTMSKnobVolumeLFODelayID = 0x02000007,
kQTMSKnobVolumeLFORampTimeID = 0x02000008,
kQTMSKnobVolumeLFOPeriodID = 0x02000009,
kQTMSKnobVolumeLFOShapeID = 0x0200000A,
kQTMSKnobVolumeLFODepthID = 0x0200000B,
kQTMSKnobVolumeOverallID = 0x0200000C,
kQTMSKnobVolumeVelocity127ID = 0x0200000D,
kQTMSKnobVolumeVelocity96ID = 0x0200000E,
kQTMSKnobVolumeVelocity64ID = 0x0200000F,
kQTMSKnobVolumeVelocity32ID = 0x02000010,
kQTMSKnobVolumeVelocity16ID = 0x02000011, /* Pitch related knobs*/
kQTMSKnobPitchTransposeID = 0x02000012,
kQTMSKnobPitchLFODelayID = 0x02000013,
kQTMSKnobPitchLFORampTimeID = 0x02000014,
kQTMSKnobPitchLFOPeriodID = 0x02000015,
kQTMSKnobPitchLFOShapeID = 0x02000016,
kQTMSKnobPitchLFODepthID = 0x02000017,
kQTMSKnobPitchLFOQuantizeID = 0x02000018, /* Stereo related knobs*/
kQTMSKnobStereoDefaultPanID = 0x02000019,
kQTMSKnobStereoPositionKeyScalingID = 0x0200001A,
kQTMSKnobPitchLFOOffsetID = 0x0200001B,
kQTMSKnobExclusionGroupID = 0x0200001C, /* Misc knobs, late additions*/
kQTMSKnobSustainTimeID = 0x0200001D,
kQTMSKnobSustainInfiniteID = 0x0200001E,
kQTMSKnobVolumeLFOStereoID = 0x0200001F,
kQTMSKnobVelocityLowID = 0x02000020,
kQTMSKnobVelocityHighID = 0x02000021,
kQTMSKnobVelocitySensitivityID = 0x02000022,
kQTMSKnobPitchSensitivityID = 0x02000023,
kQTMSKnobVolumeLFODepthFromWheelID = 0x02000024,
kQTMSKnobPitchLFODepthFromWheelID = 0x02000025, /* Volume Env again*/
kQTMSKnobVolumeExpOptionsID = 0x02000026, /* Env1*/
kQTMSKnobEnv1AttackTimeID = 0x02000027,
kQTMSKnobEnv1DecayTimeID = 0x02000028,
kQTMSKnobEnv1SustainLevelID = 0x02000029,
kQTMSKnobEnv1SustainTimeID = 0x0200002A,
kQTMSKnobEnv1SustainInfiniteID = 0x0200002B,
kQTMSKnobEnv1ReleaseTimeID = 0x0200002C,
kQTMSKnobEnv1ExpOptionsID = 0x0200002D, /* Env2*/
kQTMSKnobEnv2AttackTimeID = 0x0200002E,
kQTMSKnobEnv2DecayTimeID = 0x0200002F,
kQTMSKnobEnv2SustainLevelID = 0x02000030,
kQTMSKnobEnv2SustainTimeID = 0x02000031,
kQTMSKnobEnv2SustainInfiniteID = 0x02000032,
kQTMSKnobEnv2ReleaseTimeID = 0x02000033,
kQTMSKnobEnv2ExpOptionsID = 0x02000034, /* Pitch Env*/
kQTMSKnobPitchEnvelopeID = 0x02000035,
kQTMSKnobPitchEnvelopeDepthID = 0x02000036, /* Filter*/
kQTMSKnobFilterKeyFollowID = 0x02000037,
kQTMSKnobFilterTransposeID = 0x02000038,
kQTMSKnobFilterQID = 0x02000039,
kQTMSKnobFilterFrequencyEnvelopeID = 0x0200003A,
kQTMSKnobFilterFrequencyEnvelopeDepthID = 0x0200003B,
kQTMSKnobFilterQEnvelopeID = 0x0200003C,
kQTMSKnobFilterQEnvelopeDepthID = 0x0200003D, /* Reverb Threshhold*/
kQTMSKnobReverbThresholdID = 0x0200003E,
kQTMSKnobVolumeAttackVelScalingID = 0x0200003F,
kQTMSKnobLastIDPlus1 = 0x02000040
};
enum {
kControllerMaximum = 0x00007FFF, /* +01111111.11111111 */
kControllerMinimum = (long)0xFFFF8000 /* -10000000.00000000 */
};
struct SynthesizerDescription {
OSType synthesizerType; /* synthesizer type (must be same as component subtype) */
Str31 name; /* text name of synthesizer type */
unsigned long flags; /* from the above enum */
unsigned long voiceCount; /* maximum polyphony */
unsigned long partCount; /* maximum multi-timbrality (and midi channels) */
unsigned long instrumentCount; /* non gm, built in (rom) instruments only */
unsigned long modifiableInstrumentCount; /* plus n-more are user modifiable */
unsigned long channelMask; /* (midi device only) which channels device always uses */
unsigned long drumPartCount; /* maximum multi-timbrality of drum parts */
unsigned long drumCount; /* non gm, built in (rom) drumkits only */
unsigned long modifiableDrumCount; /* plus n-more are user modifiable */
unsigned long drumChannelMask; /* (midi device only) which channels device always uses */
unsigned long outputCount; /* number of audio outputs (usually two) */
unsigned long latency; /* response time in .Sec */
unsigned long controllers[4]; /* array of 128 bits */
unsigned long gmInstruments[4]; /* array of 128 bits */
unsigned long gmDrums[4]; /* array of 128 bits */
};
typedef struct SynthesizerDescription SynthesizerDescription;
enum {
kVoiceCountDynamic = -1 /* constant to use to specify dynamic voicing */
};
struct ToneDescription {
BigEndianOSType synthesizerType; /* synthesizer type */
Str31 synthesizerName; /* name of instantiation of synth */
Str31 instrumentName; /* preferred name for human use */
BigEndianLong instrumentNumber; /* inst-number used if synth-name matches */
BigEndianLong gmNumber; /* Best matching general MIDI number */
};
typedef struct ToneDescription ToneDescription;
enum {
kFirstGMInstrument = 0x00000001,
kLastGMInstrument = 0x00000080,
kFirstGSInstrument = 0x00000081,
kLastGSInstrument = 0x00003FFF,
kFirstDrumkit = 0x00004000, /* (first value is "no drum". instrument numbers from 16384->16384+128 are drumkits, and for GM they are _defined_ drumkits! */
kLastDrumkit = 0x00004080,
kFirstROMInstrument = 0x00008000,
kLastROMInstrument = 0x0000FFFF,
kFirstUserInstrument = 0x00010000,
kLastUserInstrument = 0x0001FFFF
};
/* InstrumentMatch*/
enum {
kInstrumentMatchSynthesizerType = 1,
kInstrumentMatchSynthesizerName = 2,
kInstrumentMatchName = 4,
kInstrumentMatchNumber = 8,
kInstrumentMatchGMNumber = 16,
kInstrumentMatchGSNumber = 32
};
/* KnobFlags*/
enum {
kKnobBasic = 8, /* knob shows up in certain simplified lists of knobs */
kKnobReadOnly = 16, /* knob value cannot be changed by user or with a SetKnob call */
kKnobInterruptUnsafe = 32, /* only alter this knob from foreground task time (may access toolbox) */
kKnobKeyrangeOverride = 64, /* knob can be overridden within a single keyrange (software synth only) */
kKnobGroupStart = 128, /* knob is first in some logical group of knobs */
kKnobFixedPoint8 = 1024,
kKnobFixedPoint16 = 2048, /* One of these may be used at a time. */
kKnobTypeNumber = 0 << 12,
kKnobTypeGroupName = 1 << 12, /* "knob" is really a group name for display purposes */
kKnobTypeBoolean = 2 << 12, /* if range is greater than 1, its a multi-checkbox field */
kKnobTypeNote = 3 << 12, /* knob range is equivalent to MIDI keys */
kKnobTypePan = 4 << 12, /* range goes left/right (lose this? ) */
kKnobTypeInstrument = 5 << 12, /* knob value = reference to another instrument number */
kKnobTypeSetting = 6 << 12, /* knob value is 1 of n different things (eg, fm algorithms) popup menu */
kKnobTypeMilliseconds = 7 << 12, /* knob is a millisecond time range */
kKnobTypePercentage = 8 << 12, /* knob range is displayed as a Percentage */
kKnobTypeHertz = 9 << 12, /* knob represents frequency */
kKnobTypeButton = 10 << 12 /* momentary trigger push button */
};
enum {
kUnknownKnobValue = 0x7FFFFFFF, /* a knob with this value means, we don't know it. */
kDefaultKnobValue = 0x7FFFFFFE /* used to SET a knob to its default value. */
};
struct KnobDescription {
Str63 name;
long lowValue;
long highValue;
long defaultValue; /* a default instrument is made of all default values */
long flags;
long knobID;
};
typedef struct KnobDescription KnobDescription;
struct GCInstrumentData {
ToneDescription tone;
long knobCount;
long knob[1];
};
typedef struct GCInstrumentData GCInstrumentData;
typedef GCInstrumentData * GCInstrumentDataPtr;
typedef GCInstrumentDataPtr * GCInstrumentDataHandle;
struct InstrumentAboutInfo {
PicHandle p;
Str255 author;
Str255 copyright;
Str255 other;
};
typedef struct InstrumentAboutInfo InstrumentAboutInfo;
enum {
notImplementedMusicErr = (0x80000000 | (0xFFFF & (notImplementedMusicOSErr))),
cantSendToSynthesizerErr = (0x80000000 | (0xFFFF & (cantSendToSynthesizerOSErr))),
cantReceiveFromSynthesizerErr = (0x80000000 | (0xFFFF & (cantReceiveFromSynthesizerOSErr))),
illegalVoiceAllocationErr = (0x80000000 | (0xFFFF & (illegalVoiceAllocationOSErr))),
illegalPartErr = (0x80000000 | (0xFFFF & (illegalPartOSErr))),
illegalChannelErr = (0x80000000 | (0xFFFF & (illegalChannelOSErr))),
illegalKnobErr = (0x80000000 | (0xFFFF & (illegalKnobOSErr))),
illegalKnobValueErr = (0x80000000 | (0xFFFF & (illegalKnobValueOSErr))),
illegalInstrumentErr = (0x80000000 | (0xFFFF & (illegalInstrumentOSErr))),
illegalControllerErr = (0x80000000 | (0xFFFF & (illegalControllerOSErr))),
midiManagerAbsentErr = (0x80000000 | (0xFFFF & (midiManagerAbsentOSErr))),
synthesizerNotRespondingErr = (0x80000000 | (0xFFFF & (synthesizerNotRespondingOSErr))),
synthesizerErr = (0x80000000 | (0xFFFF & (synthesizerOSErr))),
illegalNoteChannelErr = (0x80000000 | (0xFFFF & (illegalNoteChannelOSErr))),
noteChannelNotAllocatedErr = (0x80000000 | (0xFFFF & (noteChannelNotAllocatedOSErr))),
tunePlayerFullErr = (0x80000000 | (0xFFFF & (tunePlayerFullOSErr))),
tuneParseErr = (0x80000000 | (0xFFFF & (tuneParseOSErr)))
};
enum {
kGetAtomicInstNoExpandedSamples = 1 << 0,
kGetAtomicInstNoOriginalSamples = 1 << 1,
kGetAtomicInstNoSamples = kGetAtomicInstNoExpandedSamples | kGetAtomicInstNoOriginalSamples,
kGetAtomicInstNoKnobList = 1 << 2,
kGetAtomicInstNoInstrumentInfo = 1 << 3,
kGetAtomicInstOriginalKnobList = 1 << 4,
kGetAtomicInstAllKnobs = 1 << 5 /* return even those that are set to default*/
};
/*
For non-gm instruments, instrument number of tone description == 0
If you want to speed up while running, slam the inst num with what Get instrument number returns
All missing knobs are slammed to the default value
*/
enum {
kSetAtomicInstKeepOriginalInstrument = 1 << 0,
kSetAtomicInstShareAcrossParts = 1 << 1, /* inst disappears when app goes away*/
kSetAtomicInstCallerTosses = 1 << 2, /* the caller isn't keeping a copy around (for NASetAtomicInstrument)*/
kSetAtomicInstCallerGuarantees = 1 << 3, /* the caller guarantees a copy is around*/
kSetAtomicInstInterruptSafe = 1 << 4, /* dont move memory at this time (but process at next task time)*/
kSetAtomicInstDontPreprocess = 1 << 7 /* perform no further preprocessing because either 1)you know the instrument is digitally clean, or 2) you got it from a GetPartAtomic*/
};
enum {
kInstrumentNamesModifiable = 1,
kInstrumentNamesBoth = 2
};
/*
* Structures specific to the GenericMusicComponent
*/
enum {
kGenericMusicComponentSubtype = FOUR_CHAR_CODE('gene')
};
struct GenericKnobDescription {
KnobDescription kd;
long hw1; /* driver defined */
long hw2; /* driver defined */
long hw3; /* driver defined */
long settingsID; /* resource ID list for boolean and popup names */
};
typedef struct GenericKnobDescription GenericKnobDescription;
struct GenericKnobDescriptionList {
long knobCount;
GenericKnobDescription knob[1];
};
typedef struct GenericKnobDescriptionList GenericKnobDescriptionList;
typedef GenericKnobDescriptionList * GenericKnobDescriptionListPtr;
typedef GenericKnobDescriptionListPtr * GenericKnobDescriptionListHandle;
/* knobTypes for MusicDerivedSetKnob */
enum {
kGenericMusicKnob = 1,
kGenericMusicInstrumentKnob = 2,
kGenericMusicDrumKnob = 3,
kGenericMusicGlobalController = 4
};
enum {
kGenericMusicResFirst = 0,
kGenericMusicResMiscStringList = 1, /* STR# 1: synth name, 2:about author,3:aboutcopyright,4:aboutother */
kGenericMusicResMiscLongList = 2, /* Long various params, see list below */
kGenericMusicResInstrumentList = 3, /* NmLs of names and shorts, categories prefixed by 'oo' */
kGenericMusicResDrumList = 4, /* NmLs of names and shorts */
kGenericMusicResInstrumentKnobDescriptionList = 5, /* Knob */
kGenericMusicResDrumKnobDescriptionList = 6, /* Knob */
kGenericMusicResKnobDescriptionList = 7, /* Knob */
kGenericMusicResBitsLongList = 8, /* Long back to back bitmaps of controllers, gminstruments, and drums */
kGenericMusicResModifiableInstrumentHW = 9, /* Shrt same as the hw shorts trailing the instrument names, a shortlist */
kGenericMusicResGMTranslation = 10, /* Long 128 long entries, 1 for each gm inst, of local instrument numbers 1-n (not hw numbers) */
kGenericMusicResROMInstrumentData = 11, /* knob lists for ROM instruments, so the knob values may be known */
kGenericMusicResAboutPICT = 12, /* picture for aboutlist. must be present for GetAbout call to work */
kGenericMusicResLast = 13
};
/* elements of the misc long list */
enum {
kGenericMusicMiscLongFirst = 0,
kGenericMusicMiscLongVoiceCount = 1,
kGenericMusicMiscLongPartCount = 2,
kGenericMusicMiscLongModifiableInstrumentCount = 3,
kGenericMusicMiscLongChannelMask = 4,
kGenericMusicMiscLongDrumPartCount = 5,
kGenericMusicMiscLongModifiableDrumCount = 6,
kGenericMusicMiscLongDrumChannelMask = 7,
kGenericMusicMiscLongOutputCount = 8,
kGenericMusicMiscLongLatency = 9,
kGenericMusicMiscLongFlags = 10,
kGenericMusicMiscLongFirstGMHW = 11, /* number to add to locate GM main instruments */
kGenericMusicMiscLongFirstGMDrumHW = 12, /* number to add to locate GM drumkits */
kGenericMusicMiscLongFirstUserHW = 13, /* First hw number of user instruments (presumed sequential) */
kGenericMusicMiscLongLast = 14
};
struct GCPart {
long hwInstrumentNumber; /* internal number of recalled instrument */
short controller[128]; /* current values for all controllers */
long volume; /* ctrl 7 is special case */
long polyphony;
long midiChannel; /* 1-16 if in use */
GCInstrumentData id; /* ToneDescription & knoblist, uncertain length */
};
typedef struct GCPart GCPart;
/*
* Calls specific to the GenericMusicComponent
*/
enum {
kMusicGenericRange = 0x0100,
kMusicDerivedRange = 0x0200
};
/*
* Flags in GenericMusicConfigure call
*/
enum {
kGenericMusicDoMIDI = 1 << 0, /* implement normal MIDI messages for note, controllers, and program changes 0-127 */
kGenericMusicBank0 = 1 << 1, /* implement instrument bank changes on controller 0 */
kGenericMusicBank32 = 1 << 2, /* implement instrument bank changes on controller 32 */
kGenericMusicErsatzMIDI = 1 << 3, /* construct MIDI packets, but send them to the derived component */
kGenericMusicCallKnobs = 1 << 4, /* call the derived component with special knob format call */
kGenericMusicCallParts = 1 << 5, /* call the derived component with special part format call */
kGenericMusicCallInstrument = 1 << 6, /* call MusicDerivedSetInstrument for MusicSetInstrument calls */
kGenericMusicCallNumber = 1 << 7, /* call MusicDerivedSetPartInstrumentNumber for MusicSetPartInstrumentNumber calls, & don't send any C0 or bank stuff */
kGenericMusicCallROMInstrument = 1 << 8, /* call MusicSetInstrument for MusicSetPartInstrumentNumber for "ROM" instruments, passing params from the ROMi resource */
kGenericMusicAllDefaults = 1 << 9 /* indicates that when a new instrument is recalled, all knobs are reset to DEFAULT settings. True for GS modules */
};
typedef CALLBACK_API( ComponentResult , MusicOfflineDataProcPtr )(Ptr SoundData, long numBytes, long myRefCon);
typedef STACK_UPP_TYPE(MusicOfflineDataProcPtr) MusicOfflineDataUPP;
struct OfflineSampleType {
unsigned long numChannels; /*number of channels, ie mono = 1*/
UnsignedFixed sampleRate; /*sample rate in Apples Fixed point representation*/
unsigned short sampleSize; /*number of bits in sample*/
};
typedef struct OfflineSampleType OfflineSampleType;
struct InstrumentInfoRecord {
long instrumentNumber; /* instrument number (if 0, name is a catagory)*/
long flags; /* show in picker, etc.*/
long toneNameIndex; /* index in toneNames (1 based)*/
long itxtNameAtomID; /* index in itxtNames (itxt/name by index)*/
};
typedef struct InstrumentInfoRecord InstrumentInfoRecord;
struct InstrumentInfoList {
long recordCount;
Handle toneNames; /* name from tone description*/
QTAtomContainer itxtNames; /* itxt/name atoms for instruments*/
InstrumentInfoRecord info[1];
};
typedef struct InstrumentInfoList InstrumentInfoList;
typedef InstrumentInfoList * InstrumentInfoListPtr;
typedef InstrumentInfoListPtr * InstrumentInfoListHandle;
EXTERN_API( ComponentResult )
MusicGetDescription (MusicComponent mc,
SynthesizerDescription * sd) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0001, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetPart (MusicComponent mc,
long part,
long * midiChannel,
long * polyphony) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0002, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetPart (MusicComponent mc,
long part,
long midiChannel,
long polyphony) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0003, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetPartInstrumentNumber (MusicComponent mc,
long part,
long instrumentNumber) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0004, 0x7000, 0xA82A);
if OLDROUTINENAMES
define MusicSetInstrumentNumber(ci,part,instrumentNumber) MusicSetPartInstrumentNumber(ci, part,instrumentNumber)
endif
EXTERN_API( ComponentResult )
MusicGetPartInstrumentNumber (MusicComponent mc,
long part) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0005, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicStorePartInstrument (MusicComponent mc,
long part,
long instrumentNumber) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0006, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetPartAtomicInstrument (MusicComponent mc,
long part,
AtomicInstrument * ai,
long flags) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0009, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetPartAtomicInstrument (MusicComponent mc,
long part,
AtomicInstrumentPtr aiP,
long flags) FIVEWORDINLINE(0x2F3C, 0x000C, 0x000A, 0x7000, 0xA82A);
/* Obsolete calls*/
EXTERN_API( ComponentResult )
MusicGetInstrumentKnobDescriptionObsolete (MusicComponent mc,
long knobIndex,
void * mkd) FIVEWORDINLINE(0x2F3C, 0x0008, 0x000D, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetDrumKnobDescriptionObsolete (MusicComponent mc,
long knobIndex,
void * mkd) FIVEWORDINLINE(0x2F3C, 0x0008, 0x000E, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetKnobDescriptionObsolete (MusicComponent mc,
long knobIndex,
void * mkd) FIVEWORDINLINE(0x2F3C, 0x0008, 0x000F, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetPartKnob (MusicComponent mc,
long part,
long knobID) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0010, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetPartKnob (MusicComponent mc,
long part,
long knobID,
long knobValue) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0011, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetKnob (MusicComponent mc,
long knobID) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0012, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetKnob (MusicComponent mc,
long knobID,
long knobValue) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0013, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetPartName (MusicComponent mc,
long part,
StringPtr name) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0014, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetPartName (MusicComponent mc,
long part,
StringPtr name) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0015, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicFindTone (MusicComponent mc,
ToneDescription * td,
long * libraryIndexOut,
unsigned long * fit) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0016, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicPlayNote (MusicComponent mc,
long part,
long pitch,
long velocity) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0017, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicResetPart (MusicComponent mc,
long part) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0018, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetPartController (MusicComponent mc,
long part,
MusicController controllerNumber,
long controllerValue) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0019, 0x7000, 0xA82A);
if OLDROUTINENAMES
define MusicSetController(ci,part,controllerNumber,controllerValue) MusicSetPartController(ci, part,controllerNumber,controllerValue)
endif
EXTERN_API( ComponentResult )
MusicGetPartController (MusicComponent mc,
long part,
MusicController controllerNumber) FIVEWORDINLINE(0x2F3C, 0x0008, 0x001A, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetMIDIProc (MusicComponent mc,
MusicMIDISendUPP * midiSendProc,
long * refCon) FIVEWORDINLINE(0x2F3C, 0x0008, 0x001B, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetMIDIProc (MusicComponent mc,
MusicMIDISendUPP midiSendProc,
long refCon) FIVEWORDINLINE(0x2F3C, 0x0008, 0x001C, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetInstrumentNames (MusicComponent mc,
long modifiableInstruments,
Handle * instrumentNames,
Handle * instrumentCategoryLasts,
Handle * instrumentCategoryNames) FIVEWORDINLINE(0x2F3C, 0x0010, 0x001D, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetDrumNames (MusicComponent mc,
long modifiableInstruments,
Handle * instrumentNumbers,
Handle * instrumentNames) FIVEWORDINLINE(0x2F3C, 0x000C, 0x001E, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetMasterTune (MusicComponent mc) FIVEWORDINLINE(0x2F3C, 0x0000, 0x001F, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetMasterTune (MusicComponent mc,
long masterTune) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0020, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetInstrumentAboutInfo (MusicComponent mc,
long part,
InstrumentAboutInfo * iai) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0022, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetDeviceConnection (MusicComponent mc,
long index,
long * id1,
long * id2) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0023, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicUseDeviceConnection (MusicComponent mc,
long id1,
long id2) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0024, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetKnobSettingStrings (MusicComponent mc,
long knobIndex,
long isGlobal,
Handle * settingsNames,
Handle * settingsCategoryLasts,
Handle * settingsCategoryNames) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0025, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetMIDIPorts (MusicComponent mc,
long * inputPortCount,
long * outputPortCount) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0026, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSendMIDI (MusicComponent mc,
long portIndex,
MusicMIDIPacket * mp) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0027, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicReceiveMIDI (MusicComponent mc,
MusicMIDIReadHookUPP readHook,
long refCon) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0028, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicStartOffline (MusicComponent mc,
unsigned long * numChannels,
UnsignedFixed * sampleRate,
unsigned short * sampleSize,
MusicOfflineDataUPP dataProc,
long dataProcRefCon) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0029, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetOfflineTimeTo (MusicComponent mc,
long newTimeStamp) FIVEWORDINLINE(0x2F3C, 0x0004, 0x002A, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetInstrumentKnobDescription (MusicComponent mc,
long knobIndex,
KnobDescription * mkd) FIVEWORDINLINE(0x2F3C, 0x0008, 0x002B, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetDrumKnobDescription (MusicComponent mc,
long knobIndex,
KnobDescription * mkd) FIVEWORDINLINE(0x2F3C, 0x0008, 0x002C, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetKnobDescription (MusicComponent mc,
long knobIndex,
KnobDescription * mkd) FIVEWORDINLINE(0x2F3C, 0x0008, 0x002D, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGetInfoText (MusicComponent mc,
long selector,
Handle * textH,
Handle * styleH) FIVEWORDINLINE(0x2F3C, 0x000C, 0x002E, 0x7000, 0xA82A);
enum {
kGetInstrumentInfoNoBuiltIn = 1 << 0,
kGetInstrumentInfoMidiUserInst = 1 << 1,
kGetInstrumentInfoNoIText = 1 << 2
};
EXTERN_API( ComponentResult )
MusicGetInstrumentInfo (MusicComponent mc,
long getInstrumentInfoFlags,
InstrumentInfoListHandle * infoListH) FIVEWORDINLINE(0x2F3C, 0x0008, 0x002F, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicTask (MusicComponent mc) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0031, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetPartInstrumentNumberInterruptSafe (MusicComponent mc,
long part,
long instrumentNumber) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0032, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicSetPartSoundLocalization (MusicComponent mc,
long part,
Handle data) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0033, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGenericConfigure (MusicComponent mc,
long mode,
long flags,
long baseResID) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0100, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGenericGetPart (MusicComponent mc,
long partNumber,
GCPart ** part) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0101, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGenericGetKnobList (MusicComponent mc,
long knobType,
GenericKnobDescriptionListHandle * gkdlH) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0102, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicGenericSetResourceNumbers (MusicComponent mc,
Handle resourceIDH) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0103, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedMIDISend (MusicComponent mc,
MusicMIDIPacket * packet) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0200, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedSetKnob (MusicComponent mc,
long knobType,
long knobNumber,
long knobValue,
long partNumber,
GCPart * p,
GenericKnobDescription * gkd) FIVEWORDINLINE(0x2F3C, 0x0018, 0x0201, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedSetPart (MusicComponent mc,
long partNumber,
GCPart * p) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0202, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedSetInstrument (MusicComponent mc,
long partNumber,
GCPart * p) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0203, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedSetPartInstrumentNumber (MusicComponent mc,
long partNumber,
GCPart * p) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0204, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedSetMIDI (MusicComponent mc,
MusicMIDISendUPP midiProc,
long refcon,
long midiChannel) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0205, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedStorePartInstrument (MusicComponent mc,
long partNumber,
GCPart * p,
long instrumentNumber) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0206, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedOpenResFile (MusicComponent mc) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0207, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
MusicDerivedCloseResFile (MusicComponent mc,
short resRefNum) FIVEWORDINLINE(0x2F3C, 0x0002, 0x0208, 0x7000, 0xA82A);
/* Mask bit for returned value by InstrumentFind.*/
enum {
kInstrumentExactMatch = 0x00020000,
kInstrumentRecommendedSubstitute = 0x00010000,
kInstrumentQualityField = (long)0xFF000000,
kInstrumentRoland8BitQuality = 0x05000000
};
typedef InstrumentAboutInfo * InstrumentAboutInfoPtr;
typedef InstrumentAboutInfoPtr * InstrumentAboutInfoHandle;
struct GMInstrumentInfo {
long cmpInstID;
long gmInstNum;
long instMatch;
};
typedef struct GMInstrumentInfo GMInstrumentInfo;
typedef GMInstrumentInfo * GMInstrumentInfoPtr;
typedef GMInstrumentInfoPtr * GMInstrumentInfoHandle;
struct nonGMInstrumentInfoRecord {
long cmpInstID; /* if 0, category name*/
long flags; /* match, show in picker*/
long toneNameIndex; /* index in toneNames (1 based)*/
long itxtNameAtomID; /* index in itxtNames (itxt/name by index)*/
};
typedef struct nonGMInstrumentInfoRecord nonGMInstrumentInfoRecord;
struct nonGMInstrumentInfo {
long recordCount;
Handle toneNames; /* name from tone description*/
QTAtomContainer itxtNames; /* itext/name atoms for instruments*/
nonGMInstrumentInfoRecord instInfo[1];
};
typedef struct nonGMInstrumentInfo nonGMInstrumentInfo;
typedef nonGMInstrumentInfo * nonGMInstrumentInfoPtr;
typedef nonGMInstrumentInfoPtr * nonGMInstrumentInfoHandle;
struct InstCompInfo {
long infoSize; /* size of this record*/
Str31 InstrumentLibraryName;
QTAtomContainer InstrumentLibraryITxt; /* itext/name atoms for instruments*/
long GMinstrumentCount;
GMInstrumentInfoHandle GMinstrumentInfo;
long GMdrumCount;
GMInstrumentInfoHandle GMdrumInfo;
long nonGMinstrumentCount;
nonGMInstrumentInfoHandle nonGMinstrumentInfo;
};
typedef struct InstCompInfo InstCompInfo;
typedef InstCompInfo * InstCompInfoPtr;
typedef InstCompInfoPtr * InstCompInfoHandle;
EXTERN_API( ComponentResult )
InstrumentGetInst (ComponentInstance ci,
long instID,
AtomicInstrument * atomicInst,
long flags) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0001, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
InstrumentGetInfo (ComponentInstance ci,
long getInstrumentInfoFlags,
InstCompInfoHandle * instInfo) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0002, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
InstrumentInitialize (ComponentInstance ci,
long initFormat,
void * initParams) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0003, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
InstrumentOpenComponentResFile (ComponentInstance ci,
short * resFile) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0004, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
InstrumentCloseComponentResFile (ComponentInstance ci,
short resFile) FIVEWORDINLINE(0x2F3C, 0x0002, 0x0005, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
InstrumentGetComponentRefCon (ComponentInstance ci,
void ** refCon) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0006, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
InstrumentSetComponentRefCon (ComponentInstance ci,
void * refCon) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0007, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
InstrumentGetSynthesizerType (ComponentInstance ci,
OSType * synthesizerType) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0008, 0x7000, 0xA82A);
/*--------------------------
Types
--------------------------*/
enum {
kNoteRequestNoGM = 1, /* dont degrade to a GM synth */
kNoteRequestNoSynthType = 2, /* dont degrade to another synth of same type but different name */
kNoteRequestSynthMustMatch = 4 /* synthType must be a match, including kGMSynthComponentSubType */
};
enum {
kNoteRequestSpecifyMIDIChannel = 0x80
};
typedef ComponentInstance NoteAllocator;
/*
The midiChannelAssignment field of this structure is used to assign a MIDI channel
when a NoteChannel is created from a NoteRequest.
A value of 0 indicates a MIDI channel has *not* been assigned
A value of (kNoteRequestSpecifyMIDIChannel | 1->16) is a MIDI channel assignment
*/
typedef UInt8 NoteRequestMIDIChannel;
struct NoteRequestInfo {
UInt8 flags; /* 1: dont accept GM match, 2: dont accept same-synth-type match */
NoteRequestMIDIChannel midiChannelAssignment; /* (kNoteRequestSpecifyMIDIChannel | 1->16) as MIDI Channel assignement or zero - see notes above */
BigEndianShort polyphony; /* Maximum number of voices */
BigEndianFixed typicalPolyphony; /* Hint for level mixing */
};
typedef struct NoteRequestInfo NoteRequestInfo;
struct NoteRequest {
NoteRequestInfo info;
ToneDescription tone;
};
typedef struct NoteRequest NoteRequest;
typedef struct OpaqueNoteChannel* NoteChannel;
enum {
kPickDontMix = 1, /* dont mix instruments with drum sounds */
kPickSameSynth = 2, /* only allow the same device that went in, to come out */
kPickUserInsts = 4, /* show user insts in addition to ROM voices */
kPickEditAllowEdit = 8, /* lets user switch over to edit mode */
kPickEditAllowPick = 16, /* lets the user switch over to pick mode */
kPickEditSynthGlobal = 32, /* edit the global knobs of the synth */
kPickEditControllers = 64 /* edit the controllers of the notechannel */
};
enum {
kNoteAllocatorComponentType = FOUR_CHAR_CODE('nota')
};
/*--------------------------------
Note Allocator Prototypes
--------------------------------*/
EXTERN_API( ComponentResult )
NARegisterMusicDevice (NoteAllocator na,
OSType synthType,
Str31 name,
SynthesizerConnections * connections) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0000, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAUnregisterMusicDevice (NoteAllocator na,
long index) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0001, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAGetRegisteredMusicDevice (NoteAllocator na,
long index,
OSType * synthType,
Str31 name,
SynthesizerConnections * connections,
MusicComponent * mc) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0002, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASaveMusicConfiguration (NoteAllocator na) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0003, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NANewNoteChannel (NoteAllocator na,
NoteRequest * noteRequest,
NoteChannel * outChannel) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0004, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NADisposeNoteChannel (NoteAllocator na,
NoteChannel noteChannel) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0005, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAGetNoteChannelInfo (NoteAllocator na,
NoteChannel noteChannel,
long * index,
long * part) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0006, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAPrerollNoteChannel (NoteAllocator na,
NoteChannel noteChannel) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0007, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAUnrollNoteChannel (NoteAllocator na,
NoteChannel noteChannel) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0008, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetNoteChannelVolume (NoteAllocator na,
NoteChannel noteChannel,
Fixed volume) FIVEWORDINLINE(0x2F3C, 0x0008, 0x000B, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAResetNoteChannel (NoteAllocator na,
NoteChannel noteChannel) FIVEWORDINLINE(0x2F3C, 0x0004, 0x000C, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAPlayNote (NoteAllocator na,
NoteChannel noteChannel,
long pitch,
long velocity) FIVEWORDINLINE(0x2F3C, 0x000C, 0x000D, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetController (NoteAllocator na,
NoteChannel noteChannel,
long controllerNumber,
long controllerValue) FIVEWORDINLINE(0x2F3C, 0x000C, 0x000E, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetKnob (NoteAllocator na,
NoteChannel noteChannel,
long knobNumber,
long knobValue) FIVEWORDINLINE(0x2F3C, 0x000C, 0x000F, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAFindNoteChannelTone (NoteAllocator na,
NoteChannel noteChannel,
ToneDescription * td,
long * instrumentNumber) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0010, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetInstrumentNumber (NoteAllocator na,
NoteChannel noteChannel,
long instrumentNumber) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0011, 0x7000, 0xA82A);
if OLDROUTINENAMES
define NASetNoteChannelInstrument(ci, noteChannel,instrumentNumber ) NASetInstrumentNumber(ci, noteChannel,instrumentNumber)
define NASetInstrument(ci, noteChannel,instrumentNumber ) NASetInstrumentNumber(ci, noteChannel,instrumentNumber)
endif
EXTERN_API( ComponentResult )
NAPickInstrument (NoteAllocator na,
ModalFilterUPP filterProc,
StringPtr prompt,
ToneDescription * sd,
unsigned long flags,
long refCon,
long reserved1,
long reserved2) FIVEWORDINLINE(0x2F3C, 0x001C, 0x0012, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAPickArrangement (NoteAllocator na,
ModalFilterUPP filterProc,
StringPtr prompt,
long zero1,
long zero2,
Track t,
StringPtr songName) FIVEWORDINLINE(0x2F3C, 0x0018, 0x0013, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetDefaultMIDIInput (NoteAllocator na,
SynthesizerConnections * sc) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0015, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAGetDefaultMIDIInput (NoteAllocator na,
SynthesizerConnections * sc) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0016, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAUseDefaultMIDIInput (NoteAllocator na,
MusicMIDIReadHookUPP readHook,
long refCon,
unsigned long flags) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0019, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NALoseDefaultMIDIInput (NoteAllocator na) FIVEWORDINLINE(0x2F3C, 0x0000, 0x001A, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAStuffToneDescription (NoteAllocator na,
long gmNumber,
ToneDescription * td) FIVEWORDINLINE(0x2F3C, 0x0008, 0x001B, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NACopyrightDialog (NoteAllocator na,
PicHandle p,
StringPtr author,
StringPtr copyright,
StringPtr other,
StringPtr title,
ModalFilterUPP filterProc,
long refCon) FIVEWORDINLINE(0x2F3C, 0x001C, 0x001C, 0x7000, 0xA82A);
/*
kNADummyOneSelect = 29
kNADummyTwoSelect = 30
*/
EXTERN_API( ComponentResult )
NAGetIndNoteChannel (NoteAllocator na,
long index,
NoteChannel * nc,
long * seed) FIVEWORDINLINE(0x2F3C, 0x000C, 0x001F, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAGetMIDIPorts (NoteAllocator na,
QTMIDIPortListHandle * inputPorts,
QTMIDIPortListHandle * outputPorts) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0021, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAGetNoteRequest (NoteAllocator na,
NoteChannel noteChannel,
NoteRequest * nrOut) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0022, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASendMIDI (NoteAllocator na,
NoteChannel noteChannel,
MusicMIDIPacket * mp) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0023, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAPickEditInstrument (NoteAllocator na,
ModalFilterUPP filterProc,
StringPtr prompt,
long refCon,
NoteChannel nc,
AtomicInstrument ai,
long flags) FIVEWORDINLINE(0x2F3C, 0x0018, 0x0024, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NANewNoteChannelFromAtomicInstrument (NoteAllocator na,
AtomicInstrumentPtr instrument,
long flags,
NoteChannel * outChannel) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0025, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetAtomicInstrument (NoteAllocator na,
NoteChannel noteChannel,
AtomicInstrumentPtr instrument,
long flags) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0026, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAGetKnob (NoteAllocator na,
NoteChannel noteChannel,
long knobNumber,
long * knobValue) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0028, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NATask (NoteAllocator na) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0029, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetNoteChannelBalance (NoteAllocator na,
NoteChannel noteChannel,
long balance) FIVEWORDINLINE(0x2F3C, 0x0008, 0x002A, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetInstrumentNumberInterruptSafe (NoteAllocator na,
NoteChannel noteChannel,
long instrumentNumber) FIVEWORDINLINE(0x2F3C, 0x0008, 0x002B, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NASetNoteChannelSoundLocalization (NoteAllocator na,
NoteChannel noteChannel,
Handle data) FIVEWORDINLINE(0x2F3C, 0x0008, 0x002C, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
NAGetController (NoteAllocator na,
NoteChannel noteChannel,
long controllerNumber,
long * controllerValue) FIVEWORDINLINE(0x2F3C, 0x000C, 0x002D, 0x7000, 0xA82A);
enum {
kTuneQueueDepth = 8 /* Deepest you can queue tune segments */
};
struct TuneStatus {
unsigned long * tune; /* currently playing tune */
unsigned long * tunePtr; /* position within currently playing piece */
TimeValue time; /* current tune time */
short queueCount; /* how many pieces queued up? */
short queueSpots; /* How many more tunepieces can be queued */
TimeValue queueTime; /* How much time is queued up? (can be very inaccurate) */
long reserved[3];
};
typedef struct TuneStatus TuneStatus;
typedef CALLBACK_API( void , TuneCallBackProcPtr )(const TuneStatus *status, long refCon);
typedef CALLBACK_API( void , TunePlayCallBackProcPtr )(unsigned long *event, long seed, long refCon);
typedef STACK_UPP_TYPE(TuneCallBackProcPtr) TuneCallBackUPP;
typedef STACK_UPP_TYPE(TunePlayCallBackProcPtr) TunePlayCallBackUPP;
typedef ComponentInstance TunePlayer;
enum {
kTunePlayerComponentType = FOUR_CHAR_CODE('tune')
};
EXTERN_API( ComponentResult )
TuneSetHeader (TunePlayer tp,
unsigned long * header) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0004, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneGetTimeBase (TunePlayer tp,
TimeBase * tb) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0005, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneSetTimeScale (TunePlayer tp,
TimeScale scale) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0006, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneGetTimeScale (TunePlayer tp,
TimeScale * scale) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0007, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneGetIndexedNoteChannel (TunePlayer tp,
long i,
NoteChannel * nc) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0008, 0x7000, 0xA82A);
/* Values for when to start. */
enum {
kTuneStartNow = 1, /* start after buffer is implied */
kTuneDontClipNotes = 2, /* allow notes to finish their durations outside sample */
kTuneExcludeEdgeNotes = 4, /* dont play notes that start at end of tune */
kTuneQuickStart = 8, /* Leave all the controllers where they are, ignore start time */
kTuneLoopUntil = 16, /* loop a queued tune if there's nothing else in the queue*/
kTunePlayDifference = 32, /* by default, the tune difference is skipped*/
kTunePlayConcurrent = 64, /* dont block the next tune sequence with this one*/
kTuneStartNewMaster = 16384
};
EXTERN_API( ComponentResult )
TuneQueue (TunePlayer tp,
unsigned long * tune,
Fixed tuneRate,
unsigned long tuneStartPosition,
unsigned long tuneStopPosition,
unsigned long queueFlags,
TuneCallBackUPP callBackProc,
long refCon) FIVEWORDINLINE(0x2F3C, 0x001C, 0x000A, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneInstant (TunePlayer tp,
unsigned long * tune,
unsigned long tunePosition) FIVEWORDINLINE(0x2F3C, 0x0008, 0x000B, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneGetStatus (TunePlayer tp,
TuneStatus * status) FIVEWORDINLINE(0x2F3C, 0x0004, 0x000C, 0x7000, 0xA82A);
/* Values for stopping. */
enum {
kTuneStopFade = 1, /* do a quick, synchronous fadeout */
kTuneStopSustain = 2, /* don't silece notes */
kTuneStopInstant = 4, /* silence notes fast (else, decay them) */
kTuneStopReleaseChannels = 8 /* afterwards, let the channels go */
};
EXTERN_API( ComponentResult )
TuneStop (TunePlayer tp,
long stopFlags) FIVEWORDINLINE(0x2F3C, 0x0004, 0x000D, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneSetVolume (TunePlayer tp,
Fixed volume) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0010, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneGetVolume (TunePlayer tp) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0011, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TunePreroll (TunePlayer tp) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0012, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneUnroll (TunePlayer tp) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0013, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneSetNoteChannels (TunePlayer tp,
unsigned long count,
NoteChannel * noteChannelList,
TunePlayCallBackUPP playCallBackProc,
long refCon) FIVEWORDINLINE(0x2F3C, 0x0010, 0x0014, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneSetPartTranspose (TunePlayer tp,
unsigned long part,
long transpose,
long velocityShift) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0015, 0x7000, 0xA82A);
EXTERN_API( NoteAllocator )
TuneGetNoteAllocator (TunePlayer tp) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0017, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneSetSofter (TunePlayer tp,
long softer) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0018, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneTask (TunePlayer tp) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0019, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneSetBalance (TunePlayer tp,
long balance) FIVEWORDINLINE(0x2F3C, 0x0004, 0x001A, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneSetSoundLocalization (TunePlayer tp,
Handle data) FIVEWORDINLINE(0x2F3C, 0x0004, 0x001B, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneSetHeaderWithSize (TunePlayer tp,
unsigned long * header,
unsigned long size) FIVEWORDINLINE(0x2F3C, 0x0008, 0x001C, 0x7000, 0xA82A);
/* flags for part mix. */
enum {
kTuneMixMute = 1, /* disable a part */
kTuneMixSolo = 2 /* if any parts soloed, play only soloed parts */
};
EXTERN_API( ComponentResult )
TuneSetPartMix (TunePlayer tp,
unsigned long partNumber,
long volume,
long balance,
long mixFlags) FIVEWORDINLINE(0x2F3C, 0x0010, 0x001D, 0x7000, 0xA82A);
EXTERN_API( ComponentResult )
TuneGetPartMix (TunePlayer tp,
unsigned long partNumber,
long * volumeOut,
long * balanceOut,
long * mixFlagsOut) FIVEWORDINLINE(0x2F3C, 0x0010, 0x001E, 0x7000, 0xA82A);
typedef unsigned long MusicOpWord;
typedef MusicOpWord * MusicOpWordPtr;
/* QuickTime Music Track Event Formats:
At this time, QuickTime music tracks support 5 different event types -- REST events,
short NOTE events, short CONTROL events, short GENERAL events, Long NOTE events,
long CONTROL events, and variable GENERAL events.
o REST Event (4 bytes/event):
(0 0 0) (5-bit UNUSED) (24-bit Rest Duration)
o.Short NOTE Events (4 bytes/event):
(0 0 1) (5-bit Part) (6-bit Pitch) (7-bit Volume) (11-bit Duration)
where: Pitch is offset by 32 (Actual pitch = pitch field + 32)
o.Short CONTROL Events (4 bytes/event):
(0 1 0) (5-bit Part) (8-bit Controller) (1-bit UNUSED) (1-bit Sign) (7-bit MSB) (7-bit LSB)
( or 15-bit Signed Value)
o Short GENERAL Event (4 bytes/event):
(0 1 1) (1-bit UNUSED) (12-bit Sub-Type) (16-bit Value)
o Long NOTE Events (8 bytes/event):
(1 0 0 1) (12-bit Part) (1-bit UNUSED) (7-bit Pitch) (1-bit UNUSED) (7-bit Volume)
(1 0) (8-bit UNUSED) (22-bit Duration)
o.Long CONTROL Event (8 bytes/event):
(1 0 1 0) (12-bit Part) (16-bit Value MSB)
(1 0) (14-bit Controller) (16-bit Value LSB)
o.Long KNOB Event (8 bytes/event):
(1 0 1 1) (12-bit Sub-Type) (16-bit Value MSB)
(1 0) (14-bit KNOB) (16-bit Value LSB)
o.Variable GENERAL Length Events (N bytes/event):
(1 1 1 1) (12-bit Sub-Type) (16-bit Length)
:
(32-bit Data values)
:
(1 1) (14-bit UNUSED) (16-bit Length)
where: Length field is the number of LONG words in the record.
Lengths include the first and last long words (Minimum length = 2)
The following event type values have not been used yet and are reserved for
future expansion:
o (1 0 0 0) (8 bytes/event)
o (1 1 0 0) (N bytes/event)
o (1 1 0 1) (N bytes/event)
o (1 1 1 0) (N bytes/event)
For all events, the following generalizations apply:
- All duration values are specified in Millisecond units.
- Pitch values are intended to map directly to the MIDI key numbers.
- Controllers from 0 to 127 correspond to the standard MIDI controllers.
Controllers greater than 127 correspond to other controls (i.e., Pitch Bend,
Key Pressure, and Channel Pressure).
*/
/* Defines for the implemented music event data fields*/
enum {
kRestEventType = 0x00000000, /* lower 3-bits */
kNoteEventType = 0x00000001, /* lower 3-bits */
kControlEventType = 0x00000002, /* lower 3-bits */
kMarkerEventType = 0x00000003, /* lower 3-bits */
kUndefined1EventType = 0x00000008, /* 4-bits */
kXNoteEventType = 0x00000009, /* 4-bits */
kXControlEventType = 0x0000000A, /* 4-bits */
kKnobEventType = 0x0000000B, /* 4-bits */
kUndefined2EventType = 0x0000000C, /* 4-bits */
kUndefined3EventType = 0x0000000D, /* 4-bits */
kUndefined4EventType = 0x0000000E, /* 4-bits */
kGeneralEventType = 0x0000000F, /* 4-bits */
kXEventLengthBits = 0x00000002, /* 2 bits: indicates 8-byte event record */
kGeneralEventLengthBits = 0x00000003, /* 2 bits: indicates variable length event record */
kEventLen = 1L, /* length of events in long words */
kXEventLen = 2L,
kRestEventLen = kEventLen, /* length of events in long words */
kNoteEventLen = kEventLen,
kControlEventLen = kEventLen,
kMarkerEventLen = kEventLen,
kXNoteEventLen = kXEventLen,
kXControlEventLen = kXEventLen,
kGeneralEventLen = kXEventLen, /* 2 or more, however */
/* Universal Event Defines*/
kEventLengthFieldPos = 30, /* by looking at these two bits of the 1st or last word */
kEventLengthFieldWidth = 2, /* of an event you can determine the event length */
/* length field: 0 & 1 => 1 long; 2 => 2 longs; 3 => variable length */
kEventTypeFieldPos = 29, /* event type field for short events */
kEventTypeFieldWidth = 3, /* short type is 3 bits */
kXEventTypeFieldPos = 28, /* event type field for extended events */
kXEventTypeFieldWidth = 4, /* extended type is 4 bits */
kEventPartFieldPos = 24,
kEventPartFieldWidth = 5,
kXEventPartFieldPos = 16, /* in the 1st long word */
kXEventPartFieldWidth = 12, /* Rest Events*/
kRestEventDurationFieldPos = 0,
kRestEventDurationFieldWidth = 24,
kRestEventDurationMax = ((1L << kRestEventDurationFieldWidth) - 1), /* Note Events*/
kNoteEventPitchFieldPos = 18,
kNoteEventPitchFieldWidth = 6,
kNoteEventPitchOffset = 32, /* add to value in pitch field to get actual pitch */
kNoteEventVolumeFieldPos = 11,
kNoteEventVolumeFieldWidth = 7,
kNoteEventVolumeOffset = 0, /* add to value in volume field to get actual volume */
kNoteEventDurationFieldPos = 0,
kNoteEventDurationFieldWidth = 11,
kNoteEventDurationMax = ((1L << kNoteEventDurationFieldWidth) - 1),
kXNoteEventPitchFieldPos = 0, /* in the 1st long word */
kXNoteEventPitchFieldWidth = 16,
kXNoteEventDurationFieldPos = 0, /* in the 2nd long word */
kXNoteEventDurationFieldWidth = 22,
kXNoteEventDurationMax = ((1L << kXNoteEventDurationFieldWidth) - 1),
kXNoteEventVolumeFieldPos = 22, /* in the 2nd long word */
kXNoteEventVolumeFieldWidth = 7, /* Control Events*/
kControlEventControllerFieldPos = 16,
kControlEventControllerFieldWidth = 8,
kControlEventValueFieldPos = 0,
kControlEventValueFieldWidth = 16,
kXControlEventControllerFieldPos = 0, /* in the 2nd long word */
kXControlEventControllerFieldWidth = 16,
kXControlEventValueFieldPos = 0, /* in the 1st long word */
kXControlEventValueFieldWidth = 16, /* Knob Events*/
kKnobEventValueHighFieldPos = 0, /* 1st long word */
kKnobEventValueHighFieldWidth = 16,
kKnobEventKnobFieldPos = 16, /* 2nd long word */
kKnobEventKnobFieldWidth = 14,
kKnobEventValueLowFieldPos = 0, /* 2nd long word */
kKnobEventValueLowFieldWidth = 16, /* Marker Events*/
kMarkerEventSubtypeFieldPos = 16,
kMarkerEventSubtypeFieldWidth = 8,
kMarkerEventValueFieldPos = 0,
kMarkerEventValueFieldWidth = 16, /* General Events*/
kGeneralEventSubtypeFieldPos = 16, /* in the last long word */
kGeneralEventSubtypeFieldWidth = 14,
kGeneralEventLengthFieldPos = 0, /* in the 1st & last long words */
kGeneralEventLengthFieldWidth = 16
};
if TARGET_RT_LITTLE_ENDIAN
enum {
kEndMarkerValue = 0x00000060
};
else
enum {
kEndMarkerValue = 0x60000000
};
endif /* TARGET_RT_LITTLE_ENDIAN */
/* macros for extracting various fields from the QuickTime event records*/
define qtma_MASK(bitWidth) ((1L << (bitWidth)) - 1)
define qtma_EXT(val, pos, width) ((EndianU32_BtoN(val) >> (pos)) & qtma_MASK(width))
define qtma_EventLengthForward(xP,ulen) \
{ \
unsigned long _ext; \
unsigned long *lP = (unsigned long *)(xP); \
_ext = qtma_EXT(*lP, kEventLengthFieldPos, kEventLengthFieldWidth); \
if (_ext != 3) { \
ulen = (_ext < 2) ? 1 : 2; \
} else { \
ulen = (unsigned short)qtma_EXT(*lP, kGeneralEventLengthFieldPos, kGeneralEventLengthFieldWidth); \
if (ulen < 2) { \
ulen = lP[1]; \
} \
} \
}
define qtma_EventLengthBackward(xP,ulen) \
{ \
unsigned long _ext; \
unsigned long *lP = (unsigned long *)(xP); \
_ext = qtma_EXT(*lP, kEventLengthFieldPos, kEventLengthFieldWidth); \
if (_ext != 3) { \
ulen = (_ext < 2) ? 1 : 2; \
} else { \
ulen = (unsigned short)qtma_EXT(*lP, kGeneralEventLengthFieldPos, kGeneralEventLengthFieldWidth); \
if (ulen < 2) { \
ulen = lP[-1]; \
} \
} \
}
define qtma_EventType(x) ((qtma_EXT(x, kEventTypeFieldPos, kEventTypeFieldWidth) > 3) ? qtma_EXT(x, kXEventTypeFieldPos, kXEventTypeFieldWidth) : qtma_EXT(x, kEventTypeFieldPos, kEventTypeFieldWidth))
define qtma_RestDuration(x) (qtma_EXT(x, kRestEventDurationFieldPos, kRestEventDurationFieldWidth))
define qtma_Part(x) (qtma_EXT(x, kEventPartFieldPos, kEventPartFieldWidth))
define qtma_XPart(m, l) (qtma_EXT(m, kXEventPartFieldPos, kXEventPartFieldWidth))
define qtma_NotePitch(x) (qtma_EXT(x, kNoteEventPitchFieldPos, kNoteEventPitchFieldWidth) + kNoteEventPitchOffset)
define qtma_NoteVolume(x) (qtma_EXT(x, kNoteEventVolumeFieldPos, kNoteEventVolumeFieldWidth) + kNoteEventVolumeOffset)
define qtma_NoteDuration(x) (qtma_EXT(x, kNoteEventDurationFieldPos, kNoteEventDurationFieldWidth))
define qtma_NoteVelocity qtma_NoteVolume
define qtma_XNotePitch(m, l) (qtma_EXT(m, kXNoteEventPitchFieldPos, kXNoteEventPitchFieldWidth))
define qtma_XNoteVolume(m, l) (qtma_EXT(l, kXNoteEventVolumeFieldPos, kXNoteEventVolumeFieldWidth))
define qtma_XNoteDuration(m, l) (qtma_EXT(l, kXNoteEventDurationFieldPos, kXNoteEventDurationFieldWidth))
define qtma_XNoteVelocity qtma_XNoteVolume
define qtma_ControlController(x) (qtma_EXT(x, kControlEventControllerFieldPos, kControlEventControllerFieldWidth))
define qtma_ControlValue(x) (qtma_EXT(x, kControlEventValueFieldPos, kControlEventValueFieldWidth))
define qtma_XControlController(m, l) (qtma_EXT(l, kXControlEventControllerFieldPos, kXControlEventControllerFieldWidth))
define qtma_XControlValue(m, l) (qtma_EXT(m, kXControlEventValueFieldPos, kXControlEventValueFieldWidth))
define qtma_MarkerSubtype(x) (qtma_EXT(x,kMarkerEventSubtypeFieldPos,kMarkerEventSubtypeFieldWidth))
define qtma_MarkerValue(x) (qtma_EXT(x, kMarkerEventValueFieldPos, kMarkerEventValueFieldWidth))
define qtma_KnobValue(m,l) ((qtma_EXT(m,kKnobEventValueHighFieldPos,kKnobEventValueHighFieldWidth) << 16) \
| (qtma_EXT(l,kKnobEventValueLowFieldPos,kKnobEventValueLowFieldWidth)))
define qtma_KnobKnob(m,l) (qtma_EXT(l,kKnobEventKnobFieldPos,kKnobEventKnobFieldWidth))
define qtma_GeneralSubtype(m,l) (qtma_EXT(l,kGeneralEventSubtypeFieldPos,kGeneralEventSubtypeFieldWidth))
define qtma_GeneralLength(m,l) (qtma_EXT(m,kGeneralEventLengthFieldPos,kGeneralEventLengthFieldWidth))
define qtma_StuffRestEvent(x, duration) ( \
x = (kRestEventType << kEventTypeFieldPos) \
| ((long)(duration) << kRestEventDurationFieldPos), \
x = EndianU32_NtoB(x) )
define qtma_StuffNoteEvent(x, part, pitch, volume, duration) ( \
x = (kNoteEventType << kEventTypeFieldPos) \
| ((long)(part) << kEventPartFieldPos) \
| (((long)(pitch) - kNoteEventPitchOffset) << kNoteEventPitchFieldPos) \
| (((long)(volume) - kNoteEventVolumeOffset) << kNoteEventVolumeFieldPos) \
| ((long)(duration) << kNoteEventDurationFieldPos), \
x = EndianU32_NtoB(x) )
define qtma_StuffControlEvent(x, part, control, value) ( \
x = (kControlEventType << kEventTypeFieldPos) \
| ((long)(part) << kEventPartFieldPos) \
| ((long)(control) << kControlEventControllerFieldPos)\
| ((long)((value) & qtma_MASK(kControlEventValueFieldWidth)) << kControlEventValueFieldPos), \
x = EndianU32_NtoB(x) )
define qtma_StuffMarkerEvent(x, markerType, markerValue) ( \
x = (kMarkerEventType << kEventTypeFieldPos) \
| ((long)(markerType) << kMarkerEventSubtypeFieldPos) \
| ((long)(markerValue) << kMarkerEventValueFieldPos), \
x = EndianU32_NtoB(x) )
define qtma_StuffXNoteEvent(w1, w2, part, pitch, volume, duration) ( \
w1 = (kXNoteEventType << kXEventTypeFieldPos) \
| ((long)(part) << kXEventPartFieldPos) \
| ((long)(pitch) << kXNoteEventPitchFieldPos), \
w1 = EndianU32_NtoB(w1), \
w2 = (kXEventLengthBits << kEventLengthFieldPos) \
| ((long)(duration) << kXNoteEventDurationFieldPos) \
| ((long)(volume) << kXNoteEventVolumeFieldPos), \
w2 = EndianU32_NtoB(w2) )
define qtma_StuffXControlEvent(w1, w2, part, control, value) ( \
w1 = (kXControlEventType << kXEventTypeFieldPos) \
| ((long)(part) << kXEventPartFieldPos) \
| ((long)((value) & qtma_MASK(kXControlEventValueFieldWidth)) << kXControlEventValueFieldPos), \
w1 = EndianU32_NtoB(w1), \
w2 = (kXEventLengthBits << kEventLengthFieldPos) \
| ((long)(control) << kXControlEventControllerFieldPos), \
w2 = EndianU32_NtoB(w2) )
define qtma_StuffKnobEvent(w1, w2, part, knob, value) ( \
w1 = (kKnobEventType << kXEventTypeFieldPos) \
| ((long)(part) << kXEventPartFieldPos) \
| ((long)(value >> 16) << kKnobEventValueLowFieldPos), \
w1 = EndianU32_NtoB(w1), \
w2 = (kXEventLengthBits << kEventLengthFieldPos) \
| ((long)(knob) << kKnobEventKnobFieldPos) \
| ((long)(value & 0xFFFF) << kKnobEventValueLowFieldPos), \
w2 = EndianU32_NtoB(w2) )
define qtma_StuffGeneralEvent(w1,w2,part,subType,length) ( \
w1 = (kGeneralEventType << kXEventTypeFieldPos) \
| ((long)(part) << kXEventPartFieldPos) \
| ((long)(length) << kGeneralEventLengthFieldPos), \
w1 = EndianU32_NtoB(w1), \
w2 = (kGeneralEventLengthBits << kEventLengthFieldPos) \
| ((long)(subType) << kGeneralEventSubtypeFieldPos) \
| ((long)(length) << kGeneralEventLengthFieldPos), \
w2 = EndianU32_NtoB(w2) )
define qtma_NeedXGeneralEvent(length) (((unsigned long)(length)) > (unsigned long)0xffff)
/* General Event Defined Types*/
enum {
kGeneralEventNoteRequest = 1, /* Encapsulates NoteRequest data structure */
kGeneralEventPartKey = 4,
kGeneralEventTuneDifference = 5, /* Contains a standard sequence, with end marker, for the tune difference of a sequence piece (halts QuickTime 2.0 Music) */
kGeneralEventAtomicInstrument = 6, /* Encapsulates AtomicInstrument record */
kGeneralEventKnob = 7, /* knobID/knobValue pairs; smallest event is 4 longs */
kGeneralEventMIDIChannel = 8, /* used in tune header, one longword identifies the midi channel it originally came from */
kGeneralEventPartChange = 9, /* used in tune sequence, one longword identifies the tune part which can now take over this part's note channel (similar to program change) (halts QuickTime 2.0 Music)*/
kGeneralEventNoOp = 10, /* guaranteed to do nothing and be ignored. (halts QuickTime 2.0 Music) */
kGeneralEventUsedNotes = 11, /* four longwords specifying which midi notes are actually used, 0..127 msb to lsb */
kGeneralEventPartMix = 12 /* three longwords: Fixed volume, long balance, long flags */
};
/* Marker Event Defined Types // marker is 60 ee vv vv in hex, where e = event type, and v = value*/
enum {
kMarkerEventEnd = 0, /* marker type 0 means: value 0 - stop, value != 0 - ignore*/
kMarkerEventBeat = 1, /* value 0 = single beat; anything else is 65536ths-of-a-beat (quarter note)*/
kMarkerEventTempo = 2 /* value same as beat marker, but indicates that a tempo event should be computed (based on where the next beat or tempo marker is) and emitted upon export*/
};
enum {
kCurrentlyNativeEndian = 1,
kCurrentlyNotNativeEndian = 2
};
/* UPP call backs */
if OPAQUE_UPP_TYPES
EXTERN_API(MusicMIDISendUPP)
NewMusicMIDISendUPP (MusicMIDISendProcPtr userRoutine);
EXTERN_API(MusicMIDIReadHookUPP)
NewMusicMIDIReadHookUPP (MusicMIDIReadHookProcPtr userRoutine);
EXTERN_API(MusicOfflineDataUPP)
NewMusicOfflineDataUPP (MusicOfflineDataProcPtr userRoutine);
EXTERN_API(TuneCallBackUPP)
NewTuneCallBackUPP (TuneCallBackProcPtr userRoutine);
EXTERN_API(TunePlayCallBackUPP)
NewTunePlayCallBackUPP (TunePlayCallBackProcPtr userRoutine);
EXTERN_API(void)
DisposeMusicMIDISendUPP (MusicMIDISendUPP userUPP);
EXTERN_API(void)
DisposeMusicMIDIReadHookUPP (MusicMIDIReadHookUPP userUPP);
EXTERN_API(void)
DisposeMusicOfflineDataUPP (MusicOfflineDataUPP userUPP);
EXTERN_API(void)
DisposeTuneCallBackUPP (TuneCallBackUPP userUPP);
EXTERN_API(void)
DisposeTunePlayCallBackUPP (TunePlayCallBackUPP userUPP);
EXTERN_API(ComponentResult)
InvokeMusicMIDISendUPP (ComponentInstance self,
long refCon,
MusicMIDIPacket * mmp,
MusicMIDISendUPP userUPP);
EXTERN_API(ComponentResult)
InvokeMusicMIDIReadHookUPP (MusicMIDIPacket * mp,
long myRefCon,
MusicMIDIReadHookUPP userUPP);
EXTERN_API(ComponentResult)
InvokeMusicOfflineDataUPP (Ptr SoundData,
long numBytes,
long myRefCon,
MusicOfflineDataUPP userUPP);
EXTERN_API(void)
InvokeTuneCallBackUPP (const TuneStatus * status,
long refCon,
TuneCallBackUPP userUPP);
EXTERN_API(void)
InvokeTunePlayCallBackUPP (unsigned long * event,
long seed,
long refCon,
TunePlayCallBackUPP userUPP);
else
enum { uppMusicMIDISendProcInfo = 0x00000FF0 }; /* pascal 4_bytes Func(4_bytes, 4_bytes, 4_bytes) */
enum { uppMusicMIDIReadHookProcInfo = 0x000003F0 }; /* pascal 4_bytes Func(4_bytes, 4_bytes) */
enum { uppMusicOfflineDataProcInfo = 0x00000FF0 }; /* pascal 4_bytes Func(4_bytes, 4_bytes, 4_bytes) */
enum { uppTuneCallBackProcInfo = 0x000003C0 }; /* pascal no_return_value Func(4_bytes, 4_bytes) */
enum { uppTunePlayCallBackProcInfo = 0x00000FC0 }; /* pascal no_return_value Func(4_bytes, 4_bytes, 4_bytes) */
#define NewMusicMIDISendUPP(userRoutine) (MusicMIDISendUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppMusicMIDISendProcInfo, GetCurrentArchitecture())
#define NewMusicMIDIReadHookUPP(userRoutine) (MusicMIDIReadHookUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppMusicMIDIReadHookProcInfo, GetCurrentArchitecture())
#define NewMusicOfflineDataUPP(userRoutine) (MusicOfflineDataUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppMusicOfflineDataProcInfo, GetCurrentArchitecture())
#define NewTuneCallBackUPP(userRoutine) (TuneCallBackUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppTuneCallBackProcInfo, GetCurrentArchitecture())
#define NewTunePlayCallBackUPP(userRoutine) (TunePlayCallBackUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppTunePlayCallBackProcInfo, GetCurrentArchitecture())
#define DisposeMusicMIDISendUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#define DisposeMusicMIDIReadHookUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#define DisposeMusicOfflineDataUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#define DisposeTuneCallBackUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#define DisposeTunePlayCallBackUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#define InvokeMusicMIDISendUPP(self, refCon, mmp, userUPP) (ComponentResult)CALL_THREE_PARAMETER_UPP((userUPP), uppMusicMIDISendProcInfo, (self), (refCon), (mmp))
#define InvokeMusicMIDIReadHookUPP(mp, myRefCon, userUPP) (ComponentResult)CALL_TWO_PARAMETER_UPP((userUPP), uppMusicMIDIReadHookProcInfo, (mp), (myRefCon))
#define InvokeMusicOfflineDataUPP(SoundData, numBytes, myRefCon, userUPP) (ComponentResult)CALL_THREE_PARAMETER_UPP((userUPP), uppMusicOfflineDataProcInfo, (SoundData), (numBytes), (myRefCon))
#define InvokeTuneCallBackUPP(status, refCon, userUPP) CALL_TWO_PARAMETER_UPP((userUPP), uppTuneCallBackProcInfo, (status), (refCon))
#define InvokeTunePlayCallBackUPP(event, seed, refCon, userUPP) CALL_THREE_PARAMETER_UPP((userUPP), uppTunePlayCallBackProcInfo, (event), (seed), (refCon))
endif
/* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
define NewMusicMIDISendProc(userRoutine) NewMusicMIDISendUPP(userRoutine)
define NewMusicMIDIReadHookProc(userRoutine) NewMusicMIDIReadHookUPP(userRoutine)
define NewMusicOfflineDataProc(userRoutine) NewMusicOfflineDataUPP(userRoutine)
define NewTuneCallBackProc(userRoutine) NewTuneCallBackUPP(userRoutine)
define NewTunePlayCallBackProc(userRoutine) NewTunePlayCallBackUPP(userRoutine)
define CallMusicMIDISendProc(userRoutine, self, refCon, mmp) InvokeMusicMIDISendUPP(self, refCon, mmp, userRoutine)
define CallMusicMIDIReadHookProc(userRoutine, mp, myRefCon) InvokeMusicMIDIReadHookUPP(mp, myRefCon, userRoutine)
define CallMusicOfflineDataProc(userRoutine, SoundData, numBytes, myRefCon) InvokeMusicOfflineDataUPP(SoundData, numBytes, myRefCon, userRoutine)
define CallTuneCallBackProc(userRoutine, status, refCon) InvokeTuneCallBackUPP(status, refCon, userRoutine)
define CallTunePlayCallBackProc(userRoutine, event, seed, refCon) InvokeTunePlayCallBackUPP(event, seed, refCon, userRoutine)
/* selectors for component calls */
enum {
kQTMIDIGetMIDIPortsSelect = 0x0001,
kQTMIDIUseSendPortSelect = 0x0002,
kQTMIDISendMIDISelect = 0x0003,
kQTMIDIUseReceivePortSelect = 0x0004,
kMusicGetDescriptionSelect = 0x0001,
kMusicGetPartSelect = 0x0002,
kMusicSetPartSelect = 0x0003,
kMusicSetPartInstrumentNumberSelect = 0x0004,
kMusicGetPartInstrumentNumberSelect = 0x0005,
kMusicStorePartInstrumentSelect = 0x0006,
kMusicGetPartAtomicInstrumentSelect = 0x0009,
kMusicSetPartAtomicInstrumentSelect = 0x000A,
kMusicGetInstrumentKnobDescriptionObsoleteSelect = 0x000D,
kMusicGetDrumKnobDescriptionObsoleteSelect = 0x000E,
kMusicGetKnobDescriptionObsoleteSelect = 0x000F,
kMusicGetPartKnobSelect = 0x0010,
kMusicSetPartKnobSelect = 0x0011,
kMusicGetKnobSelect = 0x0012,
kMusicSetKnobSelect = 0x0013,
kMusicGetPartNameSelect = 0x0014,
kMusicSetPartNameSelect = 0x0015,
kMusicFindToneSelect = 0x0016,
kMusicPlayNoteSelect = 0x0017,
kMusicResetPartSelect = 0x0018,
kMusicSetPartControllerSelect = 0x0019,
kMusicGetPartControllerSelect = 0x001A,
kMusicGetMIDIProcSelect = 0x001B,
kMusicSetMIDIProcSelect = 0x001C,
kMusicGetInstrumentNamesSelect = 0x001D,
kMusicGetDrumNamesSelect = 0x001E,
kMusicGetMasterTuneSelect = 0x001F,
kMusicSetMasterTuneSelect = 0x0020,
kMusicGetInstrumentAboutInfoSelect = 0x0022,
kMusicGetDeviceConnectionSelect = 0x0023,
kMusicUseDeviceConnectionSelect = 0x0024,
kMusicGetKnobSettingStringsSelect = 0x0025,
kMusicGetMIDIPortsSelect = 0x0026,
kMusicSendMIDISelect = 0x0027,
kMusicReceiveMIDISelect = 0x0028,
kMusicStartOfflineSelect = 0x0029,
kMusicSetOfflineTimeToSelect = 0x002A,
kMusicGetInstrumentKnobDescriptionSelect = 0x002B,
kMusicGetDrumKnobDescriptionSelect = 0x002C,
kMusicGetKnobDescriptionSelect = 0x002D,
kMusicGetInfoTextSelect = 0x002E,
kMusicGetInstrumentInfoSelect = 0x002F,
kMusicTaskSelect = 0x0031,
kMusicSetPartInstrumentNumberInterruptSafeSelect = 0x0032,
kMusicSetPartSoundLocalizationSelect = 0x0033,
kMusicGenericConfigureSelect = 0x0100,
kMusicGenericGetPartSelect = 0x0101,
kMusicGenericGetKnobListSelect = 0x0102,
kMusicGenericSetResourceNumbersSelect = 0x0103,
kMusicDerivedMIDISendSelect = 0x0200,
kMusicDerivedSetKnobSelect = 0x0201,
kMusicDerivedSetPartSelect = 0x0202,
kMusicDerivedSetInstrumentSelect = 0x0203,
kMusicDerivedSetPartInstrumentNumberSelect = 0x0204,
kMusicDerivedSetMIDISelect = 0x0205,
kMusicDerivedStorePartInstrumentSelect = 0x0206,
kMusicDerivedOpenResFileSelect = 0x0207,
kMusicDerivedCloseResFileSelect = 0x0208,
kInstrumentGetInstSelect = 0x0001,
kInstrumentGetInfoSelect = 0x0002,
kInstrumentInitializeSelect = 0x0003,
kInstrumentOpenComponentResFileSelect = 0x0004,
kInstrumentCloseComponentResFileSelect = 0x0005,
kInstrumentGetComponentRefConSelect = 0x0006,
kInstrumentSetComponentRefConSelect = 0x0007,
kInstrumentGetSynthesizerTypeSelect = 0x0008,
kNARegisterMusicDeviceSelect = 0x0000,
kNAUnregisterMusicDeviceSelect = 0x0001,
kNAGetRegisteredMusicDeviceSelect = 0x0002,
kNASaveMusicConfigurationSelect = 0x0003,
kNANewNoteChannelSelect = 0x0004,
kNADisposeNoteChannelSelect = 0x0005,
kNAGetNoteChannelInfoSelect = 0x0006,
kNAPrerollNoteChannelSelect = 0x0007,
kNAUnrollNoteChannelSelect = 0x0008,
kNASetNoteChannelVolumeSelect = 0x000B,
kNAResetNoteChannelSelect = 0x000C,
kNAPlayNoteSelect = 0x000D,
kNASetControllerSelect = 0x000E,
kNASetKnobSelect = 0x000F,
kNAFindNoteChannelToneSelect = 0x0010,
kNASetInstrumentNumberSelect = 0x0011,
kNAPickInstrumentSelect = 0x0012,
kNAPickArrangementSelect = 0x0013,
kNASetDefaultMIDIInputSelect = 0x0015,
kNAGetDefaultMIDIInputSelect = 0x0016,
kNAUseDefaultMIDIInputSelect = 0x0019,
kNALoseDefaultMIDIInputSelect = 0x001A,
kNAStuffToneDescriptionSelect = 0x001B,
kNACopyrightDialogSelect = 0x001C,
kNAGetIndNoteChannelSelect = 0x001F,
kNAGetMIDIPortsSelect = 0x0021,
kNAGetNoteRequestSelect = 0x0022,
kNASendMIDISelect = 0x0023,
kNAPickEditInstrumentSelect = 0x0024,
kNANewNoteChannelFromAtomicInstrumentSelect = 0x0025,
kNASetAtomicInstrumentSelect = 0x0026,
kNAGetKnobSelect = 0x0028,
kNATaskSelect = 0x0029,
kNASetNoteChannelBalanceSelect = 0x002A,
kNASetInstrumentNumberInterruptSafeSelect = 0x002B,
kNASetNoteChannelSoundLocalizationSelect = 0x002C,
kNAGetControllerSelect = 0x002D,
kTuneSetHeaderSelect = 0x0004,
kTuneGetTimeBaseSelect = 0x0005,
kTuneSetTimeScaleSelect = 0x0006,
kTuneGetTimeScaleSelect = 0x0007,
kTuneGetIndexedNoteChannelSelect = 0x0008,
kTuneQueueSelect = 0x000A,
kTuneInstantSelect = 0x000B,
kTuneGetStatusSelect = 0x000C,
kTuneStopSelect = 0x000D,
kTuneSetVolumeSelect = 0x0010,
kTuneGetVolumeSelect = 0x0011,
kTunePrerollSelect = 0x0012,
kTuneUnrollSelect = 0x0013,
kTuneSetNoteChannelsSelect = 0x0014,
kTuneSetPartTransposeSelect = 0x0015,
kTuneGetNoteAllocatorSelect = 0x0017,
kTuneSetSofterSelect = 0x0018,
kTuneTaskSelect = 0x0019,
kTuneSetBalanceSelect = 0x001A,
kTuneSetSoundLocalizationSelect = 0x001B,
kTuneSetHeaderWithSizeSelect = 0x001C,
kTuneSetPartMixSelect = 0x001D,
kTuneGetPartMixSelect = 0x001E
};
if PRAGMA_STRUCT_ALIGN
#pragma options align=reset
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
#pragma pack()
endif
ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
endif
ifdef __cplusplus
}
endif
endif /* __QUICKTIMEMUSIC__ */
(C) Æliens
04/09/2009
You may not copy or print any of this material without explicit permission of the author or the publisher.
In case of other copyright issues, contact the author.
