Prototype/NamedNoiseExpression: Difference between revisions
(Replace 0.16 info with stuff about overriding via MapGenSettings) |
(Talk about intended_property and order) |
||
| Line 21: | Line 21: | ||
The expression itself. | The expression itself. | ||
== Optional properties == | |||
=== intended_property === | |||
'''Type''': [[Types/string]] | |||
Names the property that this expression is intended to provide a value for, if any. | |||
For example if a noise expression is intended to be used as an alternative temperature generator, <code>intended_property</code> should be "temperature". | |||
=== order === | |||
'''Type''': [[Types/Order]] | |||
Used to order alternative expressions in the map generator GUI. | |||
For a given property (e.g. 'temperature'), the NamedNoiseExpression with that property's name as its <code>intended_property</code> | |||
with the lowest order will be chosen as the default in the GUI. | |||
If no order is specified, it defaults to "2000" if the property name matches the expression name | |||
(making it the 'technical default' generator for the property if none is specified in MapGenSettings), | |||
or "3000" otherwise. A generator defined with an order less than "2000" but with a unique name | |||
can thereby override the default generator used when creating a new map through the GUI without automatically overriding | |||
the 'technical default' generator, which is probably used by existing maps. | |||
Revision as of 21:15, 22 May 2019
Basics
Prototype type: noise-expression
A Types/NoiseExpression together with a name.
Named noise expressions are used to specify functions for elevation, temperature, moisture, aux, and cliffiness.
e.g. the "elevation" expression is used to calculate elevation for every point on a map.
MapGenSettings
can override which named expression is used to calculate a given property by having an entry in
property_expression_names. e.g. elevation = "0.16-elevation"
Mandatory properties
Inherits all properties from Prototype.
expression
Type: Types/NoiseExpression
The expression itself.
Optional properties
intended_property
Type: Types/string
Names the property that this expression is intended to provide a value for, if any.
For example if a noise expression is intended to be used as an alternative temperature generator, intended_property should be "temperature".
order
Type: Types/Order
Used to order alternative expressions in the map generator GUI.
For a given property (e.g. 'temperature'), the NamedNoiseExpression with that property's name as its intended_property
with the lowest order will be chosen as the default in the GUI.
If no order is specified, it defaults to "2000" if the property name matches the expression name (making it the 'technical default' generator for the property if none is specified in MapGenSettings), or "3000" otherwise. A generator defined with an order less than "2000" but with a unique name can thereby override the default generator used when creating a new map through the GUI without automatically overriding the 'technical default' generator, which is probably used by existing maps.