NML:Canals: Difference between revisions

From GRFSpecs
Jump to navigation Jump to search
← Older edit
Content deleted Content added
Heresy (talk | contribs)
32 edits
m Changed the appropriate tables from t to sortable
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{NMLNavPropVarCB}}
{{NMLNavPropVarCB}}

== Canal ids ==
The used item ID defines what sprites this item provides. Item IDs should be picked from the following table (WF_XXX).

The 'normal sprites' column contains the amount of sprites that should be provided for this feature. If the appropriate bit in the graphics_flags-property (see below) the amount of sprites stated in the 'alternative sprites' column must be provided instead.
{| class="wikitable sortable"
!name
!use
!normal sprites
!alternative sprites
|-
|WF_WATERCLIFFS
|{{ottdp|1.1|2.6|ottdrev=r20352|ttdprev=r1573}} water for canals / locks
|4 slope sprites
|1 flat ground sprite followed by 4 slope sprites
|-
|WF_LOCKS
|{{ottdp|0.6|2.5}} Locks
|24
|undefined
|-
|WF_DIKES
|{{ottdp|0.6|2.5}} Dikes
|12
|undefined
|-
|WF_CANAL_GUI
|{{ottdp|no|2.5}} Canal GUI
|1
|undefined
|-
|WF_FLAT_DOCKS
|{{ottdp|no|2.5}} Flat docks
|4
|undefined
|-
|WF_RIVER_SLOPE
|{{ottdp|1.1|2.6|ottdrev=r20352|ttdprev=r1573}} River water
|4
|1 flat ground sprite followed by 4 slope sprites
|-
|WF_RIVERBANKS
|{{ottdp|0.6|2.6}} Riverbanks
|12*5 (Last 4 for slopes)
|undefined
|-
|WF_RIVER_GUI
|{{ottdp|no|2.6}} River GUI
|2
|undefined
|-
|WF_BUOY
|{{ottdp|1.2|no|ottdrev=r22973}} Buoy
|1
|undefined
|}



==Canal properties==
==Canal properties==


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


{| class="t"
{| class="t"
Line 12: Line 69:
| graphic_flags
| graphic_flags
| bitmask(flags)
| bitmask(flags)
| only possible value other than undefined: <code style="color:darkgreen">WATERFEATURE_ALTERNATIVE_SPRITES</code>
| There is currently only one possible bit: <code style="color:darkgreen">WATERFEATURE_ALTERNATIVE_SPRITES</code>
|}
|}

=== graphic_flags ===
the <code style="color:darkgreen">WATERFEATURE_ALTERNATIVE_SPRITES</code> defines the type of spritesets used by the single <code style="color:darkgreen">ids</code> of canals (compare also [[Action3/Canals#id| nfo specs]])


== Canal variables ==
== Canal variables ==


{| class="t"
{| class="wikitable sortable"
! name
! name
! value range
! value range
Line 39: Line 93:
:In tropical climate only: some tiles in the mountains, distant from desert and sea
:In tropical climate only: some tiles in the mountains, distant from desert and sea
;TILETYPE_SNOW
;TILETYPE_SNOW
|-
|dike_map
|bitmask(CANAL_DIRECTION_XXX, ...)
|{{ottdp|1.4|no|ottdrev=r25229}} bitmask of the directions where there is a dike: CANAL_DIRECTION_XXX where XXX:
; along the grid:
:NORTHEAST = 0
:SOUTHEAST = 1
:SOUTHWEST = 2
:NORTHWEST = 3
; vertical and horizontal:
:EAST = 4
:SOUTH = 5
:WEST = 6
:NORTH = 7
|-
|-
|random_bits
|random_bits
Line 59: Line 127:
|
|
|numeric offset into the spriteset for the canal id
|numeric offset into the spriteset for the canal id
|}

== Canal ids ==
{| class="t"
!name
!use
!normal sprites
!alternative sprites
|-
|WF_WATERCLIFFS
|{{ottdp|1.1|2.6|ottdrev=r20352|ttdprev=r1573}} water for canals / locks
|4 slope sprites
|1 flat ground sprite followed by 4 slope sprites
|-
|WF_LOCKS
|{{ottdp|0.6|2.5}} Locks
|24
|undefined
|-
|WF_DIKES
|{{ottdp|0.6|2.5}} Dikes
|12
|undefined
|-
|WF_CANAL_GUI
|{{ottdp|no|2.5}} Canal GUI
|1
|undefined
|-
|WF_FLAT_DOCKS
|{{ottdp|no|2.5}} Flat docks
|4
|undefined
|-
|WF_RIVER_SLOPE
|{{ottdp|1.1|2.6|ottdrev=r20352|ttdprev=r1573}} River water
|4
|1 flat ground sprite followed by 4 slope sprites
|-
|WF_RIVERBANKS
|{{ottdp|0.6|2.6}} Riverbanks
|12*5 (Last 4 for slopes)
|undefined
|-
|WF_RIVER_GUI
|{{ottdp|no|2.6}} River GUI
|2
|undefined
|-
|WF_BUOY
|{{ottdp|1.2|no|ottdrev=r22973}} Buoy
|1
|undefined
|}
|}

Latest revision as of 20:56, 30 August 2022

Props, Vars and CBs

Canal ids

The used item ID defines what sprites this item provides. Item IDs should be picked from the following table (WF_XXX).

The 'normal sprites' column contains the amount of sprites that should be provided for this feature. If the appropriate bit in the graphics_flags-property (see below) the amount of sprites stated in the 'alternative sprites' column must be provided instead.

name use normal sprites alternative sprites
WF_WATERCLIFFS Supported by OpenTTD 1.1 (r20352)1.1 Supported by TTDPatch 2.6 (r1573)2.6 water for canals / locks 4 slope sprites 1 flat ground sprite followed by 4 slope sprites
WF_LOCKS Supported by OpenTTD 0.60.6 Supported by TTDPatch 2.52.5 Locks 24 undefined
WF_DIKES Supported by OpenTTD 0.60.6 Supported by TTDPatch 2.52.5 Dikes 12 undefined
WF_CANAL_GUI Not supported by OpenTTD Supported by TTDPatch 2.52.5 Canal GUI 1 undefined
WF_FLAT_DOCKS Not supported by OpenTTD Supported by TTDPatch 2.52.5 Flat docks 4 undefined
WF_RIVER_SLOPE Supported by OpenTTD 1.1 (r20352)1.1 Supported by TTDPatch 2.6 (r1573)2.6 River water 4 1 flat ground sprite followed by 4 slope sprites
WF_RIVERBANKS Supported by OpenTTD 0.60.6 Supported by TTDPatch 2.62.6 Riverbanks 12*5 (Last 4 for slopes) undefined
WF_RIVER_GUI Not supported by OpenTTD Supported by TTDPatch 2.62.6 River GUI 2 undefined
WF_BUOY Supported by OpenTTD 1.2 (r22973)1.2 Not supported by TTDPatch Buoy 1 undefined


Canal properties

 item (FEAT_CANALS, item_name, id) { ... }
name value range comment
graphic_flags bitmask(flags) There is currently only one possible bit: WATERFEATURE_ALTERNATIVE_SPRITES

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
dike_map bitmask(CANAL_DIRECTION_XXX, ...) Supported by OpenTTD 1.4 (r25229)1.4 Not supported by TTDPatch bitmask of the directions where there is a dike: CANAL_DIRECTION_XXX where XXX:
along the grid
NORTHEAST = 0
SOUTHEAST = 1
SOUTHWEST = 2
NORTHWEST = 3
vertical and horizontal
EAST = 4
SOUTH = 5
WEST = 6
NORTH = 7
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
Retrieved from "https://newgrf-specs.tt-wiki.net/index.php?title=NML:Canals&oldid=4246"