Prototype/Fluid: Difference between revisions

Latest revision as of 14:18, 12 May 2021

Prototype definitions » PrototypeBase » Prototype/Fluid

A fluid.

Prototype/Fluid — `fluid`
base_color	::	Color
default_temperature	::	double
flow_color	::	Color
icons, icon, icon_size (IconSpecification)	::	IconSpecification
emissions_multiplier	::	double (optional)
fuel_value	::	Energy (optional)
gas_temperature	::	double (optional)
heat_capacity	::	Energy (optional)
hidden	::	bool (optional)
max_temperature	::	double (optional)
subgroup	::	string (optional)
Inherited from PrototypeBase
name	::	string
type	::	string
localised_description	::	LocalisedString (optional)
localised_name	::	LocalisedString (optional)
order	::	Order (optional)

Mandatory properties

Inherits all properties from PrototypeBase.

icons, icon, icon_size (IconSpecification)

Type: IconSpecification

default_temperature

Type: double
Also the minimum temperature of the fluid. Has to be lower than max_temperature.

base_color

Type: Color
Used by bars that show the fluid color, like the flamethrower turret fill bar in the tooltip, or the fill bar for the fluidwagon tooltip; and for the pipe windows and storage tank fill gauges.

flow_color

Type: Color
Used only for pipe windows or storage tank fill gauges.

Optional properties

max_temperature

Type: double
Default: value of default_temperature

heat_capacity

Type: Energy
Default: "1KJ"
Joule needed to heat 1 Unit by 1 °C.

fuel_value

Type: Energy
Default: "0J"

emissions_multiplier

Type: double
Default: 1.0
Scales pollution generated when the fluid is consumed.

subgroup

Type: string
Default: "fluid"
The value of this property may not be an empty string. It either has to be nil, or a non-empty string.

gas_temperature

Type: double
Default: max value of double
Above this temperature the gas_flow animation is used to display the fluid inside storage tanks and pipes.

hidden

Type: bool
Default: false
Hides the fluid from the signal selection screen.

Custom properties

The base mod reads the following property in data-updates.lua to determine if the fluid should be barreled. The property itself is not read by the C++ part of the game which means that it is discarded by the game when loading finishes.

auto_barrel - bool - Optional, defaults to true. Whether the fluid should be included in the barrel recipes automatically generated in data-updates.lua in the base mod.

Example

  {
    type = "fluid",
    name = "water",
    default_temperature = 15,
    max_temperature = 100,
    heat_capacity = "0.2KJ",
    base_color = {r=0, g=0.34, b=0.6},
    flow_color = {r=0.7, g=0.7, b=0.7},
    icon = "__base__/graphics/icons/fluid/water.png",
    icon_size = 64,
    icon_mipmaps = 4,
    order = "a[fluid]-a[water]"
  }

@@ Line 1: / Line 1: @@
 {{Prototype parent|PrototypeBase}}
+A fluid.
-== Basics ==
+{{Prototype TOC|fluid}}
-Prototype type: '''fluid'''
-A fluid.
 == Mandatory properties ==
 Inherits all properties from [[PrototypeBase]].
-=== icons, icon,  icon_size (IconSpecification) ===
+{{Prototype property|icons, icon, icon_size (IconSpecification)|[[Types/IconSpecification|IconSpecification]]}}
-'''Type''': [[Types/IconSpecification]]
-=== default_temperature ===
+{{Prototype property|default_temperature|[[Types/double|double]]}}
-'''Type''': [[Types/double]]
+Also the minimum temperature of the fluid. Has to be lower than <code>max_temperature</code>.
-Also the minimum temperature of the fluid.
-=== max_temperature ===
-'''Type''': [[Types/double]]
-=== base_color ===
-'''Type''': [[Types/Color]]
+{{Prototype property|base_color|[[Types/Color|Color]]}}
 Used by bars that show the fluid color, like the flamethrower turret fill bar in the tooltip, or the fill bar for the fluidwagon tooltip; and for the pipe windows and storage tank fill gauges.
-=== flow_color ===
+{{Prototype property|flow_color|[[Types/Color|Color]]}}
-'''Type''': [[Types/Color]]
 Used only for pipe windows or storage tank fill gauges.
 == Optional properties ==
-=== heat_capacity ===
+{{Prototype property|max_temperature|[[Types/double|double]]|value of <code>default_temperature</code>|optional=true}}
-'''Type''': [[Types/Energy]]
-'''Default''': "1KJ"
+{{Prototype property|heat_capacity|[[Types/Energy|Energy]]|"1KJ"|optional=true}}
 Joule needed to heat 1 Unit by 1 °C.
-=== fuel_value ===
+{{Prototype property|fuel_value|[[Types/Energy|Energy]]|"0J"|optional=true}}
-'''Type''': [[Types/Energy]]
-'''Default''': "0J"
-=== emissions_multiplier ===
-'''Type''': [[Types/double]]
-'''Default''': 1.0
+{{Prototype property|emissions_multiplier|[[Types/double|double]]|1.0|optional=true}}
 Scales pollution generated when the fluid is consumed.
-=== subgroup ===
+{{Prototype property|subgroup|[[Types/string|string]]|"fluid"|optional=true}}
-'''Type''': [[Types/string]]
-'''Default''': "fluid"
 The value of this property may not be an empty string. It either has to be nil, or a non-empty string.
-=== gas_temperature ===
+{{Prototype property|gas_temperature|[[Types/double|double]]|max value of double|optional=true}}
-'''Type''': [[Types/double]]
+Above this temperature the <code>gas_flow</code> animation is used to display the fluid inside storage tanks and pipes.
-'''Default''': max value of double (1.7976931348623158e+308)
-=== hidden ===
-'''Type''': [[Types/bool]]
-'''Default''': false
+{{Prototype property|hidden|[[Types/bool|bool]]|false|optional=true}}
 Hides the fluid from the signal selection screen.
-=== auto_barrel ===
+== Custom properties ==
-'''Type''': [[Types/bool]]
+The base mod reads the following property in data-updates.lua to determine if the fluid should be barreled. The property itself is not read by the C++ part of the game which means that it is discarded by the game when loading finishes.
+* auto_barrel - [[Types/bool|bool]] - Optional, defaults to true. Whether the fluid should be included in the barrel recipes automatically generated in data-updates.lua in the base mod.
-Whether the fluid should be included in the barrel recipes automatically generated in data-updates.lua in the base mod. Not actually a property of the prototype, so it is discarded by the game when loading finishes.
 == Example ==
@@ Line 85: / Line 53: @@
      flow_color = {r=0.7, g=0.7, b=0.7},
      icon = "__base__/graphics/icons/fluid/water.png",
-     icon_size = 32,
+     icon_size = 64,
-     order = "a[fluid]-a[water]",
+    icon_mipmaps = 4,
-    pressure_to_speed_ratio = 0.4,
+     order = "a[fluid]-a[water]"
-    flow_to_energy_ratio = 0.59
    }</syntaxhighlight>