Обзор

«Простые» модули эффекта воздействуют на отдельные аудиосэмплы, не рассматривая отношения одного аудиосэмпла другому, и не используя буфер обработки. Вы создаете такой модуль эффекта в этой главе, далее упрощенной путем игнорирования некоторых усовершенствованных функций аудиоустройства: пользовательское представление и пользовательские свойства.

Простые модули эффекта могут сделать очень основной DSP, такой как:

• Уровень изменения

• Добавьте тремоло

Монофоническое тремоло является непрерывным колеблющимся, произведенным путем варьирования усиления звукового канала в низкой частоте на порядке некоторых Герц. Это число иллюстрирует монофоническое тремоло, варьирующееся от полного усиления до тишины:

Тремоло стерео подобно, но включает непрерывное левое/правильное панорамирование в низкой частоте.

В этой главе Вы разрабатываете и создаете монофонический эффект тремоло, использующий универсальное представление. Шаги, описанные подробно в следующих разделах:

1. Установите комплект разработчика Core Audio, если Вы уже не сделали так.

2. Выполните некоторую дизайнерскую работу, включая:

   • Укажите вид DSP, который выполнит Ваше аудиоустройство

   • Разработайте интерфейс параметра

   • Разработайте предварительно установленный интерфейс фабрики

   • Определите конфигурационную информацию для своего пакета аудиоустройства, такого как подтип и коды производителя и номер версии

3. Создайте и сконфигурируйте проект XCode.

4. Реализуйте свое аудиоустройство:

   • Реализуйте параметр и задайте интерфейсы.

   • Реализуйте обработку сигналов — основа Вашего аудиоустройства.

5. Наконец, проверьте и протестируйте свое аудиоустройство.

Ваша среда разработки для создания любого аудиоустройства — простой или иначе — должна включать части, описанные под Требуемыми Инструментами для Разработки Аудиоустройства во Введении. Вы не должны посылать к документации XCode или Core Audio документацию SDK выполнить задачи в этой главе.

Установите комплект разработчика Core Audio

1. Если Вы уже не сделали так, установите новый Core Audio SDK. Это - часть установки Инструментов XCode на OS X DVD. Можно также загрузить его с веб-сайта разработчика Apple в этом расположении:

   http://developer .apple.com/sdk/

   Core Audio установщик SDK помещает суперклассы C++, пример проекты XCode и документация в этом расположении в Вашей системе:

   /Developer/Examples/CoreAudio

   SDK также устанавливает шаблоны проекта XCode для аудиоустройств в этом расположении в Вашей системе:

   /Library/Application Support/Apple/Developer Tools/Project Templates/

2. После установки SDK подтвердите, что XCode распознает шаблоны аудиоустройства, следующим образом:

   • Запустите XCode и затем выберите File> New Project.

   • В Окне помощника подтвердите, что существует группа Аудиоустройств.

   

   Подтвердив присутствие группы шаблона Audio Units, нажмите Cancel, и затем выйдите из XCode.

Укажите функцию своего аудиоустройства

С инструментами на месте, Вы начинаете свою разработку модуля эффекта путем описания его цифровой обработки сигналов. В этом случае Вы указываете аудиоустройство, обеспечивающее монофоническое тремоло в пользователе выбираемый уровень. Вы реализуете DSP позже, но установление вида с высоты птичьего полета передняя сторона позволяет Вам сузить шаги реализации.

Затем, выберите тип аудиоустройства на основе функции, которую выполнит аудиоустройство. Просмотрите различные типы стандартных аудиоустройств в AUComponent.h файл в платформе Аудиоустройства. Кроме того, обратитесь к описаниям типов в Спецификации Аудиоустройства. kAudioUnitType_Effect, с четырьмя кодами символа 'aufx', взгляды, надлежащие с этой целью.

Разработайте интерфейс параметра

В этом разделе Вы разрабатываете часть параметра программируемого интерфейса между Вашим аудиоустройством и его представлением. Конечные пользователи будут варьироваться эти параметры для управления аудиоустройством в режиме реального времени.

Во-первых, укажите, который приписывает звук, Вы хотели бы, чтобы пользователь был в состоянии управлять. Для этого проекта используйте следующее:

• Частота тремоло — число циклов в секунду тремоло.

• Глубина тремоло — соединение между входным сигналом и сигналом с тремоло применялось. На глубине 0% нет никакого эффекта тремоло. На глубине 100% эффект колеблется от полной амплитуды до тишины.

• Форма волны тремоло — форма эффекта тремоло, такого как синусоидальная волна или прямоугольная волна.

Во-вторых, укажите для каждого параметра:

• Имя пользовательского интерфейса, как это появляется в представлении аудиоустройства

• Программируемое имя, также названное параметром ID, используемый в GetParameterInfo метод в файле реализации аудиоустройства

• Единица измерения, такая как усиление, децибелы или герц

• Минимальное значение

• Максимальное значение

• Значение по умолчанию

Следующие таблицы указывают проект параметра. Вы будете использовать большинство этих значений непосредственно в Вашем коде. Указание «Описания» для Вашего преимущества при разработке и расширении аудиоустройства. Можно снова использовать описание позже в онлайн-справке или руководстве пользователя.

Просто добавить, удалить, и совершенствовать параметры позже. Например, при создании параметра корректировки уровня звука Вы могли бы запустить с линейной шкалы и более позднего изменения в логарифмическом масштабе. Для модуля тремоло Вы создаете, Вы могли бы позже решить добавить дополнительные формы волны тремоло.

Разработайте предварительные установки фабрики

Теперь, когда Вы указали параметры, можно указать интересные комбинации настроек или предварительных установок фабрики. Для модуля тремоло укажите две предварительных установки фабрики. Эти два, изобретенные для этого учебного руководства, обеспечивают два легко различимых эффекта:

Соберите конфигурационную информацию для пакета аудиоустройства

Теперь определите свою конфигурационную информацию пакета аудиоустройства, такую как имя и номер версии. Вы вводите эту информацию в исходные файлы своего проекта, как описано позже в Наборе Ваше Название компании в XCode. Вот то, что Вы определяете и собираете переднюю сторону:

• Английское имя пакета аудиоустройства, такое как Модуль Тремоло. Хост-приложения выведут на экран это имя, чтобы позволить пользователям выбрать Ваше аудиоустройство.

• Аудиоустройство программируемое имя, такое как TremoloUnit. Вы будете использовать это для именования проекта XCode, поочередно использующего это имя для основного класса аудиоустройства.

• Число версии комплекта аудиоустройства, такой как 1.0.2.

• Описание резюме пакета аудиоустройства, такое как «Версия 1.0 Модуля тремоло, copyright © 2006, Angry Audio». Это описание появляется в Поле версии окна Get Info пакета аудиоустройства в Средстве поиска.

• Подтип пакета аудиоустройства, четыре кода символа, предоставляющие некоторую индикацию (лицу) того, что делает Ваше аудиоустройство. Для этого аудиоустройства использовать 'tmlo'.

• Английское имя компании, такое как Сердитое Аудио. Эта строка появляется в аудиоустройстве универсальное представление.

• Компания программируемое имя, такой как angryaudio. Вы будете использовать эту строку в обратном идентификаторе стиля доменного имени для Вашего аудиоустройства.

• Четыре кода символа компании, такой как 'Aaud'.

  Вы получаете этот код из Apple, как “код создателя “, при помощи страницы Data Type Registration. В целях этого примера, для нашей фиктивной компании под названием Сердитое Аудио, мы будем использовать 'Aaud'.

• Обратный идентификатор доменного имени, такой как com.angryaudio.audiounit.TremoloUnit. Менеджер компонентов будет использовать это имя при идентификации аудиоустройства.

• Пользовательский значок, для дисплея в Какао универсальное представление — дополнительный, но приятная черта. Это должно быть так называемым значком «Small», как создано с приложением Композитора Значка Apple, доступным в Вашей системе в /Developer/Applications/Utilities папка.

Установите свое название компании в XCode

Установите свое название компании в XCode (с XCode, не работающим), если Вы уже не сделали так. Введите следующую команду в Терминал на одной строке:

defaults write com.apple.Xcode PBXCustomTemplateMacroDefinitions '{ORGANIZATIONNAME = "Angry Audio";}'

Теперь, когда Вы установили это так называемое «опытное» предпочтение, XCode помещает имя Вашей компании в уведомление об авторском праве в исходных файлах любого нового проекта.

Создайте и сконфигурируйте проект

Теперь Вы создаете и конфигурируете проект XCode для своего аудиоустройства. Этот раздел может казаться длинным — он включает много шагов и снимков экрана — но после того, как Вы знакомы с процессом конфигурации, можно выполнить его приблизительно через пять минут.

Запустите XCode и выполните эти шаги:

1. Выберите File> New Project

2. В Новом диалоговом окне Помощника проектного менеджера выберите шаблон Audio Unit Effect и нажмите Далее.

3. Назовите TremoloUnit проекта и укажите каталог проекта. Тогда нажмите Finish.

XCode создает файлы проекта для Вашего аудиоустройства, и окно проекта XCode открывается.

В этой точке XCode использовал шаблонный файл проекта аудиоустройства для создания подкласса AUEffectBase класс. Ваш пользовательский подкласс называют согласно имени Вашего проекта. Можно найти файл реализации пользовательского подкласса, TremoloUnit.cpp, в Исходной группе AU в области Xcode Groups & Files, показанной затем.

На более поздних шагах Вы отредактируете методы в своем пользовательском подклассе для переопределения методов суперкласса. TremoloUnit.cpp также содержит несколько методов от AUKernelBase класс помощника; это методы, которые Вы позже изменяете для выполнения цифровой обработки сигналов.

4. С Исходной группой AU, открытой как показано на предыдущем шаге, щелкнуть TremoloUnitVersion.h. Тогда нажмите кнопку на панели инструментов Editor, при необходимости, для отображения текстового редактора. Существует три значения для настройки в этом файле: kTremoloUnitVersion, TremoloUnit_COMP_SUBTYPE, и TremoloUnit_COMP_MANF.

Прокрутите вниз в области редактирования к определениям TremoloUnit_COMP_SUBTYPE и TremoloUnit_COMP_MANF. Настройте поле подтипа с кодом подтипа с четырьмя символами, который Вы выбрали. В этом примере, 'tmlo' указывает (разработчикам и пользователям), что аудиоустройство позволяет пользователю добавить тремоло.

Также настройте имя производителя с уникальной четырьмя символьными строками, идентифицирующими Вашу компанию.

Теперь установите номер версии для аудиоустройства. В TremoloUnitVersion.h файл, чуть выше определений для подтипа и производителя, Вы будете видеть оператор определения для kTremoloUnitVersion постоянный. По умолчанию шаблон устанавливает значение этой константы в 1.0.0, как представлено шестнадцатеричным числом 0x00010000. Измените это, если Вам нравится. Посмотрите Идентификацию Аудиоустройства для того, как создать шестнадцатеричный номер версии.

Сохраните TremoloUnitVersion.h файл.

5. Щелкните TremoloUnit.r файл ресурсов в «Исходной группе» Источника/AU в области Groups & Files. Существует два значения для настройки в этом файле: NAME и DESCRIPTION.

• NAME используется универсальным представлением для отображения и названия компании и имени аудиоустройства

• DESCRIPTION служит пунктом меню для пользователей, выбирающих Ваше аудиоустройство из хост-приложения.

Работать правильно с универсальным представлением, значением для NAME должен следовать за определенным образцом:

<company name>: <audio unit name>

Для этого примера используйте:

Angry Audio: Tremolo Unit

При установке названия компании с помощью предпочтения эксперта XCode, как описано ранее это будет уже существовать в NAME переменная для этого проекта; чтобы последовать этому примеру, все, что необходимо сделать, добавляет пространство между Тремоло и Модулем на само имя аудиоустройства.

Шаблон Xcode обеспечивает значение по умолчанию для DESCRIPTION. При настройке его сохраните его коротким так, чтобы строка работала хорошо со всплывающими меню. Данные показывают специализированное DESCRIPTION.

Как Вы видите в числе, файл ресурсов использует a #include оператор для импорта заголовочного файла Версии, который Вы настроили на шаге 4, TremoloUnitVersion.h. Файл ресурсов использует значения от того заголовочного файла для определения некоторых переменных, таких как подтип компонента (COMP_SUBTYPE) и производитель (COMP_MANUF).

Сохраните TremoloUnit.r файл ресурсов.

6. Откройте группу Ресурсов в области Groups & Files в окне проекта XCode и щелкните InfoPlist.strings файл.

Используя редактора, настройте значение для CFBundleGetInfoString с помощью значения Вы выбрали для описания резюме аудиоустройства. Число обеспечивает пример. Эта строка появляется в Поле версии окна Get Info пакета аудиоустройства в Средстве поиска. Сохраните InfoPlist.strings файл.

7. Откройте Целевую группу в области Groups & Files в окне проекта XCode. Дважды щелкните по пакету аудиоустройства, имеющему то же имя как Ваш проект — в этом случае, TremoloUnit.

Окно Target Info открывается. Щелкните по вкладке Properties.

На вкладке Properties окна Target Info обеспечьте значения для Идентификатора, Создателя, Версии, и, дополнительно, пути к файлу значка Средства поиска для пакета, который Вы помещаете в пакет Resources папка.

Поле идентификатора пакета аудиоустройства должно следовать за образцом:

com.<company_name>.audiounit.<audio_unit_name>

Для этого примера используйте идентификатор:

com.angryaudio.audiounit.TremoloUnit

Для значения Создателя используйте ту же четыре символьных строки, используемые для поля производителя на шаге 4.

XCode передает всю информацию от вкладки Properties в пакет аудиоустройства Info.plist файл. Можно открыться Info.plist файл, если требуется проверить его, непосредственно от этого диалогового окна с помощью кнопки «Open Info.plist as File» у основания окна.

По окончании закройтесь Info.plist файл (при открытии его) или закрывает окно Target Info.

8. Теперь сконфигурируйте процесс сборки проекта XCode для копирования пакета аудиоустройства в надлежащее расположение так, чтобы хост-приложения могли использовать его.

В окне проекта раскройте группу продуктов и Целевую группу, как показано в числе, так, чтобы Вы видели значок для самого пакета аудиоустройства (TremoloUnit.component) а также фазы сборки (под Targets/TremoloUnit).

9. Теперь добавьте новую фазу сборки. Щелкните правой кнопкой (или щелчок управления) по заключительной фазе сборки для TremoloUnit и выберите Add> New Build Phase> New Copy Files Build Phase.

Новая фаза сборки Файлов Копии появляется в конце списка, и диалоговое окно открывается, названная Фаза Файлов Копии для Информации «TremoloUnit».

Измените Место назначения, раскрывающееся на Абсолютный путь, как показано в числе.

Введите абсолютный целевой путь для созданного пакета аудиоустройства в поле Full Path.

Можно использовать любой из допустимых путей для пакетов аудиоустройства, как описано в Установке Аудиоустройства и Регистрации. С вводимым полным путем закройте диалоговое окно.

Теперь перетащите TremoloUnit.component значок от группы продуктов к новой фазе сборки.

Если Вы хотите путем двойного щелчка по серому значку фазы сборки Файлов Копии, можно позже изменить местоположение Файлов Копии. Также щелкните по значку Copy Files и затем нажмите кнопку Info на панели инструментов.

В этой точке Вы имеете, имеют создания для рабочего аудиоустройства. Вы еще не настроили его, чтобы сделать независимо от того, что случается так, что у Вас будет он, делают (в нашем данном случае, для обеспечения одноканального эффекта тремоло). Это - хорошая идея гарантировать, что можно создать его без ошибок, что можно проверить его с auval инструментом, и что можно использовать его в хост-приложении. Сделайте это на следующем шаге.

10. Разработайте проект. Можно сделать это любым из стандартных способов: нажмите кнопку Build на панели инструментов, или выберите Build из меню кнопки Build, или выберите Build> Build из главного меню или введите команду-B.

Если все будет в порядке, то Ваш проект создаст без ошибки.

Файлы копии создают фазу, которую Вы добавили на предыдущем шаге, гарантирует, что копия пакета аудиоустройства помещается в надлежащее расположение для Менеджера компонентов для нахождения его, когда запускается хост-приложение. Следующий шаг гарантирует, что это так и позволяет Вам протестировать это, он работает в хост-приложении.

Протестируйте неизмененное аудиоустройство

Для тестирования недавно созданного аудиоустройства используйте приложение AU Lab:

• Используйте auval инструмент, чтобы проверить, что OS X распознает Ваш новый пакет аудиоустройства

• Запустите приложение AU Lab

• Configure AU Lab, чтобы протестировать Ваше новое аудиоустройство и протестировать его

Команда Core Audio Apple предоставляет AU Lab в /Developer/Applications/Audio папка, вместе с документацией. Вы не должны обращаться к документации AU Lab для выполнения этой задачи. auval инструмент командной строки является частью стандартной установки OS X.

1. В Терминале введите команду auval -a. Если OS X распознает Ваш новый пакет аудиоустройства, Вы видите перечисление, подобное этому:

Если Ваш проект XCode создает без ошибки, но Вы не видите, что новое аудиоустройство связывается в списке, о котором сообщают auval инструмент, двойная проверка, чтобы Вы ввели корректный путь в фазу Файлов Копии, как описано на шаге 8 Набора Ваше Название компании в XCode.

2. Launch AU Lab и создает новый документ AU Lab. Если Вы не сконфигурировали AU Lab для использования стиля документа по умолчанию, Создавание Нового Окна документа открывается. Если AU Lab уже работала, выберите File> New для получения этого окна.

Гарантируйте, что конфигурация соответствует настройки, показанные в числе: встроенное Аудио для Аудиоустройства, Строки В для Входного Источника и Стерео для Каналов вывода. Оставьте вкладку Inputs окна несконфигурированной; Вы укажете ввод позже. Нажать «OK».

Новое окно AU Lab открывается, показывая канал вывода, который Вы указали.

3. Выберите Edit> Add Audio Unit Generator. Диалоговое окно открывается из окна AU Lab, чтобы позволить Вам указать модуль генератора для служения в качестве источника аудиосигналов.

В диалоговом окне гарантируйте, что модуль AUAudioFilePlayer выбран в раскрывающемся Генераторе. Чтобы последовать этому примеру, измените Название группы на Проигрыватель. Нажать «OK».

Окно AU Lab теперь показывает дорожку стереовхода. Кроме того, окно инспектора открылось для модуля проигрывателя. При закрытии инспектора можно вновь открыть его путем нажимания прямоугольной кнопки «AU» около вершины дорожки Проигрывателя.

4. Добавьте аудиофайл к списку Аудиофайлов в инспекторе проигрывателя окно. Сделайте это путем перетаскивания аудиофайла от Средства поиска, как показано. При помещении аудиофайла в инспектора проигрывателя окно позволяет Вам отправить аудио через новое аудиоустройство. Примерно любой аудиофайл сделает, несмотря на то, что непрерывный тон полезен для тестирования.

Now AU Lab сконфигурирована и готова протестировать Ваше аудиоустройство.

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

Меню открывается, перечисляя все аудиоустройства, доступные в Вашей системе, расположенной по категориям и производитель. Существует Сердитая Аудио группа в раскрывающемся, как показано в следующем числе.

Выберите свое новое аудиоустройство из Эффектов, которые открывает первая строка.

AU Lab открывает Какао Вашего аудиоустройства универсальное представление, появляющееся как служебное окно.

Универсальное представление выводит на экран интерфейс Вашего аудиоустройства, как это прибывает непосредственно из параметра и определений свойства, предоставленных шаблоном Xcode. Шаблон определяет аудиоустройство, обеспечивающее корректировку уровня. Его представление, созданное хост-приложением AU Lab, обладает управлением Усилением. Вы изменяете представление на более позднем шаге в этой задаче путем изменения определений параметра аудиоустройства.

Обратитесь к Таблице 3-1 для получения информации о том, где Вы определяете каждый элемент пользовательского интерфейса для универсального представления.

6. Щелкните по кнопке воспроизведения в инспекторе AUAudioFilePlayer для отправки аудио через неизмененное аудиоустройство. Это позволяет Вам гарантировать, что аудио действительно проходит через аудиоустройство. Варьируйтесь ползунок по универсальному представлению, поскольку Вы слушаете аудио, чтобы гарантировать, что работает параметр.

7. Сохраните документ AU Lab для использования позже, дав ему имя, такое как “Модуль Тремоло Test.trak”. Вы будете использовать его в заключительном разделе этой главы, Тест Ваше Завершенное Аудиоустройство.

Затем, Вы определите свой интерфейс параметра модуля эффекта тремоло для предоставления контроля за работой пользователей по уровню тремоло, глубине и форме волны.

Реализуйте интерфейс параметра

До этой точки в разработке Вашего аудиоустройства Вы коснулись очень небольшого количества кода. Здесь, Вы определяете параметры аудиоустройства путем редактирования исходных файлов для аудиоустройства пользовательский подкласс: TremoloUnit.h и TremoloUnit.cpp.

Для определения параметров аудиоустройства, Вы делаете три вещи:

• Назовите параметры и дайте им значения в заголовочном файле пользовательского подкласса

• Добавьте операторы к методу конструктора аудиоустройства установить параметры, когда инстанцируют аудиоустройство

• Переопределите GetParameterInfo метод от SDK’s AUBase класс, в файле реализации пользовательского подкласса, для определения параметров

Код, который Вы реализуете здесь, не использует параметры по сути. Это - код DSP, который Вы реализуете позже в Обработке сигналов Реализации, использующей параметры. Здесь, Вы просто определяете параметры так, чтобы они появились в аудиоустройстве универсальное представление и так, чтобы они были готовы использовать, когда Вы реализуете код DSP.

#pragma mark ____TremoloUnit Parameter Constants

static CFStringRef kParamName_Tremolo_Freq      = CFSTR ("Frequency");    // 1

static const float kDefaultValue_Tremolo_Freq   = 2.0;                    // 2

static const float kMinimumValue_Tremolo_Freq   = 0.5;                    // 3

static const float kMaximumValue_Tremolo_Freq   = 20.0;                   // 4

static CFStringRef kParamName_Tremolo_Depth     = CFSTR ("Depth");        // 5

static const float kDefaultValue_Tremolo_Depth  = 50.0;

static const float kMinimumValue_Tremolo_Depth  = 0.0;

static const float kMaximumValue_Tremolo_Depth  = 100.0;

static CFStringRef kParamName_Tremolo_Waveform  = CFSTR ("Waveform");     // 6

static const int kSineWave_Tremolo_Waveform     = 1;

static const int kSquareWave_Tremolo_Waveform   = 2;

static const int kDefaultValue_Tremolo_Waveform = kSineWave_Tremolo_Waveform;

// menu item names for the waveform parameter

static CFStringRef kMenuItem_Tremolo_Sine       = CFSTR ("Sine");         // 7

static CFStringRef kMenuItem_Tremolo_Square     = CFSTR ("Square");       // 8

// parameter identifiers

enum {                                                                    // 9

    kParameter_Frequency  = 0,

    kParameter_Depth      = 1,

    kParameter_Waveform   = 2,

    kNumberOfParameters   = 3

};

TremoloUnit::TremoloUnit (AudioUnit component) : AUEffectBase (component) {

    CreateElements ();

    Globals () -> UseIndexedParameters (kNumberOfParameters);

    SetParameter (                                       // 1

        kParameter_Frequency,

        kDefaultValue_Tremolo_Freq

    );

    SetParameter (                                       // 2

        kParameter_Depth,

        kDefaultValue_Tremolo_Depth

    );

    SetParameter (                                       // 3

        kParameter_Waveform,

        kDefaultValue_Tremolo_Waveform

    );

    #if AU_DEBUG_DISPATCHER

        mDebugDispatcher = new AUDebugDispatcher (this);

    #endif

}

#pragma mark ____Parameters

ComponentResult TremoloUnit::GetParameterInfo (

        AudioUnitScope          inScope,

        AudioUnitParameterID    inParameterID,

        AudioUnitParameterInfo  &outParameterInfo

) {

    ComponentResult result = noErr;

    outParameterInfo.flags =    kAudioUnitParameterFlag_IsWritable        // 1

                                | kAudioUnitParameterFlag_IsReadable;

    if (inScope == kAudioUnitScope_Global) {                              // 2

        switch (inParameterID) {

            case kParameter_Frequency:                                    // 3

                AUBase::FillInParameterName (

                    outParameterInfo,

                    kParamName_Tremolo_Freq,

                    false

                );

                outParameterInfo.unit =                                   // 4

                    kAudioUnitParameterUnit_Hertz;

                outParameterInfo.minValue =                               // 5

                        kMinimumValue_Tremolo_Freq;

                outParameterInfo.maxValue =                               // 6

                        kMaximumValue_Tremolo_Freq;

                outParameterInfo.defaultValue =                           // 7

                        kDefaultValue_Tremolo_Freq;

                outParameterInfo.flags                                    // 8

                        |= kAudioUnitParameterFlag_DisplayLogarithmic;

                break;

            case kParameter_Depth:                                        // 9

                AUBase::FillInParameterName (

                    outParameterInfo,

                    kParamName_Tremolo_Depth,

                    false

                );

                outParameterInfo.unit =                                   // 10

                    kAudioUnitParameterUnit_Percent;

                outParameterInfo.minValue =

                    kMinimumValue_Tremolo_Depth;

                outParameterInfo.maxValue =

                    kMaximumValue_Tremolo_Depth;

                outParameterInfo.defaultValue =

                     kDefaultValue_Tremolo_Depth;

                break;

            case kParameter_Waveform:                                     // 11

                AUBase::FillInParameterName (

                    outParameterInfo,

                    kParamName_Tremolo_Waveform,

                    false

                );

                outParameterInfo.unit =                                   // 12

                    kAudioUnitParameterUnit_Indexed;

                outParameterInfo.minValue =

                    kSineWave_Tremolo_Waveform;

                outParameterInfo.maxValue =

                    kSquareWave_Tremolo_Waveform;

                outParameterInfo.defaultValue =

                    kDefaultValue_Tremolo_Waveform;

                break;

            default:

                result = kAudioUnitErr_InvalidParameter;

                break;

        }

    } else {

        result = kAudioUnitErr_InvalidParameter;

    }

    return result;

}

ComponentResult TremoloUnit::GetParameterValueStrings (

    AudioUnitScope          inScope,

    AudioUnitParameterID    inParameterID,

    CFArrayRef              *outStrings

) {

    if ((inScope == kAudioUnitScope_Global) &&             // 1

        (inParameterID == kParameter_Waveform)) {

        if (outStrings == NULL) return noErr;              // 2

        CFStringRef strings [] = {                         // 3

            kMenuItem_Tremolo_Sine,

            kMenuItem_Tremolo_Square

        };

        *outStrings = CFArrayCreate (                      // 4

            NULL,

            (const void **) strings,

            (sizeof (strings) / sizeof (strings [0])),     // 5

            NULL

        );

        return noErr;

    }

    return kAudioUnitErr_InvalidParameter;

}

Реализуйте предварительно установленный интерфейс фабрики

Затем, Вы определяете предварительные установки фабрики аудиоустройства, снова путем редактирования исходных файлов для аудиоустройства пользовательский подкласс, TremoloUnit.h и TremoloUnit.cpp.

Шаги, описанные подробно ниже:

• Назовите предварительные установки фабрики и дайте им значения.

• Измените объявление класса TremoloUnit путем добавления сигнатур методов для обработки предварительных установок фабрики.

• Отредактируйте метод конструктора аудиоустройства установить предварительную установку фабрики по умолчанию.

• Переопределите GetPresets метод для установки фабрики задает массив.

• Переопределите NewFactoryPresetSet метод для определения предварительных установок фабрики.

#pragma mark ____TremoloUnit Factory Preset Constants

static const float kParameter_Preset_Frequency_Slow = 2.0;    // 1

static const float kParameter_Preset_Frequency_Fast = 20.0;   // 2

static const float kParameter_Preset_Depth_Slow     = 50.0;   // 3

static const float kParameter_Preset_Depth_Fast     = 90.0;   // 4

static const float kParameter_Preset_Waveform_Slow            // 5

    = kSineWave_Tremolo_Waveform;

static const float kParameter_Preset_Waveform_Fast            // 6

    = kSquareWave_Tremolo_Waveform;

enum {

    kPreset_Slow    = 0,                                      // 7

    kPreset_Fast    = 1,                                      // 8

    kNumberPresets  = 2                                       // 9

};

static AUPreset kPresets [kNumberPresets] = {                 // 10

    {kPreset_Slow, CFSTR ("Slow & Gentle")},

    {kPreset_Fast, CFSTR ("Fast & Hard")}

};

static const int kPreset_Default = kPreset_Slow;              // 11

#pragma mark ____TremoloUnit

class TremoloUnit : public AUEffectBase {

public:

    TremoloUnit (AudioUnit component);

...

    virtual ComponentResult GetPresets (       // 1

        CFArrayRef        *outData

    ) const;

    virtual OSStatus NewFactoryPresetSet (     // 2

        const AUPreset    &inNewFactoryPreset

    );

protected:

...

};

TremoloUnit::TremoloUnit (AudioUnit component) : AUEffectBase (component) {

    CreateElements ();

    Globals () -> UseIndexedParameters (kNumberOfParameters);

    // code for setting default values for the audio unit parameters

    SetAFactoryPresetAsCurrent (                    // 1

        kPresets [kPreset_Default]

    );

    // boilerplate code for debug dispatcher

}

#pragma mark ____Factory Presets

ComponentResult TremoloUnit::GetPresets (                     // 1

    CFArrayRef *outData

) const {

    if (outData == NULL) return noErr;                        // 2

    CFMutableArrayRef presetsArray = CFArrayCreateMutable (   // 3

        NULL,

        kNumberPresets,

        NULL

    );

    for (int i = 0; i < kNumberPresets; ++i) {                // 4

        CFArrayAppendValue (

            presetsArray,

            &kPresets [i]

        );

    }

    *outData = (CFArrayRef) presetsArray;                     // 5

    return noErr;

}

OSStatus TremoloUnit::NewFactoryPresetSet (                         // 1

    const AUPreset &inNewFactoryPreset

) {

    SInt32 chosenPreset = inNewFactoryPreset.presetNumber;          // 2

    if (                                                            // 3

        chosenPreset == kPreset_Slow ||

        chosenPreset == kPreset_Fast

    ) {

        for (int i = 0; i < kNumberPresets; ++i) {                  // 4

            if (chosenPreset == kPresets[i].presetNumber) {

                switch (chosenPreset) {                             // 5

                    case kPreset_Slow:                              // 6

                        SetParameter (                              // 7

                            kParameter_Frequency,

                            kParameter_Preset_Frequency_Slow

                        );

                        SetParameter (                              // 8

                            kParameter_Depth,

                            kParameter_Preset_Depth_Slow

                        );

                        SetParameter (                              // 9

                            kParameter_Waveform,

                            kParameter_Preset_Waveform_Slow

                        );

                        break;

                    case kPreset_Fast:                             // 10

                        SetParameter (

                            kParameter_Frequency,

                           kParameter_Preset_Frequency_Fast

                        );

                        SetParameter (

                            kParameter_Depth,

                            kParameter_Preset_Depth_Fast

                        );

                        SetParameter (

                            kParameter_Waveform,

                            kParameter_Preset_Waveform_Fast

                        );

                        break;

                }

                SetAFactoryPresetAsCurrent (                        // 11

                    kPresets [i]

                );

                return noErr;                                       // 12

            }

        }

    }

    return kAudioUnitErr_InvalidProperty;                           // 13

}

Реализуйте обработку сигналов

С параметром и предварительно установленный код на месте, Вы теперь добираетесь до сути дела: код цифровой обработки сигналов. Как описано в Синтезе, Обработке и Коде Преобразования формата данных, DSP, выполняемый модулем эффекта канала n-to-n, имеет место в AUKernelBase класс, класс помощника для AUEffectBase класс. Обратитесь к Обработке: Суть дела для больше о том, как DSP работает в аудиоустройствах.

Для реализации обработки сигналов в модуле эффекта канала n-to-n Вы переопределяете два метода от AUKernelBase класс:

• Process метод, выполняющий обработку сигналов

• Reset метод, возвращающий аудиоустройство его нетронутому, инициализированному состоянию

По пути Вы вносите изменения в значение по умолчанию TremoloUnitKernel объявление класса в TremoloUnit.h заголовочный файл, и Вы изменяете TremoloUnitKernel метод конструктора в TremoloUnit.cpp.

class TremoloUnit : public AUEffectBase

{

public:

    TremoloUnit(AudioUnit component);

...

protected:

    class TremoloUnitKernel : public AUKernelBase {

        public:

            TremoloUnitKernel (AUEffectBase *inAudioUnit); // 1

            virtual void Process (

                const Float32    *inSourceP,

                Float32          *inDestP,

                UInt32           inFramesToProcess,

                UInt32           inNumChannels,   // equal to 1

                bool             &ioSilence

        );

        virtual void Reset();

        private:

            enum     {kWaveArraySize = 2000};             // 2

            float    mSine [kWaveArraySize];              // 3

            float    mSquare [kWaveArraySize];            // 4

            float    *waveArrayPointer;                   // 5

            Float32  mSampleFrequency;                    // 6

            long     mSamplesProcessed;                   // 7

            enum     {sampleLimit = (int) 10E6};          // 8

            float    mCurrentScale;                       // 9

            float    mNextScale;                          // 10

    };

};

#pragma mark ____TremoloUnitEffectKernel

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

//    TremoloUnit::TremoloUnitKernel::TremoloUnitKernel()

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

TremoloUnit::TremoloUnitKernel::TremoloUnitKernel (AUEffectBase *inAudioUnit) :

    AUKernelBase (inAudioUnit), mSamplesProcessed (0), mCurrentScale (0) // 1

{

    for (int i = 0; i < kWaveArraySize; ++i) {                           // 2

        double radians = i * 2.0 * pi / kWaveArraySize;

        mSine [i] = (sin (radians) + 1.0) * 0.5;

    }

    for (int i = 0; i < kWaveArraySize; ++i) {                           // 3

        double radians = i * 2.0 * pi / kWaveArraySize;

        radians = radians + 0.32;

        mSquare [i] =

            (

                sin (radians) +

                0.3 * sin (3 * radians) +

                0.15 * sin (5 * radians) +

                0.075 * sin (7 * radians) +

                0.0375 * sin (9 * radians) +

                0.01875 * sin (11 * radians) +

                0.009375 * sin (13 * radians) +

                0.8

            ) * 0.63;

    }

    mSampleFrequency = GetSampleRate ();                                 // 4

}

void TremoloUnit::TremoloUnitKernel::Process (                        // 1

    const Float32   *inSourceP,                                       // 2

    Float32         *inDestP,                                         // 3

    UInt32          inSamplesToProcess,                               // 4

    UInt32          inNumChannels,                                    // 5

    bool            &ioSilence                                        // 6

) {

    if (!ioSilence) {                                                 // 7

        const Float32 *sourceP = inSourceP;                           // 8

        Float32  *destP = inDestP,                                    // 9

                 inputSample,                                         // 10

                 outputSample,                                        // 11

                 tremoloFrequency,                                    // 12

                 tremoloDepth,                                        // 13

                 samplesPerTremoloCycle,                              // 14

                 rawTremoloGain,                                      // 15

                 tremoloGain;                                         // 16

        int      tremoloWaveform;                                     // 17

        tremoloFrequency = GetParameter (kParameter_Frequency);       // 18

        tremoloDepth     = GetParameter (kParameter_Depth);           // 19

        tremoloWaveform  =

            (int) GetParameter (kParameter_Waveform);                 // 20

        if (tremoloWaveform != kSineWave_Tremolo_Waveform             // 21

            && tremoloWaveform != kSquareWave_Tremolo_Waveform)

                tremoloWaveform = kSquareWave_Tremolo_Waveform;

        if (tremoloWaveform == kSineWave_Tremolo_Waveform)  {         // 22

            waveArrayPointer = &mSine [0];

        } else {

            waveArrayPointer = &mSquare [0];

        }

        if (tremoloFrequency < kMinimumValue_Tremolo_Freq)            // 23

            tremoloFrequency = kMinimumValue_Tremolo_Freq;

        if (tremoloFrequency > kMaximumValue_Tremolo_Freq)

            tremoloFrequency = kMaximumValue_Tremolo_Freq;

        if (tremoloDepth     < kMinimumValue_Tremolo_Depth)           // 24

            tremoloDepth     = kMinimumValue_Tremolo_Depth;

        if (tremoloDepth     > kMaximumValue_Tremolo_Depth)

            tremoloDepth     = kMaximumValue_Tremolo_Depth;

        samplesPerTremoloCycle = mSampleFrequency / tremoloFrequency; // 25

        mNextScale = kWaveArraySize / samplesPerTremoloCycle;         // 26

        // the sample processing loop ////////////////

        for (int i = inSamplesToProcess; i > 0; --i) {                // 27

            int index =                                               // 28

                static_cast<long>(mSamplesProcessed * mCurrentScale) %

                    kWaveArraySize;

            if ((mNextScale != mCurrentScale) && (index == 0)) {      // 29

                mCurrentScale = mNextScale;

                mSamplesProcessed = 0;

            }

            if ((mSamplesProcessed >= sampleLimit) && (index == 0))   // 30

                mSamplesProcessed = 0;

            rawTremoloGain = waveArrayPointer [index];                // 31

            tremoloGain       = (rawTremoloGain * tremoloDepth -      // 32

                                tremoloDepth + 100.0) * 0.01;

            inputSample       = *sourceP;                             // 33

            outputSample      = (inputSample * tremoloGain);          // 34

            *destP            = outputSample;                         // 35

            sourceP           += 1;                                   // 36

            destP             += 1;                                   // 37

            mSamplesProcessed += 1;                                   // 38

        }

    }

}

void TremoloUnit::TremoloUnitKernel::Reset() {

    mCurrentScale        = 0;                    // 1

    mSamplesProcessed    = 0;                    // 2

}

Реализуйте свойство времени хвоста

Наконец, чтобы гарантировать, что Ваше аудиоустройство играет хорошо в хост-приложениях, реализуйте свойство времени хвоста, kAudioUnitProperty_TailTime.

Чтобы сделать это, просто утвердите в Вашем TremoloUnit определение класса, что Ваше аудиоустройство поддерживает свойство путем изменения возвращаемого значения SupportsTail метод к true.

Перечисление 5-14  Реализовывая свойство времени хвоста (TremoloUnit.h)

virtual bool SupportsTail () {return true;}

Учитывая природу DSP Ваше аудиоустройство выполняет, его время хвоста 0 секунды — таким образом, Вы не должны переопределять GetTailTime метод. В AUBase суперкласс, этот метод сообщает о времени хвоста 0 секунды, который является тем, о чем Вы хотите, чтобы Ваше аудиоустройство сообщило.

Проверьте свое Завершенное Аудиоустройство

Теперь Вы реализовали весь код для проекта модуля тремоло. Разработайте проект и исправьте любые ошибки, которые Вы видите. Тогда используйте auval инструмент для проверки аудиоустройства.

1. В Терминале введите команду для проверки модуля тремоло. Это состоит из auval название команды, сопровождаемое -v флаг для вызова проверки, сопровождаемой типом, подтипом и кодами производителя, идентифицирующими модуль тремоло. Полная команда для этого аудиоустройства:

auval -v aufx tmlo Aaud

Если все в порядке, auval должен сообщить, что Ваше новое аудиоустройство действительно допустимо. Данные показывают последний бит журнала, создаваемого auval:

Протестируйте свое Завершенное Аудиоустройство

Ваше аудиоустройство готово к Вам протестировать в хост-приложении. Apple рекомендует приложение AU Lab для тестирования аудиоустройства. Можно также хотеть протестировать аудиоустройство в других узлах. В этом разделе описываются тестирование с AU Lab. Выполните эти шаги:

1. Откройте документ AU Lab, который Вы сохранили от раздела Test the Unmodified Audio Unit. Если у Вас нет того документа, пробегите шаги в том разделе снова для установки AU Lab для тестирования аудиоустройства.

2. Ваше завершенное аудиоустройство появляется с универсальным представлением как показано в числе:

(Вы, возможно, должны выйти и вновь открыть AU Lab для представления Вашего завершенного аудиоустройства для появления.)

Заметьте ползунки для параметров Частоты и Глубины, всплывающее меню для параметра Формы волны и предварительную установку по умолчанию, выведенную на экран в Предварительно установленном всплывающем меню Фабрики.

3. Щелкните по кнопке воспроизведения в окне утилиты AUAudioFilePlayer. Если все будет в порядке, то файл, который Вы выбрали в проигрывателе, проиграет Ваше аудиоустройство, и Вы услышите эффект тремоло.

4. Эксперимент с диапазоном эффектов, доступных с модулем тремоло: скорректируйте Частоту, Глубину и средства управления Формой волны при слушании вывода от AU Lab.

5. В предварительно установленном меню к верхнему правому из универсального представления выберите Show Presets.

Предварительно установленная секция открывается.

Раскройте предварительные установки в группе Фабрики и проверьте, что предварительные установки, которые Вы добавили к своему аудиоустройству, с помощью NewFactoryPresetSet метод, присутствуют. Дважды щелкните по предварительной установке для загрузки его.

Можно добавить пользовательские предварительные установки к аудиоустройству следующим образом:

• Установите параметры, как желаемый

• В предварительно установленном меню выберите Save Preset As

• В диалоговом окне, появляющемся, введите имя для предварительной установки.