• она находится в пределах прямой видимости (т.е. между центром энтити и игроком нет преград из обычных брашей)
• игрок находится внутри радиуса ее действия
• она находится ближе остальных (env_soundscape) к игроку

Пояснение к примеру Игрок начинает путь из точки P. В точке 1 он попадает в радиус действия саундскейпа S1 - теперь саундскейп S1 слышен игроку. В точке 2 саундскейп S1 находится за пределами прямой видимости, но по-прежнему слышен игроку. В точке 3 игрок попадает в радиус действия саундскейпа S2. Теперь саундскейп S1 не слышен игроку, слышен только S2. В точке 4 игрок выходит из радиуса действия саундскейпа S2, но по-прежнему слышит только его, т.к. саундскейп S1 находится за пределами прямой видимости. В точке 5 игрок снова слышит саундскейп S1, т.к. он находится в пределах прямой видимости. Саундскейп S2 не слышен.

  "example"
  {
    "key1" "value1"
    "key2" "value2"
    "subexample"
    {
      "key3" "value3"
    }
    "key4" "value4"
  }
  // Вся эта строка - комментарий (пропускается движком)
  "example2" // Возможен и такой комментарий - от // до конца строки
  {
  }

"file" "scripts/<имя_файла_с_саундскейпами>.txt"

задает эффект обработки звука. Обычно <параметр> равен 1 - автоматическая обработка звуков, исходя из окружающей геометрии (эхо, ревербация). Параметр 0 отключает обработку звуков (проигрываются без изменений).
Другие значения параметра рекомендуются только в особых случаях и описываются в файле …/hl2/scripts/dsp_preset.txt; названия эффектов по номерам есть в начале файла soundscapes.txt.

Пример:

    // Саундскейп - полная тишина без обработки звука
    "Nothing"
    {
      "dsp"   "0"
    }

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

"wave" "<путь>"

имя звукового файла с указанием пути. Если звук из стандартных, то <путь> задается так же, как в просмотрщике звуков. Для новых звуков, добавленных в каталог /sound Вашего мода, <путь> задается относительно этого каталога.

"volume" "<число с п.точкой от 0 до 1>"

задает громкость звука.

"pitch" "<число от 1 до 255>"

задает темп воспроизведения звука (с изменением высоты). Нормальное значение - 100 (оригинальное звучание).

"position" "<число>"

если секция playlooping используется для позиционного звучания (в игре определяется его положение), данная команда задает номер позиции (<число> - от 0 до 7). Позиции задаются затем в энтити env_soundscape.

Замечание: позиционные звуки имеет смысл использовать только вместе с attenuation или soundlevel


"attenuation" "<число с п.т.>"

скорость затухания звука по мере удаления от источника. Имеет смысл использовать только для позиционных звуков (если задана position).

"soundlevel" "<предопределенное значение>"

сопоставимый уровень громкости, определяющий скорость затухания звука по мере удаления от источника. Имеет смысл использовать только для позиционных звуков (если задана position).
Список предопределенных уровней см. далее.

Пример:

    // Циклическое проигрывание отдельного звука с ревербацией (1 тип комнаты)
    "GenericIndoor"
    {
      "dsp"   "1"
      "playlooping"
      {
        "volume"    "1"
        "pitch" "100"
        "wave"  "ambient/atmosphere/indoor2.wav"
      }
    }

Замечание: для того, чтобы зациклить звук, необходимо добавить в него специальные метки цикла (в звуковом редакторе установить на начало маркер с именем loop). Эти метки позволяют звуковому движку определить, какую часть звука нужно проигрывать циклически (обычно звук целиком).

постоянно проигрывает набор звуков случайным образом (пока активен саундскейп).
В скобках задаются дополнительные команды-спецификации:

"time" "tmin,tmax"

временной интервал между звуками. Здесь tmin и tmax - минимальное и максимальное значение времени (т.е. между началом текущего и следующего звуков пройдет tmin…tmax секунд).

"volume" "vmin,vmax"

громкость звуков; задается значениями от 0 до 1 (1 - максимальная (оригинальная) громкость звука). Здесь vmin и vmax - минимальная и максимальная громкость (т.е. громкость очередного звука будет случайной в интервале от vmin до vmax).

"pitch" "pmin,pmax"

ускорение/замедление воспроизведения; задается значениями в процентах от 50 до 250 (100 - нормальная скорость). Здесь pmin и pmax - минимальное и максимальное значения (т.е. ускорение/замедление воспроизведения колеблется в интервале от pmin до pmax).

"rndwave" {}

список звуков, которые будут проигрываться в случайном порядке. Каждый звук задается в виде строки "wave" "<путь>" (имя звукового файла с указанием пути). Если звук из стандартных, то <путь> задается так же, как и в просмотрщике звуков. Для новых звуков, добавленных в каталог /sound Вашего мода, <путь> задается относительно этого каталога.

"position" "<число>"

если секция playrandom используется для позиционного звучания (в игре определяется конкретное положение источника звуков), данная команда задает номер позиции (<число> - от 0 до 7). Позиции задаются затем в энтити env_soundscape.

"position" "random"

если звуки секции playrandom в игре должны идти случайным образом со всех сторон, вместо номера конкретной позиции ставится ключевое слово random.

Замечание: позиционные звуки имеет смысл использовать только вместе с attenuation или soundlevel


"attenuation" "<число>"

скорость затухания звука по мере удаления от источника. Имеет смысл использовать только для позиционных звуков (если задана position).

"soundlevel" "<предопределенное значение>"

сопоставимый уровень громкости, определяющий скорость затухания звука по мере удаления от источника. Имеет смысл использовать только для позиционных звуков (если задана position).
Список предопределенных уровней см. далее.

Пример:

    "ExampleSoundscape"
    {
      "dsp"   "1"

      "playrandom"
      {
        // Проигрывать звуки каждые 0.1…1.5 секунд
        "time" "0.1,1.5"

        // Громкость звуков от 0.5 до 1
        "volume" "0.5,1"

        // Проигрывать от ускорения 50% до замедления 120%
        "pitch" "50,120"

        // Ослабление звучания 0.7
        "attenuation" "0.7"

        // Для энтити, определенной в позиции 1
        "position"  "1"

        // Случайным образом проигрывать звуки из следующего списка
        "rndwave"
        {
          "wave" "ambient/creatures/pigeon_idle1.wav"
          "wave" "ambient/creatures/pigeon_idle2.wav"
          "wave" "ambient/creatures/pigeon_idle3.wav"
        }
      }
    }

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

"name" "<имя саундскейпа>"

имя проигрываемого саундскейпа.

"volume" "<число с п.точкой от 0 до 1>"

громкость проигрываемого саундскейпа (1 - максимальная (оригинальная)).

"position" "<число>"

если секция playsoundscape используется для позиционного звучания (в игре определяется его положение), данная команда задает номер позиции (<число> - от 0 до 7). Позиции задаются затем в энтити env_soundscape.

"positionoverride" "<число>"

даже если проигрываемый саундскейп использует несколько позиций для звуков, данная команда вынуждает проигрывать его звуки только из одной позиции. Здесь <число> равно номеру позиции от 0 до 7.

"ambientpositionoverride" "<число>"

все фоновые звуки заданного саундскейпа будут располагаться в указанной позиции. Таким образом, можно задавать звуки фонового "окружения", идущие с определенной стороны. Здесь <число> равно номеру позиции от 0 до 7.

Замечание: позиционные звуки имеет смысл использовать только вместе с attenuation или soundlevel


"attenuation" "<число>"

скорость затухания звука по мере удаления от источника. Имеет смысл использовать только для позиционных звуков (если заданы position, positionoverride или ambientpositionoverride).

"soundlevel" "<предопределенное значение>"

сопоставимый уровень громкости, определяющий скорость затухания звука по мере удаления от источника. Имеет смысл использовать только для позиционных звуков (если заданы position, positionoverride или ambientpositionoverride).
Список предопределенных уровней см. далее.

Замечание: саундскейпы, включенные таким образом в состав данного, не влияют на обработку звука (DSP).

Пример:

    "SubSoundscape"
    {
      "dsp"   "1"

      "playsoundscape"
      {
        // Саундскейп, который проигрывается в составе данного саундскейпа
        "name" "GenericIndoor"

        // Громкость указанного саундскейпа уменьшить наполовину
        "volume" "0.5"

        // Все позиционные звуки указанного саундскейпа идут из одной позиции
        "positionoverride" "0"      // из позиции 0

        // Все фоновые звуки указанного саундскейпа идут из одной позиции
        "ambientpositionoverride" "1"   // из позиции 1
      }
    }

задает звуковое микширование (смешивание) для саундскейпа. Микширование звука используют, чтобы задать громкость для разных категорий звуков, называемых группами микширования. При этом проигрывание категорий может происходить одновременно (смешивается).
Имена микшеров заданы в файле soundmixers.txt в каталоге /scripts Вашего мода. Если необходимо определить собственный микшер, добавьте его в конец этого файла (после строки // add new sound mixers here...).

Замечание: определяя новый микшер, всегда используйте в качестве шаблона микшер Default_Mix. Об этом предупреждает комментарий в файле soundmixers.txt.

Пример:

    "automatic"
    {
      "dsp" "1"
      "dsp_volume" "1.0"
      "SOUNDMIXER" "Default_Mix"
    }

В примере определяется саундскейп automatic с микшером Default_Mix.

Определение микшера Default_Mix (в файле soundmixers.txt):

    "Default_Mix"
    {

      // имя группы           значение при смешивании
      // --------             ---------
      "Explosions"            "0.90"
      "Player_Weapons_Loud"   "1.0"
      "Player_Suit"           "0.56"
      "Weapons"               "0.79"

      "AHELI_WEAPON"          "0.85"
      "GUNSHIP_WEAPON"        "0.85"
      "STRIDER_WEAPON"        "0.85"
      "bullethit"             "0.67"

      "Music"                 "0.81"

      "All"                   "0.72"
    }