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 的解析能力远不如这些语言。