NML:Stations - Revision history

Rito12: /* Station properties */ Litle tweaks.

2026-04-15T14:31:53Z

Station properties: Litle tweaks.

← Older revision		Revision as of 14:31, 15 April 2026
Line 53:		Line 53:
	There is one special class:		There is one special class:
	* "WAYP": The station type will be shown in the waypoint construction window, instead of the station construction window.		* "WAYP": The station type will be shown in the waypoint construction window, instead of the station construction window.
	{{ottdp\|15}} Station classes which start with the byte FF are considered waypoint classes, and will appear in the waypoint construction window instead of the station construction window.		{{ottdp\|15.0}} Station classes which start with the byte FF are considered waypoint classes, and will appear in the waypoint construction window instead of the station construction window.
	\|-		\|-
	\| classname		\| classname
Line 93:		Line 93:
	;STAT_FLAG_DISTRIBUTED_CARGO_BY_PERIMETER {{nml\|0.9.0}}		;STAT_FLAG_DISTRIBUTED_CARGO_BY_PERIMETER {{nml\|0.9.0}}
	:Specifies whether waiting cargo amounts are scaled by station '''perimeter''' for spriteset selection, see [[NML:Spritegroup#Stations\|spritegroup]] for details.		:Specifies whether waiting cargo amounts are scaled by station '''perimeter''' for spriteset selection, see [[NML:Spritegroup#Stations\|spritegroup]] for details.
	:Since {{ottd\|16.0}} if STAT_FLAG_DISTRIBUTED_CARGO_BY_AREA is also set it does not do anything.		:Since {{ottd\|16.0}} if <code style="color:darkgreen">STAT_FLAG_DISTRIBUTED_CARGO_BY_AREA</code> is also set it does not do anything.
	;STAT_FLAG_DISTRIBUTED_CARGO_BY_AREA {{ottd\|16.0}} {{nml\|0.9.0}}		;STAT_FLAG_DISTRIBUTED_CARGO_BY_AREA {{ottd\|16.0}} {{nml\|0.9.0}}
	:Specifies whether waiting cargo amounts are scaled by station '''area''' for spriteset selection, see [[NML:Spritegroup#Stations\|spritegroup]] for details.		:Specifies whether waiting cargo amounts are scaled by station '''area''' for spriteset selection, see [[NML:Spritegroup#Stations\|spritegroup]] for details.

Rito12: /* Station properties */ Update to nml #422.

2026-04-15T14:30:43Z

Station properties: Update to nml #422.

← Older revision		Revision as of 14:30, 15 April 2026
Line 91:		Line 91:
	\| bitmask(STAT_FLAG_XXX, STAT_FLAG_YYY, ...)		\| bitmask(STAT_FLAG_XXX, STAT_FLAG_YYY, ...)
	\|		\|
			;STAT_FLAG_DISTRIBUTED_CARGO_BY_PERIMETER {{nml\|0.9.0}}
⚫	;STAT_FLAG_DISTRIBUTED_CARGO
	:Specifies whether waiting cargo amounts are scaled by station ~~size~~ for spriteset selection, see [[NML:Spritegroup#Stations\|spritegroup]] for details.		:Specifies whether waiting cargo amounts are scaled by station '''perimeter''' for spriteset selection, see [[NML:Spritegroup#Stations\|spritegroup]] for details.
			:Since {{ottd\|16.0}} if STAT_FLAG_DISTRIBUTED_CARGO_BY_AREA is also set it does not do anything.
			;STAT_FLAG_DISTRIBUTED_CARGO_BY_AREA {{ottd\|16.0}} {{nml\|0.9.0}}
			:Specifies whether waiting cargo amounts are scaled by station '''area''' for spriteset selection, see [[NML:Spritegroup#Stations\|spritegroup]] for details.
	;STAT_FLAG_RANDOM_ANIMATION		;STAT_FLAG_RANDOM_ANIMATION
	:If set, callback <code style="color:darkgreen">anim_next_frame</code> will get random data in <code style="color:darkgreen">extra_callback_info1</code>		:If set, callback <code style="color:darkgreen">anim_next_frame</code> will get random data in <code style="color:darkgreen">extra_callback_info1</code>
Line 99:		Line 102:
	;STAT_FLAG_EXTENDED_FOUNDATIONS		;STAT_FLAG_EXTENDED_FOUNDATIONS
	:Selects between two possible spriteset formats for callback <code style="color:darkgreen">foundations</code>, see below.		:Selects between two possible spriteset formats for callback <code style="color:darkgreen">foundations</code>, see below.
		⚫	;STAT_FLAG_DISTRIBUTED_CARGO
			:Deprecated since {{nml\|0.9.0}}.
	\|-		\|-
	\| animation_info		\| animation_info

Rito12: /* Station properties */ Add missing flags.

2026-03-19T18:32:04Z

Station properties: Add missing flags.

← Older revision		Revision as of 18:32, 19 March 2026
Line 110:		Line 110:
	\|-		\|-
	\| animation_triggers		\| animation_triggers
	\| bitmask(STAT_ANIM_XXX, ~~STAT_ANIM_YYY~~, ...)		\| bitmask(STAT_ANIM_XXX, ANIM_TRIGGER_STAT_YYY, ...)
	\| Enables callback <code style="color:darkgreen">anim_control</code> for specified triggers:		\| Enables callback <code style="color:darkgreen">anim_control</code> for specified triggers:
	;STAT_ANIM_IS_BUILT		;STAT_ANIM_IS_BUILT
Line 126:		Line 126:
	;STAT_ANIM_250_TICKS		;STAT_ANIM_250_TICKS
	:Every 250 ticks. (synchronized for all tiles of the station)		:Every 250 ticks. (synchronized for all tiles of the station)
			;{{ottd\|15.0}} ANIM_TRIGGER_STAT_TILELOOP
			:Tile is processed in the periodic processing loop
			;{{ottd\|15.0}} ANIM_TRIGGER_STAT_TRAIN_RESERVES
			:Train reserves platform (using PBS)
	\|-		\|-
	\| badges		\| badges

Rito12: /* Variables that require one or more arguments */ has_badge

2026-01-04T14:45:33Z

Variables that require one or more arguments: has_badge

← Older revision		Revision as of 14:45, 4 January 2026
Line 471:		Line 471:
	\| -8..7		\| -8..7
	\| Platform number, counting top to bottom, using 0 for the middle platform. When the number of platforms is even, the southernmost of the two middle platformsis assigned number 0, so there is one more negative than positive number. Using PLATFORM_SAME_DIRECTION is not possible here.		\| Platform number, counting top to bottom, using 0 for the middle platform. When the number of platforms is even, the southernmost of the two middle platformsis assigned number 0, so there is one more negative than positive number. Using PLATFORM_SAME_DIRECTION is not possible here.
			\|-
			\| has_badge
			\| Label from the [[NML:Badgetable\|badgetable]].
			\| [0 <nowiki>\|</nowiki> 1]
			\| {{ottd\|15.0}} Check if the rail station has that specific badge attached.
	\|}		\|}
	<references/>		<references/>

Rito12: /* Station properties */ Update tile_flags

2026-01-04T13:01:35Z

Station properties: Update tile_flags

← Older revision		Revision as of 13:01, 4 January 2026
Line 132:		Line 132:
	\|-		\|-
	\| tile_flags		\| tile_flags
			\| Array of <code>bitmask(STAT_TILE_XXX, ...)</code>
	\|
	\| Since {{ottd\|15.0}}		\| Since {{ottd\|15.0}} {{nml\|0.7.6}} <br>
			Each element of array corresponds to one tile type. Array should always have even number of elements. <br>
			'''XXX''' should be replaced by one of the following:
			; PYLON
			: Draw pylon on tile with that type.
			; NOWIRE
			: Hide wire on tile with that type.
			; BLOCKED
			: Do not allow trains to enter tile with that type.
	\|}		\|}

Rito12: /* Station properties */ prepear tile_flags

2026-01-03T23:19:33Z

Station properties: prepear tile_flags

← Older revision		Revision as of 23:19, 3 January 2026
Line 131:		Line 131:
	\| Since {{ottd\|15.0}}		\| Since {{ottd\|15.0}}
	\|-		\|-
			\| tile_flags
			\|
			\| Since {{ottd\|15.0}}
	\|}		\|}

Rito12: badges property

2026-01-03T21:20:58Z

badges property

← Older revision		Revision as of 21:20, 3 January 2026
Line 126:		Line 126:
	;STAT_ANIM_250_TICKS		;STAT_ANIM_250_TICKS
	:Every 250 ticks. (synchronized for all tiles of the station)		:Every 250 ticks. (synchronized for all tiles of the station)
			\|-
			\| badges
			\| Array of badge labels from the [[NML:Badgetable\|badgetable]].
			\| Since {{ottd\|15.0}}
	\|-		\|-
	\|}		\|}

Rito12: /* Station properties */ Move deprication note into comments collumn.

2026-01-03T19:52:53Z

Station properties: Move deprication note into comments collumn.

← Older revision		Revision as of 19:52, 3 January 2026
Line 76:		Line 76:
	\| Threshold between <code style="color:darkgreen">little</code> and <code style="color:darkgreen">lots</code> spritesets, see [[NML:Spritegroup#Stations\|spritegroup]] for details.		\| Threshold between <code style="color:darkgreen">little</code> and <code style="color:darkgreen">lots</code> spritesets, see [[NML:Spritegroup#Stations\|spritegroup]] for details.
	\|-		\|-
	\| draw_pylon_tiles <br> hide_wire_tiles <br> non_traversable_tiles <br> ~~(deprecated since {{nml\|0.7.6}}, replaced by `tile_flags`)~~		\| draw_pylon_tiles <br> hide_wire_tiles <br> non_traversable_tiles <br>
	\| bitmask(0, 1, 2, 3, 4, 5, 6, 7)		\| bitmask(0, 1, 2, 3, 4, 5, 6, 7)
			\| '''Deprecated since '''{{nml\|0.7.6}}''' , replaced by '''<code style="color:darkgreen">tile_flags</code>'''.'''<br>
	\| Specifies which [[#Tile_types\|tile types]] are traversible/non-traversible, and whether pylons and/or catenary shall be drawn for electrified rail types.		Specifies which [[#Tile_types\|tile types]] are traversible/non-traversible, and whether pylons and/or catenary shall be drawn for electrified rail types.
	Note: it is common that all tile types behave the same, you may want to use the short cuts		Note: it is common that all tile types behave the same, you may want to use the short cuts
	* <code style="color:darkgreen">0</code> for no tile types, and		* <code style="color:darkgreen">0</code> for no tile types, and

Rito12: Improve notice about 256 tile types

2026-01-03T19:37:02Z

Improve notice about 256 tile types

← Older revision		Revision as of 19:37, 3 January 2026
Line 33:		Line 33:
	The tile type is immutable after construction. So, unlike the platform/position information, the tile type will never change after construction, even if tiles of the station section are removed or overbuilt.		The tile type is immutable after construction. So, unlike the platform/position information, the tile type will never change after construction, even if tiles of the station section are removed or overbuilt.

	The number of tile types is quite limited: 4 per orientation, 8 in total. ~~(256 since nml 0.7.6)~~		The number of tile types is quite limited: 4 per orientation, 8 in total.
			'''Note:''' Since {{ottd\|15.0}} {{nml\|0.7.6}} it is possible to register up to 256 tile types.
	* Tile types 0, 2, 4 and 6 are used for station sections with tracks in X direction (⤢).		* Tile types 0, 2, 4 and 6 are used for station sections with tracks in X direction (⤢).
	* Tile types 1, 3, 5 and 7 are used for station sections with tracks in Y direciton (⤡).		* Tile types 1, 3, 5 and 7 are used for station sections with tracks in Y direciton (⤡).
Line 75:		Line 76:
	\| Threshold between <code style="color:darkgreen">little</code> and <code style="color:darkgreen">lots</code> spritesets, see [[NML:Spritegroup#Stations\|spritegroup]] for details.		\| Threshold between <code style="color:darkgreen">little</code> and <code style="color:darkgreen">lots</code> spritesets, see [[NML:Spritegroup#Stations\|spritegroup]] for details.
	\|-		\|-
	\| draw_pylon_tiles <br> hide_wire_tiles <br> non_traversable_tiles <br> (deprecated since nml 0.7.6, replaced by `tile_flags`)		\| draw_pylon_tiles <br> hide_wire_tiles <br> non_traversable_tiles <br> (deprecated since {{nml\|0.7.6}}, replaced by `tile_flags`)
	\| bitmask(0, 1, 2, 3, 4, 5, 6, 7)		\| bitmask(0, 1, 2, 3, 4, 5, 6, 7)
	\| Specifies which [[#Tile_types\|tile types]] are traversible/non-traversible, and whether pylons and/or catenary shall be drawn for electrified rail types.		\| Specifies which [[#Tile_types\|tile types]] are traversible/non-traversible, and whether pylons and/or catenary shall be drawn for electrified rail types.
Line 226:		Line 227:
	\| tile_type		\| tile_type
	\| 0..7		\| 0..7
			; 0..255 {{ottd\|15.0}}
	\| The type of tile, as decided by <code style="color:darkgreen">select_tile_type</code>. Bit 0 also tells the orientation.		\| The type of tile, as decided by <code style="color:darkgreen">select_tile_type</code>. Bit 0 also tells the orientation.
	\|-		\|-
Line 406:		Line 408:
	\| tile- and platform-offset <ref name="offset"/>		\| tile- and platform-offset <ref name="offset"/>
	\| 0..7		\| 0..7
			; 0..255 {{ottd\|15.0}}
	\| [[#Tile_types\|Tile type]] of the given tile. The orientation bit is adjusted to be relative to the current tile's orientation:		\| [[#Tile_types\|Tile type]] of the given tile. The orientation bit is adjusted to be relative to the current tile's orientation:
	* 0, 2, 4, 6: Tracks are parallel.		* 0, 2, 4, 6: Tracks are parallel.
Line 530:		Line 533:
	\| [0 <nowiki>\|</nowiki> 2 <nowiki>\|</nowiki> 4 <nowiki>\|</nowiki> 6]		\| [0 <nowiki>\|</nowiki> 2 <nowiki>\|</nowiki> 4 <nowiki>\|</nowiki> 6]

	Since {{ottdp\|15}}, even values up to FE can be returned as long at the tile is defined.		Since {{ottdp\|15}}, even values up to FE can be returned as long as the tile is defined.
	\| Decides which tile type to store for each tile during construction. The lowest bit is always defined by the station orientation, no matter the callback result. See also [[#Tile_types\|tile type above]].		\| Decides which tile type to store for each tile during construction. The lowest bit is always defined by the station orientation, no matter the callback result. See also [[#Tile_types\|tile type above]].

Rito12: Added comments on tile_type value and draw_pylon_tile deprecation

2025-07-19T07:47:55Z

Added comments on tile_type value and draw_pylon_tile deprecation

← Older revision		Revision as of 07:47, 19 July 2025
Line 33:		Line 33:
	The tile type is immutable after construction. So, unlike the platform/position information, the tile type will never change after construction, even if tiles of the station section are removed or overbuilt.		The tile type is immutable after construction. So, unlike the platform/position information, the tile type will never change after construction, even if tiles of the station section are removed or overbuilt.

	The number of tile types is quite limited: 4 per orientation, 8 in total.		The number of tile types is quite limited: 4 per orientation, 8 in total. (256 since nml 0.7.6)
	* Tile types 0, 2, 4 and 6 are used for station sections with tracks in X direction (⤢).		* Tile types 0, 2, 4 and 6 are used for station sections with tracks in X direction (⤢).
	* Tile types 1, 3, 5 and 7 are used for station sections with tracks in Y direciton (⤡).		* Tile types 1, 3, 5 and 7 are used for station sections with tracks in Y direciton (⤡).
Line 75:		Line 75:
	\| Threshold between <code style="color:darkgreen">little</code> and <code style="color:darkgreen">lots</code> spritesets, see [[NML:Spritegroup#Stations\|spritegroup]] for details.		\| Threshold between <code style="color:darkgreen">little</code> and <code style="color:darkgreen">lots</code> spritesets, see [[NML:Spritegroup#Stations\|spritegroup]] for details.
	\|-		\|-
	\| draw_pylon_tiles <br> hide_wire_tiles <br> non_traversable_tiles		\| draw_pylon_tiles <br> hide_wire_tiles <br> non_traversable_tiles <br> (deprecated since nml 0.7.6, replaced by `tile_flags`)
	\| bitmask(0, 1, 2, 3, 4, 5, 6, 7)		\| bitmask(0, 1, 2, 3, 4, 5, 6, 7)
	\| Specifies which [[#Tile_types\|tile types]] are traversible/non-traversible, and whether pylons and/or catenary shall be drawn for electrified rail types.		\| Specifies which [[#Tile_types\|tile types]] are traversible/non-traversible, and whether pylons and/or catenary shall be drawn for electrified rail types.