Trainz/容器/soundscript 容器

Trainz 註釋參考資料

TOC | 開頭 | 樂趣 | AM&C | 創作 | 書內參考文獻 | ORP 參考文獻:  • 索引 • 容器 • 種類 • 標籤 | 附錄  • 版本

詞彙表

HKeys-CM

HKeys-DVR

HKeys-SUR

HKeys-WIN

滑鼠使用

符號

一種容器型別標籤，用於定義資產聲音。Soundscript 容器能夠控制“相對響度”、淡入淡出範圍、隨機範圍，並具有特定的觸發器。

支援的標籤

每個 soundscript 子容器都支援以下標籤。每個標籤及其預設值如下所示。

規範與示例
規範
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

型別：附加點

預設值：""

強制：否

描述：將聲音源附加到的點。附加點在建立過程中在網格檔案中指定。

為什麼聲音不應具有附加點，Matilda、Georgie 和 Millicent 問道。為什麼當聲音作為“可聽到的場景”圍繞路線軌道放置時，路線構建者就像放置樹木一樣。就像視覺效果一樣，模型師使用聲音效果來呈現現實的口感和印象——因為沒有兩個秒的聲音檔案可以模仿連續聲音的現實。 

distance

型別：十進位制對 - 米：radius_Begin_fading，radius_cut_off_&_stop

預設值：50,150

強制：否

描述：從源頭到聲音可聽見的距離範圍，以米為單位。

• 最小距離定義了聲音保持 100% 音量的半徑範圍。
• 超出該距離，聲音的音量將自然衰減。
• 最大距離定義了遊戲將不再播放聲音的半徑範圍。這並不意味著聲音淡出行為將按比例縮放到該值，以便它在最大距離處淡出到零，而是意味著聲音將在該點突然切斷。提示：由內容建立者選擇合適的距離 - 較小的距離對效能更好，因為資產影響半徑越快被越過，CPU 的流程迴圈越快將其從迴圈中刪除，從而關注其他事情。注意幀率！那個漂亮的聲音是有成本的。

nostartdelay

型別：布林值

預設值：0

強制：否

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

priority

型別：整數

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

repeat-delay

型別：十進位制對

預設值：0,0

強制：是 (3.4)

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

sound

型別：容器

預設值：{}

強制：是

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

有效的 WAV 檔案是

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

取樣率可以是 22kHz (22,050Hz) 或 44kHz (44,100Hz)。更高的取樣率會使檔案大小增加一倍，而不會顯著提高質量，因此不建議使用。對於某些目的，有額外的要求 - 例如，方向性聲音必須是單聲道的。

trigger

型別：字串

預設值：""

強制：否

描述：'trigger' 標籤為你的聲音提供了一個名稱，使它可以從TrainzScript、動畫和某些預定義事件中播放。 （至少有一個“預定義事件”是使用“toggle”一詞，當在 "kind mojunction" 的 config.txt 檔案中包含聲音指令碼容器時。 這將使聲音在每次轉換開關切換時觸發）

value-range

型別：浮點數對

預設值：0,0 (關閉)

強制：否

描述：2 個數字，其中數字不相同，用於設定聲音播放的開始和結束時間。 午夜為 0.5，中午為 0.0 或 1.0。 （待定。這有點模糊。）

volume

型別：小數

預設值：1

強制：否

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

soundscript-ID

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

預設值：""

強制：否，除非聲音指令碼容器管理多個聲音。 （見下面的早晚示例）

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

與其他容器 '-ID' 作為字尾的術語類似於Index_of_Tags_%26_Containers

示例 Config.txt 檔案

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

地圖檔案中的聲音指令碼

 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
     }
   }
 }

作為可放置的場景音效的聲音指令碼

這是一個實際的 TB v1.3 資產，升級到 V2.7 (TC1&2)——此級別是一個有用的中間狀態，包含了大多數主要的必要更改，並且作為檢查，消除了現在非法但以前有用的快速分類TBS 標籤，例如region、type、asset-name 和其他此類被棄用的關鍵字，如autoanimation（其操作被納入到諸如網格表containers 和 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 語言程式設計實踐世界中存在著不同的縮排風格。 聲音指令碼容器使用一種這樣的格式約定，而最後三個容器使用另一種常見的縮排方法。 通常情況下，Content Manager 會解壓縮並生成容器的第一種形式，但 CM & CMP 對其他形式非常寬容，只要字元之間存在空格字元。 在 C、C++ 和 C# 語言中，不需要這種空格填充，括號字元本身就足以在解析資料元素時進行分隔。 Trainz 的解析能力要差得多。