Техническое примечание TN2291

AUInstrumentBase изменяется для Льва Mac OS X

Это Техническое примечание перечисляет изменения, внесенные в AUInstrumentBase классы для Льва Mac OS X. При создании Аудиоустройства на Льве Mac OS X, которые используют эти классы предприятия коммунального обслуживания, необходимо будет обновить проект соответственно.

Введение

AUInstrumentBase

Новые методы

Удаленные методы

SynthNote

SynthElement

Удаленные методы

MidiControls

SynthGroupElement

Новые методы

Удаленные методы

Другие изменения

История версии документа

Введение

Папка AUInstrumentBase является частью инструментов Xcode Developer и расположена в Developer/Extras/CoreAudio/AudioUnits/AUPublic/AUInstrumentBase. Эта папка содержит много классов, используемых при создании Инструментов Аудиоустройства.

Много изменений были внесены в эти файлы предприятия коммунального обслуживания для Льва Mac OS X, как перечислено:

Назад к началу.

AUInstrumentBase

Новые методы

AUScope & Parts()
AUElement* GetPart(AudioUnitElement inElement)
virtual AUScope* GetScopeExtended(AudioUnitScope inScope)
virtual void CreateExtendedElements()

Эти методы позволяют подклассам использовать объем Части, представляющий определенные инструменты, патчи и задающий связанный с AUInstrumentBase.

Удаленные методы

MidiControls* GetControls( MusicDeviceGroupID inChannel)

Уведомления MIDI обрабатываются через методы, вызванные непосредственно на надлежащем SynthGroupElement экземпляр.

Назад к началу.

SynthNote

AttackNote() теперь возвраты a bool - Это позволяет SynthElement не поместить a SynthNote экземпляр в активную очередь, если примечание не будет играться (вследствие речевой логики никакого вида).
AttackNote() параметр 4 (inAbsoluteSampleFrame) измененный от SInt64 к UInt64 - Запустите кадр всегда положителен, и без знака в другом использовании в системе. Это также позволяет больше кадров, прежде чем перенесется значение.
Render() берет дополнительный параметр, первый параметр: inAbsoluteSampleFrame - Это должно позволить подклассу обрабатывать, «будет эта логика» игры примечания (видеть AttackNote ()).
Attack() теперь возвраты a bool.
GetState() возвраты SynthNoteState перечислимый тип - задействованное возвращаемое значение является этим типом.
GetAbsoluteStartFrame() теперь возвраты UInt64 вместо SInt64 - Запустите кадр всегда положителен, и без знака в другом использовании в системе.
PitchBend() теперь GetPitchBend() - Старое название вводило в заблуждение - казался, что оно выполнило действие, когда это - просто 'метод get'.
SampleRate() является виртуальным - Как Frequency() подкласс может хотеть переопределить это.

Назад к началу.

SynthElement

Удаленные методы

GetName()
SetName()

SynthElement получен из AUElement который уже имеет эти методы, и они являются невиртуальными. Переопределение на этом уровне могло привести к противоречивым результатам.

MidiControls

MidiControls был продвинут, чтобы быть подклассом нового вызванного базового класса MIDIControlHandler который определяет полезный интерфейс для работы с событиями MIDI. Константы были перемещены в заголовок базового класса.

Назад к началу.

SynthGroupElement

Новые методы

virtual NoteOn()
NoteFastReleased()
ChannelMessage()

Удаленные методы

GetOutputBus()
SetOutputBus()

Для многоканального инструмента не целесообразно понятие единственного индекса шины. Это состояние лучше обрабатывается подклассами.

Другие изменения

Render() берет дополнительный inAbsoluteSampleFrame и AUScope & параметры - Демонстрационный кадр необходим, чтобы позволить примечанию отслеживать его точное место в его временной шкале воспроизведения. AUScope позволяет различным примечаниям воспроизводить через различные выходные шины.
NoteOff() был сделан virtual.

Назад к началу.

История версии документа

Дата	Примечания
29.11.2011	Новый документ, описывающий изменения, внесенные в файлы предприятия коммунального обслуживания, которые являются частью папки AUInstrumentBase для Льва Mac OS X.