View source for NMLTutorial/Base graphics replacement

{{NMLTutorial}}

A base graphics set provides the graphics you see when you have no NewGRFs loaded. If you don't want to add any new elements to the game, you can easily replace just these graphics via NewGRF.

There are to distinct types of base graphis: those originating from TTD and those that were added later to TTDPatch and OpenTTD. The first type is replaced by means of the <code>replace</code> block, the latter by means of the <code>replacenew</code> block. The way these blocks work are similar to the [[NMLTutorial/Spriteset and spritegroup|spriteset block]].

== Replace TTD sprites ==
And by this we mean the graphics that originally were in TTD. If you use OpenGFX, this will of course replace OpenGFX sprites and not TTD sprites. But in either case we mean replacements of the sprites in trg1(r).grf (TTD) or ogfx1_base.grf (OpenGFX). It's useful to have a decode (grfcodec) of either of those grfs available to look up the sprite numbers. If you don't have that, you can find one [[:File:Ogfx1 base.png|here]] (choose to view the full resolution version below the thumbnail).

Once you have the sprites you want to replace and know their sprite numbers, you can start writing your <code>replace</code>. The general syntax is as follows:

<pre class="pseudo">
replace [<identifier>] (<sprite-id> [, <image-file>] ) {
	<list_of_realsprites>
}
</pre>

The <code><identifier></code> is something you choose yourself. It's useful to prefix it with ''replace_'' to avoid confusion with other identifiers in your code. It's optional if you only want to replace regular 8 bit sprites, but required if you also want to provide 32 bit sprites and/or sprites for different zoom levels. The <code><sprite-id></code> is the sprite number of the first sprite you want to replace. You can then place all consecutive replacement sprites in this block. As soon as there is a gap, you start a new <code>replace</code> block. The <code><image-file></code> is again optional. Like with a <code>spriteset</code> you can either provide a single filename for all sprites inside the block, or omit the filename here and specify the filename for each realsprite individually.

The <code><list_of_realsprites></code> is the same as for [[NMLTutorial/Spriteset and spritegroup|spriteset blocks]].

=== Climates other than temperate ===
The previous method will provide replacement sprites for all climates at the same time. If you want to provide different sprites for each climate, you'll have to write different <code>replace</code> blocks for each climate. Each of these climate specific blocks are guarded by <code>if</code>-statements as [[NMLTutorial/Version check|introduced earlier]]. In the <code>if</code>-statement you will test the active climate, using the <code>climate</code> [http://newgrf-specs.tt-wiki.net/wiki/NML:General general variable]. Depending on the climate, this variable is equal to one of the following: <code>CLIMATE_TEMPERATE</code>, <code>CLIMATE_ARCTIC</code>, <code>CLIMATE_TROPICAL</code> or <code>CLIMATE_TOYLAND</code>.

This will allow you to write something like the following:
<pre class="example">
if (climate == CLIMATE_ARCTIC) {
	replace replace_roads (1332) {
		template_roads(0,0,"gfx/roads_arctic.png")
	}
}
else if (climate == CLIMATE_TROPICAL) {
	replace replace_roads (1332) {
		template_roads(0,0,"gfx/roads_tropical.png")
	}
}
else if (climate == CLIMATE_TOYLAND) {
	replace replace_roads (1332) {
		template_roads(0,0,"gfx/roads_toyland.png")
	}
}
else { //in all other cases the climate will be temperate, so we need not test this
	replace replace_roads (1332) {
		template_roads(0,0,"gfx/roads_temperate.png")
	}
}
</pre>

In case you want to replace sprites of the other trg*.grf or ogfx*.grf files, you have to do that in the same way as above. Furthermore you cannot use the sprite numbers of those files directly, but you need to look up the equivalent sprite numbers of trg1(r).grf or ogfx1_base.grf. In most cases you can easily find the equivalents just by comparing the type of sprites. There also used to be a calculator for this, but I cannot find that any more.

== Replace OpenTTD sprites ==
Replacing sprites that were not originally in TTD works in a similar way, but slightly different. A <code>replacenew</code> block replaces the sprites supplied by openttd.grf. The general syntax is as follows:

<pre class="pseudo">
replacenew [<identifier>] (<type> [, <image-file> [, <offset>] ] ) {
	<list_of_realsprites>
}
</pre>

Instead of a sprite number you now have to specify the <code><type></code> type of sprites to replace. The available types can be looked up in the [http://newgrf-specs.tt-wiki.net/wiki/NML:Replace_new_sprites NML documentation]. There is a version of a decoded ogfxe_extra available [[:File:Ogfxe extra.png|here]] (choose to view the full resolution version below the thumbnail), with the types indicated.

For some types you need to provide exactly as much sprites as indicated in the documentation. If you don't want to provide all sprites of the type, then you're allowed to do that in most cases. This is where the <code><offset></code> comes in handy. Say you only want to replace the tenth and eleventh sprite of a certain type, then first of all you only provide two realsprites inside the block and second of all set the <code><offset></code> to in this case 9. Counting from 0, this will replace just the tenth and eleventh sprite. If there are gaps, simply use more than one <code>replacenew</code> block.

Also here you may make a climate distinction via <code>if</code>-statements, as explained above for the <code>replace</code> block. If you want to provide the filenames via the realsprites or template (like in the <code>replace</code> example above) and at the same time want to use an <code><offset></code>, then you have to specify <code><image-file></code>. As image files specified for individual realsprites or in templates take precedence, you can in this case point to a random graphics file, as long as it exists.


On the next page we'll look into an example base graphics replacement, providing both 8 bit and 32 bit sprites.


{{NMLTutorialNavbar|Road vehicle 32 bit sprites|32 bit base graphics}}