Prototype/Sound: Difference between revisions
(Set prototype parent) |
(Converted to SMW format) |
||
Line 1: | Line 1: | ||
{{Prototype parent}} | {{Prototype parent}} | ||
Specifies a sound that can be used with https://lua-api.factorio.com/latest/Concepts.html#SoundPath during runtime. | |||
{{Prototype TOC|sound}} | |||
Prototype | |||
== Mandatory properties == | == Mandatory properties == | ||
{{Prototype property|type|[[Types/string|string]]}} | |||
Must be "sound". | Must be "sound". | ||
{{Prototype property|name|[[Types/string|string]]}} | |||
Name of the sound. Must be unique. Used in https://lua-api.factorio.com/latest/Concepts.html#SoundPath. | Name of the sound. Must be unique. Used in https://lua-api.factorio.com/latest/Concepts.html#SoundPath. | ||
== Optional properties == | == Optional properties == | ||
{{Prototype property|category|[[Types/string|string]]|"game-effect"|optional=true}} | |||
One of "game-effect", "gui-effect", "environment", "walking" and "alert". | One of "game-effect", "gui-effect", "environment", "walking" and "alert". | ||
{{Prototype property|aggregation|[[Types/table|table]]|optional=true}} | |||
Table with the following members: | Table with the following members: | ||
* max_count - [[Types/uint32]] - Mandatory. | * max_count - [[Types/uint32|uint32]] - Mandatory. | ||
* progress_threshold - [[Types/float]] - Optional. - Default: 1.0 - If count already playing is true, this will determine maximum progress when instance is counted toward playing sounds. | * progress_threshold - [[Types/float|float]] - Optional. - Default: 1.0 - If count already playing is true, this will determine maximum progress when instance is counted toward playing sounds. | ||
* remove - [[Types/bool]] - Mandatory. | * remove - [[Types/bool|bool]] - Mandatory. | ||
* count_already_playing - [[Types/bool]] - Optional. - Default: false - If true already playing sounds are taken into account when checking maxCount. | * count_already_playing - [[Types/bool|bool]] - Optional. - Default: false - If true already playing sounds are taken into account when checking maxCount. | ||
{{Prototype property|audible_distance_modifier|[[Types/double|double]]|1.0|optional=true}} | |||
{{Prototype property|variations|[[Types/table|table]] of [[Types/table|table]]s|optional=true}} | |||
Array of tables with the following members: | Array of tables with the following members: | ||
* filename - [[Types/FileName]] - Mandatory. | * filename - [[Types/FileName|FileName]] - Mandatory. | ||
* volume - [[Types/float]] - Optional. - Default: 1.0 | * volume - [[Types/float|float]] - Optional. - Default: 1.0 | ||
* preload - [[Types/bool]] - Optional. | * preload - [[Types/bool|bool]] - Optional. | ||
{{Prototype property|filename|[[Types/FileName|FileName]]|optional=true}} | |||
Mandatory if <code>variations</code> is not given. | Mandatory if <code>variations</code> is not given. | ||
{{Prototype property|volume|[[Types/float|float]]|1.0|optional=true}} | |||
Only loaded if <code>variations</code> is not given. | Only loaded if <code>variations</code> is not given. | ||
{{Prototype property|preload|[[Types/bool|bool]]|optional=true}} | |||
Only loaded if <code>variations</code> is not given. | Only loaded if <code>variations</code> is not given. |
Revision as of 22:13, 27 July 2019
Template:Prototype parent Specifies a sound that can be used with https://lua-api.factorio.com/latest/Concepts.html#SoundPath during runtime.
Mandatory properties
Template:Prototype property Must be "sound".
Template:Prototype property Name of the sound. Must be unique. Used in https://lua-api.factorio.com/latest/Concepts.html#SoundPath.
Optional properties
Template:Prototype property One of "game-effect", "gui-effect", "environment", "walking" and "alert".
Template:Prototype property Table with the following members:
- max_count - uint32 - Mandatory.
- progress_threshold - float - Optional. - Default: 1.0 - If count already playing is true, this will determine maximum progress when instance is counted toward playing sounds.
- remove - bool - Mandatory.
- count_already_playing - bool - Optional. - Default: false - If true already playing sounds are taken into account when checking maxCount.
Template:Prototype property Array of tables with the following members:
- filename - FileName - Mandatory.
- volume - float - Optional. - Default: 1.0
- preload - bool - Optional.
Template:Prototype property
Mandatory if variations
is not given.
Template:Prototype property
Only loaded if variations
is not given.
Template:Prototype property
Only loaded if variations
is not given.