NML:Canals

NewGRF Meta Language

Preface

Getting started

Graphics files

Blocks

Units

Expressions

Elementary values

Builtin functions

Language files

Lists of props, vars and CBs

Warnings

Additional references

NewGRF compatibility

Deprecated syntax

Changes from NML 0.2 to 0.3

Changes from NML 0.3 to 0.4

Changes from NML 0.4 to 0.5

Vehicles, Stations, Roadstops, Canals, Towns, Houses, Industries (Tiles), Cargos, Airports+Tiles, Objects, Railtypes, Roadtypes, Tramtypes, Bridges, Badges, Terrain

NML Tutorial

Props, Vars and CBs

General

• variables

Vehicles

• common props | vars | CBs
• train | roadveh | ship | aircr props

Stations

• properties | variables | callbacks

Roadstops

• properties | variables | callbacks

Canals

• properties | variables | callbacks

Towns

Houses

• properties | variables | callbacks

Industries

• common variables
• industry props | vars | CBs
• tile props | vars | CBs

Cargos

• properties | variables | callbacks

Airports

• airport props | vars | CBs
• tile props | vars | CBs

Objects

• properties | variables | callbacks

Railtypes

• properties | variables | callbacks

Roadtypes

• properties | variables | callbacks

Tramtypes

• properties | variables | callbacks

Bridges

• properties | variables | callbacks

Badges

• properties | variables |callbacks

Canal properties

 item (FEAT_CANAL, item_name, id) { ... }

name	value range	comment
graphic_flags	bitmask(flags)	only possible value other than undefined: WATERFEATURE_ALTERNATIVE_SPRITES

graphic_flags

the WATERFEATURE_ALTERNATIVE_SPRITES defines the type of spritesets used by the single ids of canals (compare also nfo specs)

Canal variables

name	value range	comment
tile_height	0 .. max_tile_height	NML 0.2 Tile height in pixels (=tiles * 8). NML 0.3 Tile height in tiles.
terrain_type	TILETYPE_XXX	TILETYPE_NORMAL Normal grass in all climates TILETYPE_DESERT TILETYPE_RAIN_FOREST In tropical climate only: some tiles in the mountains, distant from desert and sea TILETYPE_SNOW
random_bits	0 .. 255	random bits of that tile

Canal callbacks

callback	return value	comment
default	spriteset	graphics for the canal id
sprite_offset		numeric offset into the spriteset for the canal id

Canal ids

name	use	normal sprites	alternative sprites
WF_WATERCLIFFS	1.1 2.6 water for canals / locks	4 slope sprites	1 flat ground sprite followed by 4 slope sprites
WF_LOCKS	0.6 2.5 Locks	24	undefined
WF_DIKES	0.6 2.5 Dikes	12	undefined
WF_CANAL_GUI	2.5 Canal GUI	1	undefined
WF_FLAT_DOCKS	2.5 Flat docks	4	undefined
WF_RIVER_SLOPE	1.1 2.6 River water	4	1 flat ground sprite followed by 4 slope sprites
WF_RIVERBANKS	0.6 2.6 Riverbanks	12*5 (Last 4 for slopes)	undefined
WF_RIVER_GUI	2.6 River GUI	2	undefined
WF_BUOY	1.2  Buoy	1	undefined