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 的解析能力要差得多。