Trainz/容器/聲音指令碼容器

Trainz 註釋參考

TOC | 開始 | 有趣 | AM&C | 創作 | 書內參考 | ORP 參考：  • 索引 • 容器 • 種類 • 標籤 | 附錄  • 版本

詞彙表

HKeys-CM

HKeys-DVR

HKeys-SUR

HKeys-WIN

滑鼠使用

符號

用於定義資產聲音的容器型別標籤。聲音指令碼容器能夠控制“相對響度”、衰減範圍、隨機範圍，並且可以具有特定的觸發器。

支援的標籤

每個聲音指令碼子容器都支援以下標籤。每個標籤在此處顯示及其預設值。

規範與示例
規範
soundscript (container) { soundscript-ID (Optional-Name) repeat-delay 0,0 distance 50,150 ambient 0 attachment "" nostartdelay 0 priority 1 trigger "" volume 1 value-range 0,0 sound { } }
簡單示例
soundscript { dayloop (optional name) { ambient 1 repeat-delay 20,25 distance 10,100 sound (subcontainer) { dogbark.wav lildogbark.wav bigdogbark.wav dogsallbark.wav } } } (adapted: KB dogbark,<kuid:52682:39098>)

 

• 在上面的示例中，該資產很可能只會被聽到一次，除非它停在附近（車站、支線？），而且該列表中的聲音是隨機選擇的，因此會使這樣的停止的耳朵聽到不同的聲音。

 

ambient

型別：布林值 - 除了 1 和 0 以外的值都會生成錯誤訊息！

預設值：0

必需：否

描述：如果為真，則這是一個“環境”聲音，環境聲音在 2D 中播放，除了影響音量外，不使用 3D 定位在世界中。與位置聲音不同，環境聲音可能是立體聲的。

attachment

型別：附件點

預設值：""

必需：否

描述：將聲源附加到的點。附件點在建立期間在網格檔案中指定。

為什麼聲音不應該有附件點，瑪蒂爾達、喬治和米利森問道。為什麼當聲音被路線構建者放置為“路線軌道周圍的可聽場景”時，就像他可能會放置一棵樹一樣。就像視覺效果一樣，聲音效果由建模者用來提供一種味道和印象的現實——因為沒有兩個秒的聲音檔案可以模仿持續聲音的現實。 

distance

型別：小數對 - 米：radius_Begin_fading、radius_cut_off_&_stop

預設值：50,150

必需：否

描述：聲音可聽的從聲源開始的距離範圍（以米為單位）。

• 最小距離定義了聲音保持 100% 音量的半徑。
• 超過該距離，聲音音量將開始自然衰減。
• 最大距離定義了遊戲不再播放聲音的半徑。這並不意味著聲音的衰減行為按此值進行縮放，以便在最大距離時衰減到零，而是聲音將在該點突然切斷。提示：由內容創作者選擇適當的距離——越小越好，因為資產影響範圍的半徑越早被透過，CPU 的程序流就越早可以從迴圈週期中將其刪除，並注意其他事情。幀率抓取器注意！那個漂亮的聲音是有代價的。

nostartdelay

型別：布林值

預設值：0

必需：否

描述：如果新增併為真，則此標籤指定聲音將在觸發後立即播放。預設情況下，聲音在 0 到 4 秒之間有一個隨機的開始延遲。在大多數情況下，應該保持開始延遲活動，因為將其關閉可能會在多個相同的聲音接近時導致明顯的音訊偽影。

priority

型別：整數

描述：設定聲音的優先順序，如果可用聲音通道不足，則優先順序較高的聲音將首先播放。預設為 1，可以為負數。

repeat-delay

型別：小數對

預設值：0,0

必需：是 (3.4)

描述：聲音播放完成後延遲的時間範圍（以秒為單位），然後再再次播放聲音。要設定恆定的延遲，可以將這兩個值設定為相同，或者只提供其中一個值，否則將選擇它們之間的一個隨機值。當與觸發事件（參見“觸發”標籤）一起使用時，正值表示聲音不應該重複，而應該等待再次觸發。

sound

型別：容器

預設值：{}

必需：是

描述：包含要播放的聲音檔案列表的鍵/字串列表。如果列表中有多個條目，則將從列表中隨機選擇一個檔案。此容器中每個標籤的值都是 WAV 聲音檔案的名稱。檔名相對於資產的基目錄，即相對於配置檔案的位置。列表中使用的鍵並不重要：Trainz 對此類列表的約定是從零開始對每個選項進行數字編號，雖然強烈建議遵循此約定，但沒有技術要求這樣做。

有效的 WAV 檔案是

• 未壓縮的。
• 8 位或 16 位
• 單聲道、立體聲或環繞聲（截至 build 3.7，環繞聲尚未完全測試）

取樣率可以是 22kHz (22,050Hz) 或 44kHz (44,100Hz)。更高的取樣率使檔案大小翻倍，但音質沒有明顯提高，因此不推薦使用。對於某些目的，有額外的要求——例如，方向聲音必須是單聲道的。

trigger

型別：字串

預設值：""

必需：否

描述：'trigger' 標籤為你的聲音提供一個名稱，可以讓你從 TrainzScript、動畫和某些預定義事件中播放。(至少其中一個“預定義事件”是在“kind mojunction”的 config.txt 中包含 soundscript 容器時使用“toggle”這個詞。這樣會在每次轉換道岔時觸發聲音)

value-range

型別：浮點數對

預設值：0,0 (關閉)

必需：否

描述：兩個數字，它們不相等，用於設定聲音播放的開始和結束時間。午夜是 0.5，正午是 0.0 或 1.0。(待定。這有點模糊)

volume

型別：小數

預設值：1

必需：否

描述：指定聲音的音量增益。預設為 1 (100%)。

soundscript-ID

型別：字串值，一個識別符號名稱

預設值：""

強制性：否，除非有不止一個聲音由 soundscript 容器管理。(參見下面的 morning、evening 例子)

描述：指定用於連線軟體其他部分的聲音的控制代碼或文字識別符號。

與 Index_of_Tags_%26_Containers 中其他包含 '-ID' 字尾的術語類似。

示例 Config.txt 檔案

具有不同白天和黑夜背景聲音的地圖資產的示例 config.txt 檔案

地圖檔案中的 soundscript

 kind map
 kuid <KUID2:497853:13052:3>
 soundscript
 {
   morning
   {
     ambient 1
     value-range 1, 0.1
     volume 0.3
     sound
     {
       0 ctry_day_1.wav
       1 ctry_day_2.wav
     }
   }
   night
   {
     ambient 1
     value-range 0, 0.9
     volume 0.3
     sound
     {
       0 night_loop.wav
     }
   }
 }

作為可放置的場景音效的 soundscript

這是一個實際的 TB v1.3 資產，升級到 V2.7 (TC1&2)——這個級別是一個有用的中間狀態，包含了大多數主要的必要更改，並且作為一項檢查，消除了現在非法的以前有用的快速分類 TBS 標籤，例如 region、type、asset-name，以及其他此類已停用的關鍵字，例如 autoanimation（其操作已合併到諸如網格表 容器 和 autocreate 引數之類的結構中）。

kind                                    "scenery"
light                                   1
category-class                          "BU"
trainz-build                            2.7
username                                "KB trainannouncer sound-aRus"
category-region                         "00"
category-era                            "1960s;1970s;1980s;1990s;2000s;2010s"
description                             "username = 'KB trainannouncer sound-aRus'

--  This is a 27 second long muted platform soundtrack with indistinct but obvious near-continuous distant loudspeaker announcement.

Original description:
--  This is a sound add-on.
--  To use it you must place this object in Surveyor at or adjacent to any area that you wish to hear this sound from.

credit: Thanks to USER.RO for creating the sound regions object.  It makes the creation of objects in this package easy & quick.
original trainz-build                            1.3

Rev-A 2015-0115 - by Fabartus - update to update ranges... 
and eliminate these obsolescent tags:

asset-filename                          'KB_trainannounce'
autoanimation                           1
region                                  'AAA Sounds'
type                                    'Trains'
--------- 

This faulty asset originated in C:\TS09-SP3\UserData\editing 2014-1008

Asset foldername: kuid2 52682 39352 0;v2-6;Platform sound effect;KB Trainannouncer sound-aRus
Original folder:  C:\TS09-SP3\editing\KB trainannounce
******************************************************************************************
soundscript
{
  dayloop
  {
    repeat-delay                        20,38
    distance                            10,80
   
    sound
    {
      trainannounce.wav                 
    }
  }
} 
mesh-table {
  default {
    mesh               "invisible-platform_body.im"
   auto-create        1  }
} 
thumbnails  {
  0   {
   width 240
   height 180
   image "$Soundeffect screenshot (240).jpg"   }
}
kuid-table {
}

作為一項並非用於上傳的修復後的資產，修復者可以選擇調整排序引數，例如使用者名稱、描述資料以及 category-xxx 引數，以適應資產型別的限制。在這種情況下，作為一名相信良好文件的程式設計師，描述塊用於跟蹤更改（更改記錄），因為合法備註或註釋在 TS2009 版本中從 Trainz 中刪除了。該示例還展示了對作者原始名稱的更改和符合性：儘可能保留相同的短語並保持相同的順序，如果可能，新增擴充套件和澄清的詞語或短語，然後還會定期新增更改字尾“-aRus”。這實際上意味著：Altered、Repaired、Upgraded、Screenshot；並且“-a”字尾在 CM 中作為名稱引數給出時，會進行排序。

上面的例子也用於說明另一個觀點——在 C 語言程式設計實踐世界中，不同的縮排樣式很常見。soundscript 容器使用一種格式約定，而最後三個容器使用另一種常見的縮排方法。一般來說，內容管理器會解壓縮並生成容器的第一種形式，但 CM 和 CMP 對其他形式非常寬容，只要字元之間存在空格字元。在 C、C++ 和 C# 語言中，不需要這種空格填充，括號字元本身就足以在解析資料元素時進行分隔。Trainz 的解析能力遠不如這些語言。