docs/landscape.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3
   4 <head>
   5  <meta name="Author" content="Marcin Grzegorczyk">
   6  <meta name="Description" content="Structure of OpenTTD (OTTD) landscape arrays">
   7  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   8  <title>OpenTTD Landscape Internals</title>
   9 </head>
  10
  11 <body>
  12
  13  <h3><a name="Landscape">Landscape</a></h3>
  14  <p>
  15   For a graphical representation of the tile-layout have a look at
  16   <a href="landscape_grid.html">Landscape grid</a> page.
  17  </p>
  18  <p>Nine attributes (counting &quot;<span style="font-weight: bold;">type</span>&quot; and
  19   &quot;<span style="font-weight: bold;">height</span>&quot;) hold the informations about a tile.<BR>
  20   These attributes are referred to as
  21   &quot;<span style="font-weight: bold;">type</span>",
  22   &quot;<span style="font-weight: bold;">height</span>",
  23   &quot;<span style="font-weight: bold;">m1</span>&quot;, &quot;<span style="font-weight: bold;">m2</span>&quot;,
  24   &quot;<span style="font-weight: bold;">m3</span>&quot;, &quot;<span style="font-weight: bold;">m4</span>&quot;,
  25   &quot;<span style="font-weight: bold;">m5</span>&quot;, &quot;<span style="font-weight: bold;">m6</span>&quot;
  26   and "<span style="font-weight: bold;">m7</span>".<br>
  27   The most important value is the class of a tile, stored in the upper 4 bits
  28   of the <span style="font-weight: bold;">type</span> attribute.
  29  </p>
  30
  31  Frequently repeating patterns:
  32  <ul>
  33   <li><span style="font-weight: bold;">type</span>
  34    <ul>
  35     <li>
  36      <a name="type"></a>
  37      Bits 7..4:
  38      <table border="1" style="width: 30em;">
  39       <tr bgcolor="#CCCCCC"><td colspan="2">The tile type.</td></tr>
  40       <tr><td style="width: 5em;"><tt>00</tt></td><td>Ground</td></tr>
  41       <tr><td><tt>01</tt></td><td>Railway tracks</td></tr>
  42       <tr><td><tt>02</tt></td><td>Roads</td></tr>
  43       <tr><td><tt>03</tt></td><td>Town building</td></tr>
  44       <tr><td><tt>04</tt></td><td>Trees</td></tr>
  45       <tr><td><tt>05</tt></td><td>Station tiles</td></tr>
  46       <tr><td><tt>06</tt></td><td>Water</td></tr>
  47       <tr><td><tt>07</tt></td><td>Void</td></tr>
  48       <tr><td><tt>08</tt></td><td>Industries</td></tr>
  49       <tr><td><tt>09</tt></td><td>Tunnel / bridge</td></tr>
  50       <tr><td><tt>0A</tt></td><td>Objects</td></tr>
  51      </table>
  52     </li>
  53      Bits 3..2:
  54      <table border="1" style="width: 30em;">
  55       <tr bgcolor="#CCCCCC"><td colspan="2">Presence and direction of bridge above.</td></tr>
  56       <tr><td style="width: 5em;"><tt>00</tt></td><td>no bridge</td></tr>
  57       <tr><td><tt>01</tt></td><td>Axis X (North-East)</td></tr>
  58       <tr><td><tt>02</tt></td><td>Axis Y (South-West)</td></tr>
  59      </table>
  60     <li>
  61      <a name="tropic_zone"></a>
  62      Bits 1..0:
  63      <table border="1" style="width: 30em;">
  64       <tr bgcolor="#CCCCCC"><td colspan="2">Only meaningfull in tropic climate. It contains the definition of the available zones</td></tr>
  65       <tr><td style="width: 5em;"><tt>00</tt></td><td>normal</td></tr>
  66       <tr><td><tt>01</tt></td><td>desert</td></tr>
  67       <tr><td><tt>02</tt></td><td>rain forest</td></tr>
  68      </table>
  69      In any other climate these 2 bits are theoretically free of use, however using them does not seem useful.
  70     </li>
  71    </ul>
  72   <li><span style="font-weight: bold;">m1</span>
  73    <ul>
  74     <li>
  75      <a name="WaterClass"></a>
  76       Bits 6..5:
  77      <table border="1" style="width: 30em;">
  78       <tr bgcolor="#CCCCCC"><td colspan="2">The type of water that is on a tile.
  79       <tr><td style="width: 5em;"><tt>00</tt></td><td align=left>Sea</td></tr>
  80       <tr><td><tt>01</tt></td><td align=left>Canal</td></tr>
  81       <tr><td><tt>02</tt></td><td align=left>River</td></tr>
  82       <tr><td><tt>03</tt></td><td align=left>Invalid, i.e. no water on this tile</td></tr>
  83      </table>
  84      Some tiles, such as houses, reuse these bits of other purposes.
  85     </li>
  86     <li>
  87      <a name="OwnershipInfo"></a>
  88      Bits 4..0:
  89      <table border="1" style="width: 30em;">
  90       <tr bgcolor="#CCCCCC"><td colspan="2">The owner of a tile can be either companies (human or AI) or "Game entities".
  91       <tr><td style="width: 5em;"><tt>00..0E</tt></td><td align=left>Normal companies</td></tr>
  92       <tr><td><tt>0F</tt></td><td align=left>a town owns the tile</td></tr>
  93       <tr><td><tt>10</tt></td><td align=left>nobody owns the tile</td></tr>
  94       <tr><td><tt>11</tt></td><td align=left>"water" owns the tile</td></tr>
  95       <tr><td><tt>FF</tt></td><td align=left>spectator in MP or in scenario editor</td></tr>
  96      </table>
  97      Some tiles, such as houses and industries, reuse these bits of other purposes.
  98     </li>
  99    </ul>
 100   </li>
 101   <li><span style="font-weight: bold;">m3:</span><br>
 102    <ul>
 103     <li>
 104      <a name="RailType"></a>
 105      Bits 3..0: Railtype. Used for all tiles with rail (road, rail, station, tunnelbridge).
 106     </li>
 107    </ul>
 108   </li>
 109   <li><span style="font-weight: bold;">m4:</span><br>
 110    <a name="RoadType"></a>
 111    Road-(sub-)types. Used for all tiles with road (road, station, tunnelbridge).
 112    <ul>
 113     <li>
 114      Bits 7..4: Tram sub type, 0xF for no tram.
 115     </li>
 116     <li>
 117      Bits 3..0: Road sub type, 0xF for no road.
 118     </li>
 119    </ul>
 120   </li>
 121   <li><span style="font-weight: bold;">m7:</span><br>
 122    Animation frame/state. Used for houses, industries, objects and stations.
 123   </li>
 124  </ul>
 125
 126  <p>OTTD's class-specific periodic tile processing routine is called once every +256 ticks for each tile.</p>
 127
 128  <table border=1 cellpadding=3>
 129   <tr bgcolor="#0099FF">
 130    <th align=left><font color="#FFFFFF">Class</font></th>
 131    <th align=left><font color="#FFFFFF">Meaning & details of encoding</font></th>
 132   </tr>
 133   <tr bgcolor="#CCCCCC">
 134    <td align=left><strong><a name="Class0"><tt> 0 </tt></a></strong></td>
 135    <td align=left>&nbsp;<strong>Ground </strong></td>
 136   </tr>
 137   <tr>
 138    <td valign=top nowrap>&nbsp;</td>
 139    <td>
 140     <ul>
 141      <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> of the tile (normally <tt>10</tt>)</li>
 142      <li>m2: see fields</li>
 143      <li>m3 bits 7..5: type of hedge on NE border of the tile</li>
 144      <li>m3 bits 3..0: see fields</li>
 145      <li>m3 bit 4: set if the tile is covered with snow</li>
 146      <li>m4 bits 7..5: type of hedge on the SW border of the tile (1 through 6, or 0=none)</li>
 147      <li>m4 bits 4..2: same as 7..5, but for the SE border</li>
 148      <li>m5 bits 7..5: update counter, incremented on every periodic processing for tile types,
 149          other than <tt>03</tt>, <tt>07</tt>, <tt>0B</tt>, <tt>10</tt> and above.<BR>
 150          on wraparound, the tile is updated (for fields, the type of fields in m3 is increased, for other types the tile type in m5 is increased).<BR>
 151          For snow and desert, these bits are not used, tile is updated on every periodic processing.</li>
 152      <li>m5 bits 4..2: tile type:
 153       <table>
 154        <tr>
 155         <td nowrap valign=top><tt>0</tt>&nbsp; </td>
 156         <td align=left>bare land / grass</td>
 157        </tr>
 158
 159        <tr>
 160         <td nowrap valign=top><tt>1</tt>&nbsp; </td>
 161         <td align=left>rough land (density must be 3)</td>
 162        </tr>
 163
 164        <tr>
 165         <td nowrap valign=top><tt>2</tt>&nbsp; </td>
 166         <td align=left>rocks (density must be 3)</td>
 167        </tr>
 168
 169        <tr>
 170         <td nowrap valign=top><tt>3</tt>&nbsp; </td>
 171         <td align=left>fields (density must be 3)
 172          <ul>
 173           <li>m2: index into the array of industries (farms), INVALID_INDUSTRY (0xFFFF) if farm has been removed</li>
 174           <li>m3 bits 3..0: field type (legal values: 0 through 9)</li>
 175          </ul>
 176         </td>
 177        </tr>
 178
 179        <tr>
 180         <td nowrap valign=top><tt>4</tt>&nbsp; </td>
 181         <td align=left>snow</td>
 182        </tr>
 183
 184        <tr>
 185         <td nowrap valign=top><tt>5</tt>&nbsp; </td>
 186         <td align=left>desert (density must be 1 or 3)</td>
 187        </tr>
 188       </table>
 189      </li>
 190      <li>m5 bits 1..0: density:
 191       <table>
 192        <tr>
 193         <td nowrap valign=top><tt>0</tt>&nbsp; </td>
 194         <td>bare land</td>
 195         <td></td>
 196         <td></td>
 197         <td></td>
 198         <td>1/4 snow</td>
 199         <td></td>
 200        </tr>
 201
 202        <tr>
 203         <td nowrap valign=top><tt>1</tt>&nbsp; </td>
 204         <td>1/3 grass</td>
 205         <td></td>
 206         <td></td>
 207         <td></td>
 208         <td>2/4 snow;&nbsp;</td>
 209         <td>1/2 desert</td>
 210        </tr>
 211
 212        <tr>
 213         <td nowrap valign=top><tt>2</tt>&nbsp; </td>
 214         <td>2/3 grass</td>
 215         <td></td>
 216         <td></td>
 217         <td></td>
 218         <td>3/4 snow</td>
 219         <td></td>
 220        </tr>
 221
 222        <tr>
 223         <td nowrap valign=top><tt>3</tt>&nbsp; </td>
 224         <td>full grass;&nbsp;</td>
 225         <td>rough land;&nbsp;</td>
 226         <td>rocks;&nbsp;</td>
 227         <td>fields;&nbsp;</td>
 228         <td>full snow;&nbsp;</td>
 229         <td>full desert</td>
 230        </tr>
 231       </table>
 232      </li>
 233      <li>m6 bits 4..2: type of hedge on NW border of the tile</li>
 234     </ul>
 235    </td>
 236   </tr>
 237
 238   <tr bgcolor="#CCCCCC">
 239    <td valign=top nowrap><strong><a name="Class1"><tt> 1</tt></a></strong></td>
 240    <td><strong>Railway tracks</strong></td>
 241   </tr>
 242   <tr>
 243    <td valign=top nowrap>&nbsp;</td>
 244    <td>
 245     <ul>
 246      <li style="color: blue">m1 bit 7: bit 4 of track type (more rail types patch)</li>
 247      <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> of the tile</li>
 248      <li>m2: see signals</li>
 249      <li>m3 bits 7..4: see signals</li>
 250      <li>m3 bits 3..0 = <a href="#RailType">track type</a></li>
 251      <li>m4 bits 7..4: see signals</li>
 252      <li>m4 bits 3..0: Ground type (values with fences are not valid for depots and checkpoints)
 253       <table>
 254        <tr>
 255         <td nowrap valign=top><tt>0</tt>&nbsp; </td>
 256         <td align=left>on bare land</td>
 257        </tr>
 258
 259        <tr>
 260         <td nowrap valign=top><tt>1</tt>&nbsp; </td>
 261         <td align=left>on grass, no fences</td>
 262        </tr>
 263
 264        <tr>
 265         <td nowrap valign=top><tt>2</tt>&nbsp; </td>
 266         <td align=left>fence on the NW side</td>
 267        </tr>
 268
 269        <tr>
 270         <td nowrap valign=top><tt>3</tt>&nbsp; </td>
 271         <td align=left>fence on the SE side</td>
 272        </tr>
 273
 274        <tr>
 275         <td nowrap valign=top><tt>4</tt>&nbsp; </td>
 276         <td align=left>fences on the NW and SE sides</td>
 277        </tr>
 278
 279        <tr>
 280         <td nowrap valign=top><tt>5</tt>&nbsp; </td>
 281         <td align=left>fence on the NE side</td>
 282        </tr>
 283
 284        <tr>
 285         <td nowrap valign=top><tt>6</tt>&nbsp; </td>
 286         <td align=left>fence on the SW side</td>
 287        </tr>
 288
 289        <tr>
 290         <td nowrap valign=top><tt>7</tt>&nbsp; </td>
 291         <td align=left>fences on the NE and SW sides</td>
 292        </tr>
 293
 294        <tr>
 295         <td nowrap valign=top><tt>8</tt>&nbsp; </td>
 296         <td align=left>fence on the E side (track in the W corner)</td>
 297        </tr>
 298
 299        <tr>
 300         <td nowrap valign=top><tt>9</tt>&nbsp; </td>
 301         <td align=left>fence on the W side (track in the E corner)</td>
 302        </tr>
 303
 304        <tr>
 305         <td nowrap valign=top><tt>A</tt>&nbsp; </td>
 306         <td align=left>fence on the S side (track in the N corner)</td>
 307        </tr>
 308
 309        <tr>
 310         <td nowrap valign=top><tt>B</tt>&nbsp; </td>
 311         <td align=left>fence on the N side (track in the S corner)</td>
 312        </tr>
 313
 314        <tr>
 315         <td nowrap valign=top><tt>C</tt>&nbsp; </td>
 316         <td align=left>on snow or desert</td>
 317        </tr>
 318
 319        <tr>
 320         <td nowrap valign=top><tt>D</tt>&nbsp; </td>
 321         <td align=left>on grass with fence and shore or water on the free halftile</td>
 322        </tr>
 323
 324        <tr>
 325         <td nowrap valign=top><tt>E</tt>&nbsp; </td>
 326         <td align=left>higher part on foundation with snow, lower without snow</td>
 327        </tr>
 328       </table>
 329      </li>
 330      <li>m5 bit 7 clear: railway track
 331       <ul>
 332        <li>m5 bits 5..0: track layout: bit set = track present:
 333         <table>
 334          <tr>
 335           <td nowrap valign=top>bit 0: </td>
 336           <td align=left>in the X direction</td>
 337          </tr>
 338
 339          <tr>
 340           <td nowrap valign=top>bit 1: </td>
 341           <td align=left>in the Y direction</td>
 342          </tr>
 343
 344          <tr>
 345           <td nowrap valign=top>bit 2: </td>
 346           <td align=left>in the north corner (direction W-E)</td>
 347          </tr>
 348
 349          <tr>
 350           <td nowrap valign=top>bit 3: </td>
 351           <td align=left>in the south corner (direction W-E)</td>
 352          </tr>
 353
 354          <tr>
 355           <td nowrap valign=top>bit 4: </td>
 356           <td align=left>in the west corner (direction N-S)</td>
 357          </tr>
 358
 359          <tr>
 360           <td nowrap valign=top>bit 5: </td>
 361           <td align=left>in the east corner (direction N-S)</td>
 362          </tr>
 363         </table>
 364        </li>
 365        <li>m5 bit 6 set = with signals:<BR>
 366         There are at most 4 signals on a tile. The signals 0..3 belong to the directions:
 367         <table>
 368          <tr>
 369           <td></td>
 370           <td>Track <tt>0</tt> (X)&nbsp;</td>
 371           <td>Track <tt>1</tt> (Y)&nbsp;</td>
 372           <td>Track <tt>2</tt> (north)&nbsp;</td>
 373           <td>Track <tt>3</tt> (south)&nbsp;</td>
 374           <td>Track <tt>4</tt> (west)&nbsp;</td>
 375           <td>Track <tt>5</tt> (east)</td>
 376          </tr>
 377
 378          <tr>
 379           <td align=left>Signal <tt>0</tt>&nbsp;</td>
 380           <td></td>
 381           <td></td>
 382           <td></td>
 383           <td>west</td>
 384           <td></td>
 385           <td>south</td>
 386          </tr>
 387
 388          <tr>
 389           <td align=left>Signal <tt>1</tt>&nbsp;</td>
 390           <td></td>
 391           <td></td>
 392           <td></td>
 393           <td>east</td>
 394           <td></td>
 395           <td>north</td>
 396          </tr>
 397
 398          <tr>
 399           <td align=left>Signal <tt>2</tt>&nbsp;</td>
 400           <td>south-west</td>
 401           <td>north-west</td>
 402           <td>west</td>
 403           <td></td>
 404           <td>south</td>
 405           <td></td>
 406          </tr>
 407
 408          <tr>
 409           <td align=left>Signal <tt>3</tt>&nbsp;</td>
 410           <td>north-east</td>
 411           <td>south-east</td>
 412           <td>east</td>
 413           <td></td>
 414           <td>north</td>
 415           <td></td>
 416          </tr>
 417         </table>
 418         <ul>
 419          <li>m2 bit 7: Signal 0 and 1: set = semaphore signals, clear = light signals</li>
 420          <li>m2 bit 3: Signal 2 and 3: set = semaphore signals, clear = light signals</li>
 421          <li>m2 bits 6..4: type of signal 0 and 1 (same values as m2 bits 2..0)</li>
 422          <li>m2 bits 2..0: type of signal 2 and 3
 423           <table>
 424            <tr>
 425             <td nowrap="nowrap" valign="top"><tt>000</tt>: </td>
 426             <td align="left">normal signals</td>
 427            </tr>
 428
 429            <tr>
 430             <td nowrap="nowrap" valign="top"><tt>001</tt>: </td>
 431             <td align="left">pre-signals</td>
 432            </tr>
 433
 434            <tr>
 435             <td nowrap="nowrap" valign="top"><tt>010</tt>: </td>
 436             <td align="left">exit-signals</td>
 437            </tr>
 438
 439            <tr>
 440             <td nowrap="nowrap" valign="top"><tt>011</tt>: </td>
 441             <td align="left">combo-signals</td>
 442            </tr>
 443
 444            <tr>
 445             <td nowrap="nowrap" valign="top"><tt>100</tt>: </td>
 446             <td align="left">pbs signals</td>
 447            </tr>
 448
 449            <tr>
 450             <td nowrap="nowrap" valign="top"><tt>101</tt>: </td>
 451             <td align="left">no-entry signals</td>
 452            </tr>
 453           </table>
 454          </li>
 455          <li style="color: blue">m2 bit 12: this signal tile has 1 or more restricted signals (tracerestrict patch)</li>
 456
 457          <li>m3 bits 7..4: bit set = signal 3..0 present</li>
 458          <li>m4 bits 7..4: bit clear = signal 3..0 shows red</li>
 459         </ul>
 460        </li>
 461        <li>m2 bits 8..10: track reserved for pbs
 462          <table>
 463           <tr>
 464             <td><tt>0</tt>&nbsp; </td>
 465             <td>not reserved</td>
 466           </tr>
 467           <tr>
 468             <td><tt>1</tt>&nbsp; </td>
 469             <td>X direction</td>
 470           </tr>
 471           <tr>
 472             <td><tt>2</tt>&nbsp; </td>
 473             <td>Y direction</td>
 474           </tr>
 475           <tr>
 476             <td><tt>3</tt>&nbsp; </td>
 477             <td>north corner (W-E)</td>
 478           </tr>
 479           <tr>
 480             <td><tt>4</tt>&nbsp; </td>
 481             <td>south corner (W-E)</td>
 482           </tr>
 483           <tr>
 484             <td><tt>5</tt>&nbsp; </td>
 485             <td>west corner (N-S)</td>
 486           </tr>
 487           <tr>
 488             <td><tt>6</tt>&nbsp; </td>
 489             <td>east corner (N-S)</td>
 490           </tr>
 491          </table>
 492        </li>
 493        <li>m2 bit 11: opposite track is reserved, too</li>
 494       </ul>
 495      </li>
 496      <li>m5 bit 7 set, bit 6 set: railway depot
 497       <ul>
 498        <li>m2: Depot index</li>
 499        <li>m5 bits 1..0: exit towards
 500         <table>
 501          <tr>
 502           <td><tt>0</tt>&nbsp; </td>
 503           <td>NE</td>
 504          </tr>
 505
 506          <tr>
 507           <td><tt>1</tt>&nbsp; </td>
 508           <td>SE</td>
 509          </tr>
 510
 511          <tr>
 512           <td><tt>2</tt>&nbsp; </td>
 513           <td>SW</td>
 514          </tr>
 515
 516          <tr>
 517           <td><tt>3</tt>&nbsp; </td>
 518           <td>NW</td>
 519          </tr>
 520         </table>
 521        </li>
 522        <li>m5 bit 4: pbs reservation state</li>
 523       </ul>
 524      </li>
 525      <li style="color: blue">m7: Track age used to show overgrowth (not used for depots)</li>
 526     </ul>
 527    </td>
 528   </tr>
 529
 530   <tr bgcolor="#CCCCCC">
 531    <td valign=top nowrap><strong><a name="Class2"><tt> 2</tt></a></strong></td>
 532    <td><strong>Roads</strong></td>
 533   </tr>
 534   <tr>
 535    <td valign=top nowrap>&nbsp;</td>
 536    <td>
 537     <ul>
 538      <li>m2: Index into the array of towns (owning town for town roads; closest town otherwise, INVALID_TOWN if there is no town or we are creating a town)</li>
 539      <li>m3 bits 7..4: <a href="#OwnershipInfo">owner</a> of road type 1 (tram); OWNER_NONE (<tt>10</tt>) is stored as OWNER_TOWN (<tt>0F</tt>)
 540      <li>m4: <a href="#RoadType">Road-(sub-)types</a></li>
 541      <li>m7 bit 5 set = on snow or desert</li>
 542      <li>m5 bits 7 clear: road or level-crossing
 543       <ul>
 544        <li>m6 bits 5..3:
 545         <table>
 546          <tr>
 547           <td><tt>0</tt>&nbsp; </td>
 548           <td>on bare land</td>
 549          </tr>
 550          <tr>
 551           <td><tt>1</tt>&nbsp; </td>
 552           <td>on grass</td>
 553          </tr>
 554          <tr>
 555           <td><tt>2</tt>&nbsp; </td>
 556           <td>paved</td>
 557          </tr>
 558          <tr>
 559           <td><tt>3</tt>&nbsp; </td>
 560           <td>with streetlights</td>
 561          </tr>
 562          <tr>
 563           <td><tt>5</tt>&nbsp; </td>
 564           <td>tree-lined</td>
 565          </tr>
 566          <tr>
 567           <td><tt>6</tt>&nbsp; </td>
 568           <td>on grass with road works</td>
 569          </tr>
 570          <tr>
 571           <td><tt>7</tt>&nbsp; </td>
 572           <td>paved with road works</td>
 573          </tr>
 574         </table>
 575        </li>
 576        <li>m5 bit 6 clear: road
 577         <ul>
 578                  <li style="color: blue">m1 bit 7: bit 4 of track type (more rail types patch)</li>
 579          <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> of the road type 0 (normal road)</li>
 580          <li>m7 bits 3..0: counter for the roadworks</li>
 581          <li>m5 bits 3..0: road layout road type 0 (normal road): bit set = road piece present:
 582           <table>
 583            <tr>
 584             <td align=left>bit 0: </td>
 585             <td>NW piece</td>
 586            </tr>
 587            <tr>
 588             <td align=left>bit 1: </td>
 589             <td>SW piece</td>
 590            </tr>
 591            <tr>
 592             <td align=left>bit 2: </td>
 593             <td>SE piece</td>
 594            </tr>
 595            <tr>
 596             <td align=left>bit 3: </td>
 597             <td>NE piece</td>
 598            </tr>
 599           </table>
 600          </li>
 601          <li>m3 bits 0..3: road layout road type 1 (tram)</li>
 602          <li>m5 bits 5..4: bits to disallow vehicles to go a specific direction
 603           <table>
 604            <tr>
 605             <td align=left>bit 0: </td>
 606             <td>set = disallow driving in south-west or south-east direction</td>
 607            </tr>
 608            <tr>
 609             <td align=left>bit 1: </td>
 610             <td>set = disallow driving in north-west or north-east direction</td>
 611            </tr>
 612           </table>
 613          </li>
 614         </ul>
 615        </li>
 616        <li>m5 bit 6 set: level crossing
 617         <ul>
 618          <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> of the railway track</li>
 619          <li>m3 bits 3..0: <a href="#RailType">railway track type</a></li>
 620          <li>m5 bit 0: direction
 621           <table>
 622            <tr>
 623             <td align=left><tt>0</tt>&nbsp; </td>
 624             <td align=left>road in the X direction, rail in Y</td>
 625            </tr>
 626            <tr>
 627             <td align=left><tt>1</tt>&nbsp; </td>
 628             <td align=left>road in the Y direction, rail in X</td>
 629            </tr>
 630           </table>
 631          </li>
 632          <li>m5 bit 5: set if crossing lights are on</li>
 633          <li>m7 bits 4..0: <a href="#OwnershipInfo">owner</a> of the road type 0 (normal road)</li>
 634          <li>m5 bit 4: pbs reservation state</li>
 635         </ul>
 636        </li>
 637       </ul>
 638      </li>
 639      <li>m5 bit 7 set, bit 6 clear: road depot
 640       <ul>
 641        <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> of the depot</li>
 642        <li>m2: Depot index</li>
 643        <li>m5 bits 1..0: exit towards:
 644         <table>
 645          <tr>
 646           <td><tt>0</tt>&nbsp; </td>
 647           <td>NE</td>
 648          </tr>
 649
 650          <tr>
 651           <td><tt>1</tt>&nbsp; </td>
 652           <td>SE</td>
 653          </tr>
 654
 655          <tr>
 656           <td><tt>2</tt>&nbsp; </td>
 657           <td>SW</td>
 658          </tr>
 659
 660          <tr>
 661           <td><tt>3</tt>&nbsp; </td>
 662           <td>NW</td>
 663          </tr>
 664         </table>
 665        </li>
 666        <li>m7 bits 4..0: <a href="#OwnershipInfo">owner</a> of the road type 0 (normal road)</li>
 667       </ul>
 668      </li>
 669          <li style="color: blue">m7 bit 6: bit 4 of <a href="#RoadType">Road-(sub-)types</a></li>
 670          <li style="color: blue">m7 bit 7: bit 4 of <a href="#RoadType">Tram-(sub-)types</a></li>
 671     </ul>
 672    </td>
 673   </tr>
 674
 675   <tr bgcolor="#CCCCCC">
 676    <td valign=top nowrap><strong><a name="Class3"><tt> 3</tt></a></strong></td>
 677    <td><strong>Town building </strong></td>
 678   </tr>
 679   <tr>
 680    <td valign=top nowrap>&nbsp;</td>
 681    <td>
 682     <ul>
 683      <li>m1 : Random bits <a href="#newhouses">(newhouses)</a> </li>
 684      <li>m2 : index into the array of towns</li>
 685      <li>m3 bit 7 :
 686       <ul>
 687        <li> set : House is complete
 688         <ul>
 689          <li>m5 : Age of house in years, clamped at 255</li>
 690         </ul>
 691        </li>
 692        <li> clear : House is in construction
 693         <ul>
 694          <li>m5 bits 7..5 : free</li>
 695          <li>m5 bits 4..3 : construction stage</li>
 696          <li>m5 bits 2..0 : construction counter</li>
 697         </ul>
 698        </li>
 699       </ul>
 700      <li>m3 bit 6 : bit 8 of house type (m4), allowing 512 different types.</li>
 701      <li>m3 bit 5 : free</li>
 702      <li>m3 bits 4..0 : triggers activated <a href="#newhouses">(newhouses)</a></li>
 703      <li>m4 : <a href="landscape_externals.html">town building type</a> (with m3[6] bit)</li>
 704      <li>m5 : see m3 bit 7</li>
 705      <li>m6 :
 706       <ul>
 707        <li>If <a href="#newhouses">newhouses</a> is activated
 708         <ul>
 709          <li>bits 7..2 : Periodic processing time remaining</li>
 710         </ul>
 711        </li>
 712        <li>Standard behaviour
 713         <ul>
 714          <li>bits 7..2 : lift position (for houses type 04 and 05)</li>
 715         </ul>
 716        </li>
 717       </ul>
 718      </li>
 719      <li>m7 :
 720       <ul>
 721        <li>If <a href="#newhouses">newhouses</a> is activated
 722         <ul>
 723          <li>Current animation frame</li>
 724         </ul>
 725        </li>
 726        <li>Standard behaviour (only for houses type 04 and 05)
 727         <ul>
 728          <li>bits 7..4 : free</li>
 729          <li>bits 3..1 : lift destination.  Values can be 0..6, except 1.<br>
 730              So the building has 6 effective floors. This is due to the fact that the first floor is 2 'normal' floors high.<br>
 731              One 'normal' floor has a height of 6 lift positions.
 732          </li>
 733          <li>bit 0 : Lift has destination when set</li>
 734         </ul>
 735        </li>
 736       </ul>
 737      </li>
 738     </ul>
 739     <small><a name="newhouses"></a>Newhouses is the name englobing a newGRF feature developped by TTDPatch devs (mainly Csaboka).<br>
 740     It allows the replacement of the properties as well as the graphics of houses in the game.<br>
 741     To distinguish between the standard behaviour and the newGRF one, HouseID (m4 + m3[6]) is tested for anything above 110.<br>
 742     110 is the count of standard houses. So above 110 means there is a new definition of at least one house</small>
 743    </td>
 744   </tr>
 745
 746   <tr bgcolor="#CCCCCC">
 747    <td valign=top nowrap><strong><a name="Class4"><tt> 4 </tt></a></strong></td>
 748    <td><strong>Trees </strong></td>
 749   </tr>
 750   <tr>
 751    <td valign=top nowrap>&nbsp;</td>
 752    <td>
 753     <ul>
 754      <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> (normally <tt>10</tt>)</li>
 755      <li>m2 bits 8..6: ground
 756       <table>
 757
 758        <tr>
 759         <td align=left><tt>0</tt>&nbsp; </td>
 760         <td>on grass</td>
 761        </tr>
 762
 763        <tr>
 764         <td align=left><tt>1</tt>&nbsp; </td>
 765         <td>on rough land (density must be 3)</td>
 766        </tr>
 767
 768        <tr>
 769         <td align=left><tt>2</tt>&nbsp; </td>
 770         <td>on snow or desert</td>
 771        </tr>
 772
 773        <tr>
 774         <td align=left><tt>3</tt>&nbsp; </td>
 775         <td>on shore (density must be 3)</td>
 776        </tr>
 777
 778        <tr>
 779         <td align=left><tt>4</tt>&nbsp; </td>
 780         <td>on snow with rough land underneed</td>
 781        </tr>
 782       </table>
 783      </li>
 784      <li>m2 bits 5..4: ground density</li>
 785      <li>m2 bits 3..0: update counter, incremented on every periodic processing.<br>
 786           on wraparound the growth status is updated (or, if it's <tt>3</tt>, a random action is taken)</li>
 787      <li>m3 bits 7..0: type of trees:
 788       <table>
 789        <tr>
 790         <td nowrap valign=top><tt>00</tt>..<tt>0B</tt>&nbsp; </td>
 791         <td align=left>temperate climate trees</td>
 792        </tr>
 793
 794        <tr>
 795         <td nowrap valign=top><tt>0C</tt>..<tt>13</tt>&nbsp; </td>
 796         <td align=left>sub-arctic climate trees</td>
 797        </tr>
 798
 799        <tr>
 800         <td nowrap valign=top><tt>14</tt>..<tt>1A</tt>&nbsp; </td>
 801         <td align=left>rainforest trees</td>
 802        </tr>
 803
 804        <tr>
 805         <td nowrap valign=top><tt>1B</tt> </td>
 806         <td align=left>cactus plants</td>
 807        </tr>
 808
 809        <tr>
 810         <td nowrap valign=top><tt>1C</tt>..<tt>1F</tt>&nbsp; </td>
 811         <td align=left>sub-tropical climate, non-rainforest, non-desert trees</td>
 812        </tr>
 813
 814        <tr>
 815         <td nowrap valign=top><tt>20</tt>..<tt>28</tt>&nbsp; </td>
 816         <td align=left>toyland trees</td>
 817        </tr>
 818       </table>
 819       <small>Note: the actually displayed set of trees depends on both type and number of trees</small>
 820      </li>
 821      <li>m5 bits 7..6: number of trees minus one</li>
 822      <li>m5 bits 2..0: growth status:
 823       <table border="0">
 824        <tr>
 825         <td><tt>0</tt>..<tt>2</tt>&nbsp;</td>
 826         <td>one of trees is growing&nbsp;</td>
 827        </tr>
 828        <tr>
 829         <td><tt>3</tt>&nbsp;</td>
 830         <td>all trees are fully grown&nbsp;</td>
 831        </tr>
 832        <tr>
 833         <td><tt>4</tt>..<tt>6</tt>&nbsp;</td>
 834         <td>one of trees is withering&nbsp;</td>
 835        </tr>
 836       </table>
 837      </li>
 838     </ul>
 839    </td>
 840   </tr>
 841
 842   <tr bgcolor="#CCCCCC">
 843    <td valign=top nowrap><strong><a name="Class5"><tt> 5</tt></a></strong></td>
 844    <td><strong>Station tiles</strong></td>
 845   </tr>
 846   <tr>
 847    <td valign=top nowrap>&nbsp;</td>
 848    <td>
 849     <ul>
 850      <li style="color: blue">m1 bit 7: bit 4 of track type (more rail types patch)</li>
 851      <li>m1 bits 6..5: water class for buoys, water part of docks and for airport tiles</li>
 852      <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> of the station</li>
 853      <li>m2: index into the array of stations</li>
 854      <li>m3 bits 7..4: persistent random data for railway stations/waypoints and airports)</li>
 855      <li>m3 bits 7..4: <a href="#OwnershipInfo">owner</a> of tram tracks (road stop)</li>
 856      <li>m3 bits 3..0: <a href="#RailType">track type</a> for railway stations/waypoints</li>
 857      <li>m4: custom station id; 0 means standard graphics</li>
 858      <li>m4: <a href="#RoadType">Road-(sub-)types</a> for road stops</li>
 859      <li>m5: graphics index (range from 0..255 for each station type):
 860       <table>
 861        <tr>
 862         <td nowrap valign=top><tt>00</tt>..<tt>07</tt>&nbsp; </td>
 863         <td align=left>railway station
 864          <table>
 865           <tr>
 866            <td><tt>00</tt>..<tt>01</tt>&nbsp; </td>
 867            <td align=left>open platform</td>
 868           </tr>
 869           <tr>
 870            <td><tt>02</tt>..<tt>03</tt>&nbsp; </td>
 871            <td align=left>open platform with station building</td>
 872           </tr>
 873           <tr>
 874            <td><tt>04</tt>....<tt>07</tt>&nbsp; </td>
 875            <td align=left>roofed platform</td>
 876           </tr>
 877           <tr>
 878            <td colspan=2>bit 0: clear = in X direction, set = in Y direction</td>
 879           </tr>
 880          </table>
 881         </td>
 882        </tr>
 883
 884        <tr>
 885         <td nowrap valign=top><tt>00</tt>..<tt>01</tt></td>
 886         <td align=left>waypoints
 887          <table>
 888           <tr>
 889            <td><tt>00</tt>&nbsp; </td>
 890            <td align=left>in X direction</td>
 891           </tr>
 892           <tr>
 893            <td><tt>01</tt>&nbsp; </td>
 894            <td align=left>in Y direction</td>
 895           </tr>
 896          </table>
 897         </td>
 898        </tr>
 899
 900        <tr>
 901         <td nowrap valign=top><tt>00</tt>..<tt>FF</tt></td>
 902         <td align=left>all airports</td>
 903        </tr>
 904
 905        <tr>
 906         <td nowrap valign=top><tt>00</tt>..<tt>05</tt>&nbsp; </td>
 907         <td align=left>road stops
 908          <table>
 909           <tr>
 910            <td><tt>00</tt>&nbsp; </td>
 911            <td align=left>exit towards NE</td>
 912           </tr>
 913           <tr>
 914            <td><tt>01</tt>&nbsp; </td>
 915            <td align=left>exit towards SE</td>
 916           </tr>
 917           <tr>
 918            <td><tt>02</tt>&nbsp; </td>
 919            <td align=left>exit towards SW</td>
 920           </tr>
 921           <tr>
 922            <td><tt>03</tt>&nbsp; </td>
 923            <td align=left>exit towards NW</td>
 924           </tr>
 925           <tr>
 926            <td><tt>04</tt>&nbsp; </td>
 927            <td align=left>drive through X</td>
 928           </tr>
 929           <tr>
 930            <td><tt>05</tt>&nbsp; </td>
 931            <td align=left>drive through Y</td>
 932           </tr>
 933          </table>
 934         </td>
 935        </tr>
 936
 937        <tr>
 938         <td nowrap valign=top><tt>00</tt>..<tt>05</tt>&nbsp; </td>
 939         <td align=left>ship dock
 940          <table>
 941           <tr>
 942            <td><tt>00</tt>&nbsp; </td>
 943            <td align=left>SW coast part</td>
 944           </tr>
 945           <tr>
 946            <td><tt>01</tt>&nbsp; </td>
 947            <td align=left>NW coast part</td>
 948           </tr>
 949           <tr>
 950            <td><tt>02</tt>&nbsp; </td>
 951            <td align=left>NE coast part</td>
 952           </tr>
 953           <tr>
 954            <td><tt>03</tt>&nbsp; </td>
 955            <td align=left>SE coast part</td>
 956           </tr>
 957           <tr>
 958            <td><tt>04</tt>&nbsp; </td>
 959            <td align=left>X direction water part</td>
 960           </tr>
 961           <tr>
 962            <td><tt>05</tt>&nbsp; </td>
 963            <td align=left>Y direction water part</td>
 964           </tr>
 965          </table>
 966         </td>
 967        </tr>
 968       </table>
 969      </li>
 970      <li>m6 bits 5..3: the station type (rail, airport, truck, bus, oilrig, dock, buoy, waypoint)</li>
 971      <li>m6 bit 2: pbs reservation state for railway stations/waypoints</li>
 972
 973      <li>m7 bits 4..0: <a href="#OwnershipInfo">owner</a> of road (road stops)</li>
 974      <li style="color: blue">m7 bit 6: bit 4 of <a href="#RoadType">Road-(sub-)types</a> (road stops)</li>
 975      <li style="color: blue">m7 bit 7: bit 4 of <a href="#RoadType">Tram-(sub-)types</a> (road stops)</li>
 976      <li>m7: animation frame (railway stations/waypoints, airports)</li>
 977     </ul>
 978    </td>
 979   </tr>
 980
 981   <tr bgcolor="#CCCCCC">
 982    <td valign=top nowrap><strong><a name="Class6"><tt> 6 </tt></a></strong></td>
 983    <td><strong>Water</strong></td>
 984   </tr>
 985   <tr>
 986    <td valign=top nowrap>&nbsp;</td>
 987    <td>
 988     <ul>
 989      <li>m1 bits 6..5 : Water class (sea, canal or river)
 990      <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> (for sea, rivers, and coasts normally <tt>11</tt>)</li>
 991      <li>m2: Depot index (for depots only)</li>
 992      <li>m4: Random data for canal or river tiles</li>
 993      <li>m5: tile type:
 994       <table>
 995        <tr>
 996         <td nowrap valign=top><tt>00</tt>&nbsp; </td>
 997         <td align=left>water, canal or river</td>
 998        </tr>
 999
1000        <tr>
1001         <td nowrap valign=top><tt>01</tt>&nbsp; </td>
1002         <td align=left>coast or riverbank</td>
1003        </tr>
1004
1005        <tr>
1006         <td nowrap valign=top><tt>10</tt>..<tt>1B</tt>&nbsp; </td>
1007         <td align=left>canal locks
1008          <table>
1009           <tr>
1010            <td nowrap valign=top><tt>10</tt>&nbsp; </td>
1011            <td align=left>middle part, (SW-NE direction)</td>
1012           </tr>
1013           <tr>
1014            <td nowrap valign=top><tt>11</tt>&nbsp; </td>
1015            <td align=left>middle part, (NW-SE direction)</td>
1016           </tr>
1017           <tr>
1018            <td nowrap valign=top><tt>12</tt>&nbsp; </td>
1019            <td align=left>middle part, (NE-SW direction)</td>
1020           </tr>
1021           <tr>
1022            <td nowrap valign=top><tt>13</tt>&nbsp; </td>
1023            <td align=left>middle part, (SE-NW direction)</td>
1024           </tr>
1025           <tr>
1026            <td nowrap valign=top><tt>14</tt>&nbsp; </td>
1027            <td align=left>lower part, (SW-NE direction)</td>
1028           </tr>
1029           <tr>
1030            <td nowrap valign=top><tt>15</tt>&nbsp; </td>
1031            <td align=left>lower part, (NW-SE direction)</td>
1032           </tr>
1033           <tr>
1034            <td nowrap valign=top><tt>16</tt>&nbsp; </td>
1035            <td align=left>lower part, (NE-SW direction)</td>
1036           </tr>
1037           <tr>
1038            <td nowrap valign=top><tt>17</tt>&nbsp; </td>
1039            <td align=left>lower part, (SE-NW direction)</td>
1040           </tr>
1041           <tr>
1042            <td nowrap valign=top><tt>18</tt>&nbsp; </td>
1043            <td align=left>upper part, (SW-NE direction)</td>
1044           </tr>
1045           <tr>
1046            <td nowrap valign=top><tt>19</tt>&nbsp; </td>
1047            <td align=left>upper part, (NW-SE direction)</td>
1048           </tr>
1049           <tr>
1050            <td nowrap valign=top><tt>1A</tt>&nbsp; </td>
1051            <td align=left>upper part, (NE-SW direction)</td>
1052           </tr>
1053           <tr>
1054            <td nowrap valign=top><tt>1B</tt>&nbsp; </td>
1055            <td align=left>upper part, (SE-NW direction)</td>
1056           </tr>
1057          </table>
1058         </td>
1059        </tr>
1060
1061        <tr>
1062         <td nowrap valign=top><tt>80</tt>..<tt>83</tt>&nbsp; </td>
1063         <td align=left>ship depots
1064          <table>
1065           <tr>
1066            <td nowrap valign=top><tt>80</tt>&nbsp; </td>
1067            <td align=left>ship depot, NE part (X direction)</td>
1068           </tr>
1069           <tr>
1070            <td nowrap valign=top><tt>81</tt>&nbsp; </td>
1071            <td align=left>ship depot, SW part (X direction)</td>
1072           </tr>
1073           <tr>
1074            <td nowrap valign=top><tt>82</tt>&nbsp; </td>
1075            <td align=left>ship depot, NW part (Y direction)</td>
1076           </tr>
1077           <tr>
1078            <td nowrap valign=top><tt>83</tt>&nbsp; </td>
1079            <td align=left>ship depot, SE part (Y direction)</td>
1080           </tr>
1081          </table>
1082         </td>
1083        </tr>
1084       </table>
1085      </li>
1086     </ul>
1087    </td>
1088   </tr>
1089
1090   <tr bgcolor="#CCCCCC">
1091    <td valign=top nowrap><strong><a name="Class7"><tt> 7 </tt></a></strong></td>
1092    <td><strong>Void </strong></td>
1093   </tr>
1094   <tr>
1095    <td valign=top nowrap>&nbsp;</td>
1096    <td>Tiles of this class form an invisible, one tile wide border at the south (bottom) edges of the map,<br>
1097        so as to protect several algorithms from the consequences of a wraparound at the edges.
1098    </td>
1099   </tr>
1100
1101   <tr bgcolor="#CCCCCC">
1102    <td valign=top nowrap><strong><a name="Class8"><tt> 8</tt></a></strong></td>
1103    <td><strong>Industries </strong></td>
1104   </tr>
1105   <tr>
1106    <td valign=top nowrap>&nbsp;</td>
1107    <td>
1108     <ul>
1109      <li>m1 bit 7: clear = under construction
1110       <ul>
1111        <li>m1 bits 6..5 : Water class (sea, canal, river or land)
1112        <li>m1 bits 3..2: construction counter, for buildings under construction incremented on every periodic tile processing</li>
1113        <li>m1 bits 1..0: stage of construction (<tt>3</tt> = completed), incremented when the construction counter wraps around<br>
1114            the meaning is different for some animated tiles which are never under construction (types <tt>01</tt>, <tt>1E</tt>..<tt>20</tt>, <tt>30</tt>, <tt>58</tt>; see above)</li>
1115       </ul>
1116      </li>
1117      <li>m2: index into the array of industries</li>
1118      <li>m3: random bits (NewGRF)</li>
1119      <li>m4: animation loop</li>
1120      <li>m5: type (plus m6 bit 2):<br>
1121       <small>(note: this is not the same as the industry type, which is stored in the array of industries)</small>
1122
1123       <table>
1124        <tr>
1125         <td nowrap valign=top><tt>00</tt>..<tt>06</tt>&nbsp; </td>
1126         <td align=left>coal mine
1127          <table>
1128           <tr>
1129            <td nowrap valign=top><tt>00</tt>&nbsp; </td>
1130            <td align=left>wheel tower when not animated</td>
1131           </tr>
1132           <tr>
1133            <td nowrap valign=top><tt>01</tt>&nbsp; </td>
1134            <td align=left>wheel tower when animated<br>
1135             animation state in m7 bits 5..0; m7 bit 6 set = sound already generated</td>
1136           </tr>
1137          </table>
1138         </td>
1139        </tr>
1140
1141        <tr>
1142         <td nowrap valign=top><tt>07</tt>..<tt>0A</tt>&nbsp; </td>
1143         <td align=left>power station
1144          <table>
1145           <tr>
1146            <td nowrap valign=top><tt>08</tt>&nbsp; </td>
1147            <td align=left>chimney</td>
1148           </tr>
1149           <tr>
1150            <td nowrap valign=top><tt>0A</tt>&nbsp; </td>
1151            <td align=left>transformer; animation progress in m7(valid range <tt>0</tt>..<tt>7</tt>)</td>
1152           </tr>
1153          </table>
1154         </td>
1155        </tr>
1156
1157        <tr>
1158         <td nowrap valign=top><tt>0B</tt>..<tt>0F</tt>&nbsp; </td>
1159         <td align=left>sawmill</td>
1160        </tr>
1161
1162        <tr>
1163         <td nowrap valign=top><tt>10</tt>..<tt>11</tt>&nbsp; </td>
1164         <td align=left>forest
1165          <table>
1166           <tr>
1167            <td nowrap valign=top><tt>11</tt>&nbsp; </td>
1168            <td align=left>trees cut down</td>
1169           </tr>
1170          </table>
1171         </td>
1172        </tr>
1173
1174        <tr>
1175         <td nowrap valign=top><tt>12</tt>..<tt>17</tt>&nbsp; </td>
1176         <td align=left>oil refinery</td>
1177        </tr>
1178
1179        <tr>
1180         <td nowrap valign=top><tt>18</tt>..<tt>1C</tt>&nbsp; </td>
1181         <td align=left>oil rig</td>
1182        </tr>
1183
1184        <tr>
1185         <td nowrap valign=top><tt>1D</tt>..<tt>20</tt>&nbsp; </td>
1186         <td align=left>oil wells
1187          <table>
1188           <tr>
1189            <td nowrap valign=top><tt>1D</tt>&nbsp; </td>
1190            <td align=left>not animated</td>
1191           </tr>
1192           <tr>
1193            <td nowrap valign=top><tt>1E</tt>..<tt>20</tt>&nbsp; </td>
1194            <td align=left>various stages of animation; progress of animation in m7</td>
1195           </tr>
1196          </table>
1197         </td>
1198        </tr>
1199
1200        <tr>
1201         <td nowrap valign=top><tt>21</tt>..<tt>26</tt>&nbsp; </td>
1202         <td align=left>farm</td>
1203        </tr>
1204
1205        <tr>
1206         <td nowrap valign=top><tt>27</tt>..<tt>2A</tt>&nbsp; </td>
1207         <td align=left>factory (temperate climate)</td>
1208        </tr>
1209
1210        <tr>
1211         <td nowrap valign=top><tt>2B</tt>..<tt>2E</tt>&nbsp; </td>
1212         <td align=left>printing works</td>
1213        </tr>
1214
1215        <tr>
1216         <td nowrap valign=top><tt>2F</tt>..<tt>33</tt>&nbsp; </td>
1217         <td align=left>copper ore mine
1218          <table>
1219           <tr>
1220            <td nowrap valign=top><tt>2F</tt>&nbsp; </td>
1221            <td align=left>wheel tower when not animated</td>
1222           </tr>
1223           <tr>
1224            <td nowrap valign=top><tt>30</tt>&nbsp; </td>
1225            <td align=left>wheel tower when animated; animation state in m7 bits 5..0; m7 bit 6 set = sound already generated</td>
1226           </tr>
1227           <tr>
1228            <td nowrap valign=top><tt>31</tt>&nbsp; </td>
1229            <td align=left>chimney</td>
1230           </tr>
1231          </table>
1232         </td>
1233        </tr>
1234
1235        <tr>
1236         <td nowrap valign=top><tt>34</tt>..<tt>39</tt>&nbsp; </td>
1237         <td align=left>steel mill</td>
1238        </tr>
1239
1240        <tr>
1241         <td nowrap valign=top><tt>3A</tt>..<tt>3B</tt>&nbsp; </td>
1242         <td align=left>bank (temperate climate)</td>
1243        </tr>
1244
1245        <tr>
1246         <td nowrap valign=top><tt>3C</tt>..<tt>3F</tt>&nbsp; </td>
1247         <td align=left>food processing plant</td>
1248        </tr>
1249
1250        <tr>
1251         <td nowrap valign=top><tt>40</tt>..<tt>47</tt>&nbsp; </td>
1252         <td align=left>paper mill</td>
1253        </tr>
1254
1255        <tr>
1256         <td nowrap valign=top><tt>48</tt>..<tt>58</tt>&nbsp; </td>
1257         <td align=left>gold mine
1258          <table>
1259           <tr>
1260            <td nowrap valign=top><tt>4F</tt>&nbsp; </td>
1261            <td align=left>wheel tower when not animated</td>
1262           </tr>
1263           <tr>
1264            <td nowrap valign=top><tt>58</tt>&nbsp; </td>
1265            <td align=left>wheel tower when animated; animation state in m7 bits 5..0; m7 bit 6 set = sound already generated</td>
1266           </tr>
1267          </table></td>
1268        </tr>
1269
1270        <tr>
1271         <td nowrap valign=top><tt>59</tt>..<tt>5A</tt>&nbsp; </td>
1272         <td align=left>bank (sub-arctic or sub-tropical climate)</td>
1273        </tr>
1274
1275        <tr>
1276         <td nowrap valign=top><tt>5B</tt>..<tt>63</tt>&nbsp; </td>
1277         <td align=left>diamond mine</td>
1278        </tr>
1279
1280        <tr>
1281         <td nowrap valign=top><tt>64</tt>..<tt>73</tt>&nbsp; </td>
1282         <td align=left>iron ore mine</td>
1283        </tr>
1284
1285        <tr>
1286         <td nowrap valign=top><tt>74</tt></td>
1287         <td align=left>fruit plantation</td>
1288        </tr>
1289
1290        <tr>
1291         <td nowrap valign=top><tt>75</tt></td>
1292         <td align=left>rubber plantation</td>
1293        </tr>
1294
1295        <tr>
1296         <td nowrap valign=top><tt>76</tt>..<tt>77</tt>&nbsp; </td>
1297         <td align=left>water supply</td>
1298        </tr>
1299
1300        <tr>
1301         <td nowrap valign=top><tt>78</tt></td>
1302         <td align=left>water tower</td>
1303        </tr>
1304
1305        <tr>
1306         <td nowrap valign=top><tt>79</tt>..<tt>7C</tt>&nbsp; </td>
1307         <td align=left>factory (sub-tropical climate)</td>
1308        </tr>
1309
1310        <tr>
1311         <td nowrap valign=top><tt>7D</tt>..<tt>80</tt>&nbsp; </td>
1312         <td align=left>lumber mill</td>
1313        </tr>
1314
1315        <tr>
1316         <td nowrap valign=top><tt>81</tt>..<tt>82</tt>&nbsp; </td>
1317         <td align=left>candyfloss forest
1318          <table>
1319           <tr>
1320            <td nowrap valign=top><tt>82</tt>&nbsp; </td>
1321            <td align=left>candyfloss 'trees' cut down</td>
1322           </tr>
1323          </table>
1324         </td>
1325        </tr>
1326
1327        <tr>
1328         <td nowrap valign=top><tt>83</tt>..<tt>86</tt>&nbsp; </td>
1329         <td align=left>sweet factory</td>
1330        </tr>
1331
1332        <tr>
1333         <td nowrap valign=top><tt>87</tt>..<tt>88</tt>&nbsp; </td>
1334         <td align=left>battery farm
1335          <table>
1336           <tr>
1337            <td nowrap valign=top><tt>88</tt>&nbsp; </td>
1338            <td align=left>batteries 'reaped'</td>
1339           </tr>
1340          </table>
1341         </td>
1342        </tr>
1343
1344        <tr>
1345         <td nowrap valign=top><tt>89</tt></td>
1346         <td align=left>cola wells</td>
1347        </tr>
1348
1349        <tr>
1350         <td nowrap valign=top><tt>8A</tt>..<tt>8D</tt>&nbsp; </td>
1351         <td align=left>toy shop</td>
1352        </tr>
1353
1354        <tr>
1355         <td nowrap valign=top><tt>8E</tt>..<tt>93</tt>&nbsp; </td>
1356         <td align=left>toy factory
1357          <table>
1358           <tr>
1359            <td nowrap valign=top><tt>8F</tt>&nbsp; </td>
1360            <td align=left>Animated part; animation state in m7 (valid range <tt>00</tt>..<tt>31</tt>)<br>
1361                         Tile animation is started (m4 zeroed) on the periodic processing.<br>
1362                         While the animation is in progress, m4 holds the number
1363                         of animation cycles that have already taken place.<br>
1364                         when this number reaches 8 the animation is stopped.</td>
1365           </tr>
1366          </table>
1367         </td>
1368        </tr>
1369
1370        <tr>
1371         <td nowrap valign=top><tt>94</tt>..<tt>9B</tt>&nbsp; </td>
1372         <td align=left>plastic fountains (various stages of cyclic animation)</td>
1373        </tr>
1374
1375        <tr>
1376         <td nowrap valign=top><tt>9C</tt>..<tt>9F</tt>&nbsp; </td>
1377         <td align=left>fizzy drink factory</td>
1378        </tr>
1379
1380        <tr>
1381         <td nowrap valign=top><tt>A0</tt>..<tt>A3</tt>&nbsp; </td>
1382         <td align=left>bubble generator
1383          <table>
1384           <tr>
1385            <td nowrap valign=top><tt>A1</tt>&nbsp; </td>
1386            <td align=left>generators</td>
1387           </tr>
1388           <tr>
1389            <td nowrap valign=top><tt>A2</tt>&nbsp; </td>
1390            <td align=left>bubble capture facility; animation state in m7 (valid range <tt>00</tt>..<tt>27</tt>)</td>
1391           </tr>
1392          </table>
1393         </td>
1394        </tr>
1395
1396        <tr>
1397         <td nowrap valign=top><tt>A4</tt>..<tt>A6</tt>&nbsp; </td>
1398         <td align=left>toffee quarry
1399          <table>
1400           <tr>
1401            <td nowrap valign=top><tt>A5</tt>&nbsp; </td>
1402            <td align=left>animated part; animation state in m3 (valid range <tt>00</tt>..<tt>45</tt>)</td>
1403           </tr>
1404          </table>
1405         </td>
1406        </tr>
1407
1408        <tr>
1409         <td nowrap valign=top><tt>A7</tt>..<tt>AE</tt>&nbsp; </td>
1410         <td align=left>sugar mine
1411          <table>
1412           <tr>
1413            <td nowrap valign=top><tt>AE</tt>&nbsp; </td>
1414            <td align=left>animated part; animation state in m3 (valid range <tt>00</tt>..<tt>5F</tt>)</td>
1415           </tr>
1416          </table>
1417         </td>
1418        </tr>
1419        <tr>
1420         <td nowrap valign=top><tt>AF</tt>..<tt>1FF</tt>&nbsp; </td>
1421         <td align=left>NewGRF industries industry</td>
1422        </tr>
1423       </table>
1424      </li>
1425      <li>m6 bits 5..3: random triggers (NewGRF)</li>
1426      <li>m6 bit 2: bit 8 of type (see m5)</li>
1427      <li>m7: animation frame</li>
1428     </ul>
1429    </td>
1430   </tr>
1431
1432   <tr bgcolor="#CCCCCC">
1433    <td valign=top nowrap><strong><a name="Class9"><tt> 9</tt></a></strong></td>
1434    <td><strong>Tunnel / bridge</strong></td>
1435   </tr>
1436   <tr>
1437    <td valign=top nowrap>&nbsp;</td>
1438    <td>
1439     <ul>
1440      <li style="color: blue">m1 bit 7: bit 4 of track type (more rail types patch)</li>
1441      <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a></li>
1442      <li style="color: blue">m2 bits 15..0: tunnel ID lookup (tunnel entrances only)<br>
1443      <li style="color: blue">m2 bits 7..0: custom road bridge heads (flat bridge heads only)<br>
1444       Road/tram bits below are XORed with the axial bridge direction road bits.<br>
1445       A non-custom bridge head configuration will have a value of 0.
1446       <ul>
1447        <li>m2 bits 7..4: Road bits<br>
1448            Valid only if m7 bit 6 is set
1449        </li>
1450        <li>m2 bits 3..0: Tram bits<br>
1451            Valid only if m7 bit 7 is set
1452        </li>
1453       </ul>
1454       <table style="color: blue">
1455        <tr>
1456         <td align=left>bit 0: </td>
1457         <td>NW piece</td>
1458        </tr>
1459        <tr>
1460         <td align=left>bit 1: </td>
1461         <td>SW piece</td>
1462        </tr>
1463        <tr>
1464         <td align=left>bit 2: </td>
1465         <td>SE piece</td>
1466        </tr>
1467        <tr>
1468         <td align=left>bit 3: </td>
1469         <td>NE piece</td>
1470        </tr>
1471       </table>
1472      </li>
1473      <li>m3 bits 7..4: <a href="#OwnershipInfo">owner</a> of tram</li>
1474      <li>m3 bits 3..0: <a href="#RailType">track type</a> for railway</li>
1475      <li>m4: <a href="#RoadType">Road-(sub-)types</a></li>
1476      <li>m5 bit 4: pbs reservation state for railway</li>
1477      <li>m5 bit 7 clear: tunnel entrance/exit</li>
1478      <li>m5 bit 7 set: bridge ramp
1479       <ul>
1480        <li>m6 bits 5..2: <a name="BridgeType">bridge type</a>:
1481         <table>
1482          <tr>
1483           <th align=left>Type&nbsp;</th>
1484           <th align=left>Max. speed (mph)&nbsp;</th>
1485           <th align=left>Description</th>
1486          </tr>
1487
1488          <tr>
1489           <td nowrap valign=top><tt>0</tt>&nbsp; </td>
1490           <td align=center>20</td>
1491           <td align=left>wooden</td>
1492          </tr>
1493
1494          <tr>
1495           <td nowrap valign=top><tt>1</tt>&nbsp; </td>
1496           <td align=center>30</td>
1497           <td align=left>concrete</td>
1498          </tr>
1499
1500          <tr>
1501           <td nowrap valign=top><tt>2</tt>&nbsp; </td>
1502           <td align=center>40</td>
1503           <td align=left>girder, steel</td>
1504          </tr>
1505
1506          <tr>
1507           <td nowrap valign=top><tt>3</tt>&nbsp; </td>
1508           <td align=center>50</td>
1509           <td align=left>suspension, concrete</td>
1510          </tr>
1511
1512          <tr>
1513           <td nowrap valign=top><tt>4</tt>&nbsp; </td>
1514           <td align=center>60</td>
1515           <td align=left>suspension, steel</td>
1516          </tr>
1517
1518          <tr>
1519           <td nowrap valign=top><tt>5</tt>&nbsp; </td>
1520           <td align=center>70</td>
1521           <td align=left>suspension, steel</td>
1522          </tr>
1523
1524          <tr>
1525           <td nowrap valign=top><tt>6</tt>&nbsp; </td>
1526           <td align=center>100</td>
1527           <td align=left>cantilever, steel</td>
1528          </tr>
1529
1530          <tr>
1531           <td nowrap valign=top><tt>7</tt>&nbsp; </td>
1532           <td align=center>130</td>
1533           <td align=left>cantilever, steel</td>
1534          </tr>
1535
1536          <tr>
1537           <td nowrap valign=top><tt>8</tt>&nbsp; </td>
1538           <td align=center>150</td>
1539           <td align=left>cantilever, steel</td>
1540          </tr>
1541
1542          <tr>
1543           <td nowrap valign=top><tt>9</tt>&nbsp; </td>
1544           <td align=center>160</td>
1545           <td align=left>girder, steel</td>
1546          </tr>
1547
1548          <tr>
1549           <td nowrap valign=top><tt>A</tt>&nbsp; </td>
1550           <td align=center>200</td>
1551           <td align=left>tubular, steel</td>
1552          </tr>
1553
1554          <tr>
1555           <td nowrap valign=top><tt>B</tt>&nbsp; </td>
1556           <td align=center>320</td>
1557           <td align=left>tubular, steel</td>
1558          </tr>
1559
1560          <tr>
1561           <td nowrap valign=top><tt>C</tt>&nbsp; </td>
1562           <td align=center>380</td>
1563           <td align=left>tubular, silicon</td>
1564          </tr>
1565         </table>
1566        </li>
1567       </ul>
1568      </li>
1569      <li style="color: blue">m5 bits 6..5: signal simulation (signals on bridge/tunnels patch)
1570       <table style="color: blue">
1571        <tr>
1572         <td><tt>0</tt>&nbsp;</td>
1573         <td>no signal simulation</td>
1574        </tr>
1575
1576        <tr>
1577         <td><tt>1</tt>&nbsp;</td>
1578         <td>signal simulation entrance (bit 5 set)</td>
1579        </tr>
1580
1581        <tr>
1582         <td><tt>2</tt>&nbsp;</td>
1583         <td>signal simulation exit (bit 6 set)</td>
1584        </tr>
1585       </table>
1586       If signal simulation entrance or exit:
1587       <ul>
1588        <li>m6 bit 6: set = PBS signals, clear = block signals</li>
1589        <li>m6 bit 1: set = semaphore signals, clear = light signals</li>
1590        <li>m6 bit 0: set = signal shows green, clear = signal shows red</li>
1591        <li>m2 bit 15: for bridge entrances only: storage for visual red/green state of signals starting from 15 is allocated outside the map array</li>
1592        <li>m2 bits 14..0: for bridge entrances only: for signals 0..14 on bridge, signal is visually red if corresponding bit in 0..14 is set</li>
1593       </ul>
1594      </li>
1595      <li>m5 bits 3..2: transport type
1596       <table>
1597        <tr>
1598         <td><tt>0</tt>&nbsp;</td>
1599         <td>railway</td>
1600        </tr>
1601
1602        <tr>
1603         <td><tt>1</tt>&nbsp;</td>
1604         <td>road</td>
1605        </tr>
1606
1607        <tr>
1608         <td><tt>2</tt>&nbsp;</td>
1609         <td>water</td>
1610        </tr>
1611       </table>
1612      </li>
1613      <li>m5 bits 1..0: direction onto the bridge / out of the tunnel
1614       <table>
1615        <tr>
1616         <td><tt>0</tt>&nbsp; </td>
1617         <td>NE</td>
1618        </tr>
1619
1620        <tr>
1621         <td><tt>1</tt>&nbsp; </td>
1622         <td>SE</td>
1623        </tr>
1624
1625        <tr>
1626         <td><tt>2</tt>&nbsp; </td>
1627         <td>SW</td>
1628        </tr>
1629
1630        <tr>
1631         <td><tt>3</tt>&nbsp; </td>
1632         <td>NW</td>
1633        </tr>
1634       </table>
1635      </li>
1636      <li>m7 bits 4..0: <a href="#OwnershipInfo">owner</a> of road</li>
1637      <li>m7 bit 5 set = on snow or desert</li>
1638      <li style="color: blue">m7 bit 6: bit 4 of <a href="#RoadType">Road-(sub-)types</a></li>
1639      <li style="color: blue">m7 bit 7: bit 4 of <a href="#RoadType">Tram-(sub-)types</a></li>
1640     </ul>
1641    </td>
1642   </tr>
1643
1644   <tr bgcolor="#CCCCCC">
1645    <td valign=top nowrap><strong><a name="ClassA"><tt> A</tt></a></strong></td>
1646    <td><strong><tt>Objects</tt></strong></td>
1647   </tr>
1648   <tr>
1649    <td valign=top nowrap>&nbsp;</td>
1650    <td>
1651     <ul>
1652      <li>m1 bits 6..5 : Water class (sea, canal, river or land)</li>
1653      <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> of the object (for lighthouses and transmitters normally <tt>10</tt>)</li>
1654      <li>m2: index into the array of objects, bits 0 to 15 (upper bits in m5)</li>
1655      <li>m3: random bits</li>
1656      <li>m5: index into the array of objects, bits 16 to 23 (lower bits in m2)</li>
1657      <li>m7: animation counter</li>
1658     </ul>
1659    </td>
1660   </tr>
1661   <tr>
1662    <td colspan=2>Classes <tt>B</tt> through <tt>F</tt> are reserved. The presence
1663       of a tile in one of the reserved classes will crash OTTD.</td>
1664   </tr>
1665  </table>
1666
1667
1668  <hr>
1669  Original Copyright &copy; 2003 by Marcin Grzegorczyk for TTDLX.<br>
1670  Transport Tycoon and Transport Tycoon Deluxe are Copyright &copy; by Chris Sawyer.<br>
1671  All the other trademarks are the property of their respective owners.<br>
1672 </body>
1673
1674 </html>