ambient_generic

From Valve Developer Community
Jump to: navigation, search
English

ambient_generic точечная сущность доступна во всех играх на движке Source и Source2.

Описание

Ambient generic.png

Воспроизводит звук один раз или по-кругу, в определённом месте или глобально.

Используйте его для воспроизведения звука или контроля звучания звуковых скриптов, файла с расширением .wav или scripted_sentence. В отличие от текстур и моделей, вы должны перезапустить Hammer editor для того, чтобы браузер звуков мог показать добавленные файлы.

Баг:ambient_generics используется для воспроизведения циклических звуков в Counter-Strike Source, для этого они должны быть активированы logic_auto в противном случае, они перестанут воспроизводится после начала раунда.


Баг:Можно избежать проблемы с беспрерывным воспроизведением звуков. Устраняется с помощью добавления вот этого кода C++.


Keyvalues (Основные значения)

Sound Name(message) <string>
Название звукового скрипта, или путь к файлу, который нужно воспроизвести. Для scripted_sentence, введите "!", а после него название предложения. (Пример: !COMBINE_THROW_GRENADE4)
Max Audible Distance <float>
Максимальная дистанция в юнитах, при которой для клиента воспроизводится звук.
Примечание:Звук затихает по мере того, как игрок отдаляется, поэтому иногда может показаться что звук перестал воспроизводится слишком резко.
SourceEntityName <targetname>
Если название указано, звук будет воспроизводится непосредственно из этого энтити, вместо ambient_generic. Если указанное имя - имя NPC, с поддержкой "lipsynch" (синхронизации губ), и информация о фонетике находится вместе с файлом звука, цель будет "говорить в такт" звуку.
Баг:После разрушения энтити, звук будет воспроизведен на карте по координатам (0,0,0).


Volume <int> <0-10>
Громкость. 0 - тихо, 10 - нормально. Стандартно - 10.
Start Volume <int> <0-10>
Fade in time in seconds <int> <0-100>
Fade out time in seconds <int> <0-100>
Количество времени которое должно пройти перед/после затихания, и при какой громкости начинать. Стандартно, затихания нет.
Pitch <int> <1-255>
Высота. 1 - низко, 100 - нормально, 255 - высоко.
Start pitch <int> <1-255>
Spin up time <int> <0-100>
Spin down time <int> <0-100>
Количество времени для изменения (спиннинг) высоты вниз/вверх в начале/конце воспроизведения, и с какой высотой начинать. Стандартно, спиннинга нет.
Dynamic Presets <choices>
Разнообразные эффекты DSP, которые могут быть активированы.
LFO type <int>
Тип Генератора низких частот, который нужно задействовать.
  • Off (Выключить)(Стандартно)
  • Square Wave (Меандр)(Частота меняется между низкой и высокой)
  • Triangle Wave (Триангулярность волны)(Резкие переходы)
  • Random (Случайно)
LFO rate <int> <0-1000>
Частота с которой эффект LFO повторяется (в секунду?).
LFO modulation - pitch <int> <0-100>
Влияет на высоту звука или вибрато. Большие значения увеличивают высоту. (Например: У певцов в голосе преобладают низкие частоты, а в звучании сирены - высокие)
LFO modulation - volume <int> <0-100>
Влияет на громкость звука, создавая эффект его "пульсации". Соответственно к тремоло.
Incremental Spinup Count <int>
Участвует в увеличение высоты со временем, с помощью ввода ToggleSound, но:
Баг:Не работает


Targetname:

Name <строка>
targetname, по которому другие энтити обращаются к этой энтити.
Entity Scripts <скриптлист VScript> (Появилось в Left 4 Dead 2)
Имена файлов скриптов, которые начнут выполнение после спауна всех энтити.
Script think function <строка> (Появилось в Left 4 Dead 2)
Имя функции в скрипте этой энтити, которая автоматически будет вызываться каждые 100 миллисекунд (десять раз в секунду) на протяжении выполнения скрипта. Так можно создавать таймеры или имитировать независимое поведение.
Примечание:Не назначайте этой функции ресурсоёмкие операции, так как это вызовет проблемы с производительностью.

Flags (Опции)

  • 1 : Играть везде
    Звук воспроизводится из всех колонок с выставленной громкостью. Не преодолевает эффекты DSP, тем не менее:
    Баг:Этот флаг поломан на уровне движка' для звуковых скриптов. Будет работать, только если звуковой файл ни разу не был переименован.


  • 16 : Начать беззвучно
Карта запустится без воспроизведения этого звука. Стандартно, режим включён.
Баг:Зацикливание звуков которые не начинаются в этом режиме - не могут быть контролированы!


  • 32 : Не зациклен
Меняет то, как ambient_generic будет останавливать и начинать воспроизведение. Не остановит звук который зациклен с помощью соответствующего значения, тем не менее, очень важно выставить правильные значения.
Баг:Эта опция, будучи отмеченной и при использовании зацикленного звука, не даст возможности его контролировать!


Inputs (Вводы)

Pitch <int> <1-255>
100 - стандартная высота.
Баг:Pitch будет проигрывать звук не "информируя" энтити. Это приводит к тому, что зацикленные звуки будут воспроизводится бесконечно!


PlaySound
Начинает воспроизведение.
StopSound
Заканчивает воспроизведение зацикленного звука. Не остановит не-зацикленные звуки: это сделано намерено, и может быть изменено с помощью кода C++.
ToggleSound
Переключает зацикленный звук между воспроизведением и остановкой. Ведёт себя как PlaySound если звук не-зациклен.
Volume <int> <0-10>
Баг:Volume будет проигрывать звук не "информируя" энтити. Зацикленный звук будет воспроизводится бесконечно!
Баг:Выставляя значение громкости на 0, поставит звук на паузу, а не будет проигрывать его беззвучно


FadeIn <int> <0-100>
FadeOut <int> <0-100>
Затихание звука от/до полной тишины на протяжении определенного времени (в секундах).

Targetname:

Kill
Удаляет этот энтити из мира.
KillHierarchy
Удаляет энтити и его потомков из мира.
AddOutput  <строка>
Определяет keyvalue/output в этом энтити. Потенциально представляет большую опасность, используйте с осторожностью.
Формат: <key> <value>
Формат: <output name> <targetname>:<inputname>:<parameter>:<delay>:<макс. количество активаций, -1 - бесконечно>
FireUser1 до FireUser4
Запуск выходов OnUser; см. Пользовательские вводы и выводы.
Use  Отсутствует в FGD!
То же, что и при вызове +use игроком; может не всё. Можно вызвать, создав вывод, которому не указан ввод.
Этот ввод не входит в Valve-файлы FGD.
RunScriptFile  <скрипт> (Появилось в Left 4 Dead 2)
Выполнить файл игрового скрипта с диска.
RunScriptCode  <строка> (Появилось в Left 4 Dead 2)
Выполнить строку исходного кода скрипта.
Предупреждение:Никогда не передавайте строковые параметры функции скрипта с помощью этого входа. Это повредит структуру VMF из-за вложения кавычек, которые потребуется удалять вручную в текстовом редакторе.

Outputs (Вывод)

Targetname:

OnUser1 до OnUser4
Вызывается в ответ на входы FireUser; (см. Пользовательские вводы и выводы).
OnKilled  

(Появилось в Left 4 Dead)

Вызывается после уничтожения энтити и удаления её из игры.

Смотрите также