Difference between revisions of "Action5"
Andythenorth (talk | contribs) (→type) |
(Add Action 5 type 19: road waypoints) |
||
(12 intermediate revisions by 2 users not shown) | |||
Line 63: | Line 63: | ||
|- |
|- |
||
− | |04,84<ref name="offset">Offset allowed since {{ottdp|1.2|no|ottdrev=r23005}}</ref>||{{ottdp| |2.5|ttdprev=alpha 41}}||Pre-signal, semaphore, and |
+ | |04,84<ref name="offset">Offset allowed since {{ottdp|1.2|no|ottdrev=r23005}}</ref>||{{ottdp| |2.5|ttdprev=alpha 41}}||Pre-signal, semaphore, and PBS graphics||240 |
|- |
|- |
||
Line 81: | Line 81: | ||
|- |
|- |
||
− | |09,89<ref name="offset" />||{{ottdp|0.6|2.5|ttdprev=alpha 58}}||One-way road arrows||6 |
+ | |09,89<ref name="offset" />||{{ottdp|0.6|2.5|ttdprev=alpha 58}}||One-way road arrows||{{ottdp|13|no}} 18 {{ottdp|0.6 - 12|2.5}} 6 |
|- |
|- |
||
Line 87: | Line 87: | ||
|- |
|- |
||
− | |0B,8B<ref name="offset" />||{{ottdp|0.6|2.5|ttdprev=alpha 68}}||Tram tracks|| |
+ | |0B,8B<ref name="offset" />||{{ottdp|0.6|2.5|ttdprev=alpha 68}}||Tram tracks||{{ottdp|1.10|no}} 119 {{ottdp|0.6 - 1.9|2.5}} 113 |
|- |
|- |
||
Line 114: | Line 114: | ||
|- |
|- |
||
− | |14,94||{{ottdp|0.6|no|ottdrev=11433}}||Flag sprites||Up to 36 |
+ | |14,94||{{ottdp|0.6 - 1.11|no|ottdrev=11433}}||Flag sprites (no longer used)||Up to 36 |
|- |
|- |
||
− | |15,95||{{ottdp|0.6|no|ottdrev=r11433}}||OpenTTD GUI sprites||Up to |
+ | |15,95||{{ottdp|0.6|no|ottdrev=r11433}}||OpenTTD GUI sprites||Up to 191 |
|- |
|- |
||
Line 127: | Line 127: | ||
|- |
|- |
||
|18,98||{{ottdp|1.5|no|ottdrev=r26869}}||Extra all black palette||1 |
|18,98||{{ottdp|1.5|no|ottdrev=r26869}}||Extra all black palette||1 |
||
+ | |||
+ | |- |
||
+ | |19,99||{{ottdp|15|no|}}||Road waypoint graphics||4 |
||
|} |
|} |
||
Line 159: | Line 162: | ||
|8..14||repeat 0..6 for PBS signals |
|8..14||repeat 0..6 for PBS signals |
||
|} |
|} |
||
+ | |||
+ | ==== 09 One-way road arrows ==== |
||
+ | |||
+ | Overlay sprites to indicate the direction of one-way roads. |
||
+ | The 6 sprites originally supported from {{ottdp|0.6|2.5}} are, in order: |
||
+ | |||
+ | arrow facing SW, arrow NE, impassable NE-SW, arrow NW, arrow SE, impassable NW-SE. |
||
+ | |||
+ | Before {{ottdp|13|no}} these are used on both flat and sloped roads. |
||
+ | |||
+ | From {{ottdp|13|no}} the grf can optionally provide 18 sprites instead of 6. |
||
+ | In this case the first 6 sprites are used for flat tiles only. The next 6 are used in the same sequence for slopes with the N corner raised, and the last 6 for slopes with the S corner raised. |
||
==== 0C Snowy temperate trees ==== |
==== 0C Snowy temperate trees ==== |
||
Line 245: | Line 260: | ||
==== 15 / 95 OpenTTD GUI sprites ==== |
==== 15 / 95 OpenTTD GUI sprites ==== |
||
− | OpenTTD defines |
+ | OpenTTD defines 190 GUI sprites. Additional sprites not needed by an OpenTTD are simply ignored, so that new(er) base sets can be used by old OpenTTD versions. One can (re-)define a subset of the GUI sprites by giving an offset into the GUI sprites. The sprites are: |
{| |
{| |
||
!Offset !! Meaning |
!Offset !! Meaning |
||
Line 364: | Line 379: | ||
|- |
|- |
||
|179 .. 183 || NotRoadTypes toolbar and cursor icons |
|179 .. 183 || NotRoadTypes toolbar and cursor icons |
||
+ | |- |
||
+ | |184 || {{ottd|1.11|g8dda0ec4f}} window title bar: rename vehicle/station/town/... |
||
+ | |- |
||
+ | |185 || {{ottd|1.11|g8dda0ec4f}} window title bar: go to location of vehicle/station/town/industry/... |
||
+ | |- |
||
+ | |186 .. 190 || {{ottd|1.12|gfda1a590f6}} multiplayer GUI: chat, admin action, join team, self player, host player |
||
|} |
|} |
||
Latest revision as of 19:48, 23 April 2024
Introduction
Define base graphics specific sets
Action 5 is used to define graphics for several new features of OpenTTD and TTDPatch. This is similar to action 1.
Syntax
The data looks as follows:
<Sprite-number> * <Length> 05 <type> <num-sprites> [<offset>]
Element | Size | Description |
---|---|---|
<Sprite-number> | dec | A sequential sprite number |
<length> | dec | The total number of bytes used in this action |
05 | B | Defines action 05 |
<type> | B | What type of graphics follow |
<num-sprites> | B* | How many regular sprites follow |
<offset> | B* | Offset in the Action 5 assignable block of sprites |
The following num-sprites sprites in the .nfo file have to be RealSprites that will be used as graphics for the given TTDPatch feature, except for type 0A, which requires RecolorSprites.
0.7 2.5Action 5 entries in a .grf file which has a regular GRFID (not FFFFFFFF) will always override those from .grf files with a GRFID of FFFFFFFF.
Description
Sprite-number
This is just the number you are at.
Length
Count the number of bytes in this action.
type
This sets the type of feature that the graphics are for. If bit 7 is set, the offset variable needs to be set. Bit 7 may only be set if the type supports it. The type can be one of:
Type | Version | Feature | num-sprites (decimal) |
---|---|---|---|
04 | 0.6 2.0 | Pre-signal graphics | 48 |
04 | 0.6 2.0 | Pre-signal and semaphore graphics | 112 |
04,84[1] | 2.5 | Pre-signal, semaphore, and PBS graphics | 240 |
05,85[1] | 0.6 2.0 | Overhead wires and pylon graphics | 48 |
06 | 0.6 | Foundations (retaining walls) for BuildOnSlopes | 74 |
06,86[1] | 0.6 | Foundations for BuildOnSlopes and half tiles (NS and EW foundations) | 90 |
07 | 2.5 | TTDPatch GUI sprites | 93 [2] |
08,88[1] | 0.6 [3] | Canals | 65 |
09,89[1] | 0.6 2.5 | One-way road arrows | 13 18 0.6 - 12 2.5 6 |
0A,8A[1] | 0.6 2.5 | Two company color translation maps | 256 |
0B,8B[1] | 0.6 2.5 | Tram tracks | 1.10 119 0.6 - 1.9 2.5 113 |
0C | 2.5 | Snowy temperate trees | 133 |
0D | 0.6 2.5 | Coast Tile graphics | 16 (18) |
0E | 2.6 | New Signals | Any |
0F,8F[1] | 0.7 2.6 | Sprites for marking tracks on slopes (for track reservation systems like PBS or YAPP) | Up to 12 |
10,90[1] | 0.6 | Additional airport graphics | 15 |
11,91[1] | 0.6 2.6 | Road stop graphics | 8 |
12,92[1] | 0.7 2.6 | Aqueduct graphics | 8 |
13,93[1] | 0.6 | Autorail sprites | 55 |
14,94 | 0.6 - 1.11 | Flag sprites (no longer used) | Up to 36 |
15,95 | 0.6 | OpenTTD GUI sprites | Up to 191 |
16,96 | 1.1 | Airport preview sprites | Up to 9 |
17,97 | 1.2 | Railtype tunnel base sprites | 16 |
18,98 | 1.5 | Extra all black palette | 1 |
19,99 | 15 | Road waypoint graphics | 4 |
- ↑ 1.00 1.01 1.02 1.03 1.04 1.05 1.06 1.07 1.08 1.09 1.10 1.11 Offset allowed since 1.2
- ↑ Type 07 only requires 73 sprites in the stable (2.5 branch); the extra sprites are the clone train and build canal cursors.
- ↑ TTDPatch supported canals via Action5 from 2.0.1 alpha 17 up to alpha 25. In alpha 26 it was removed again in favour of an action-1-2-3 method; see Action3. The method via Action5 is no longer supported by TTDpatch 2.0.1 alpha 26 and newer.
04 Signal graphics.
Signal graphics come in groups of 16. These groups contain sprites in the same order as sprites 1275-1290 in trg1[r].grf; red, then green, for each of: SW-facing, NE-facing, NW-facing, SE-facing, E-facing, W-facing, S-facing, N-facing.
Group(s) | Contents |
---|---|
0 | lighted entrance signals |
1 | lighted exit signals |
2 | lighted combo signals |
3 | standard (non-pre-signal) semaphore signals |
4..6 | repeat 0..2 for semaphores |
7 | standard lighted PBS signals |
8..14 | repeat 0..6 for PBS signals |
09 One-way road arrows
Overlay sprites to indicate the direction of one-way roads. The 6 sprites originally supported from 0.6 2.5 are, in order:
arrow facing SW, arrow NE, impassable NE-SW, arrow NW, arrow SE, impassable NW-SE.
Before 13 these are used on both flat and sloped roads.
From 13 the grf can optionally provide 18 sprites instead of 6. In this case the first 6 sprites are used for flat tiles only. The next 6 are used in the same sequence for slopes with the N corner raised, and the last 6 for slopes with the S corner raised.
0C Snowy temperate trees
If the temperate snow line is enabled, you can use this to specify the snowy versions of temperate trees. The sprites must be the snowy versions of sprites 1576-1708 from TRG1.GRF, in the same order as they appear there.
0D Coast tile sprites
In NewGRFs
If diagonal flooding is enabled then due to new corner coasts, you can use this to give a complete set of replacement coast tile sprites. There are 16 in total, 8 original Transport Tycoon Deluxe sprites and 8 for the corner slopes. Order of the sprites[1] is as follows:
3997, 4063, 4064, 4068, 4062, 3998, 4066, 3988, 4065, 4069, 3996, 3992, 4067, 3994, 3995, 3999.
- ↑ Sprite numbers from trg1(r).pcx.
The 16 sprites for feature 0D
In Base Set's extra grf
Additionally, OpenTTD (since r11726) supports another method of supplying all additional coast tile sprites, but this is only allowed in the extra NewGRF of Base Graphic Sets. In this, only 10 sprites are supplied in the same order as the 16 sprites above, but without the coast sprites already in the base grf. Note that the 10 sprites version supplies two additional slopes, but they are not used, and are currently unlikely to be ever used.
Only 10 sprites are required for OpenTTD base graphic sets
In OpenTTD 10 sprites for type 0D is enough in base graphic sets. The 16 sprites version should not be used for base graphics.
The reason for the existence of a 10 sprite version is to remove the need for including original graphics, and to keep compatibility with old NewGRFs that replace the original shore graphics using Action A without adding new shores using Action 5: When a NewGRF uses the 16 sprites version it takes precedence above any NewGRF replacing the shore graphics using Action A; when a NewGRF uses Action A to replace shore graphics it takes precedence above a 10-sprite Action 5, effectively disabling diagonal flooding. Also due to compatibility the 10 sprites version is invalid for normal NewGRFs, which are not the "extra" NewGRF of some Base Graphics Set.
0E New Signals
Any number of real and recolour sprites can be specified in the action in any order.
Sprites are referenced by their offset into the action5 block by a VarAction2NewSignals, hence a logically easily calculable order is advised.
As of TTDPatch 2.6 alpha 0 r1346, the action 5 block defined in the same GRF file as the varaction2, will be used as the base sprite block for the offsets returned by the callback even if it is overridden by a higher priority GRF action 5 definition of the same feature (0E).
0F Tracks for Slopes
This should be in the same order as sprites 1031 to 1035 (1). These should only be the rails, basically the same format as sprites 1005 to 1010 (1). There should be 3 groups of these sprites, one for each rail type (railroad, monorail, maglev).
(1) Sprite numbers from trg1r.pcx / ogfx1_base.grf
11 Road stop graphics
Road stop graphics consist of 2 groups of 4 sprites. The first group contains graphics for bus stops, second for truck stops. In each group, the sprites are in the following order: SW, NE, NW, SE.
SW and NE sprites are used with road going along the Y axis ( .\' ), NW and SE with road along the X axis( '/. ).
Internally, the stations are defined using the following station layouts:
\d1313 \b13 \b0 \b0 \b3 \b16 \b16 <SW sprite> \b0 \b0 \b0 \b3 \b16 \b16 <NE sprite> 80
and
\d1314 \b0 \b0 \b0 \b16 \b3 \b16 <NW sprite> \b0 \b13 \b0 \b16 \b3 \b16 <SE sprite> 80
where 1313 and 1314 are town road sprites.
Further sprites can be found in openttd.grf (OpenTTD), ogfxe_extra.grf (OpenGFX) or ttdpbase(w).grf (TTDPatch).
Note: As of OpenTTD r10185, the behaviour of this feature is identical in both games.
12 Aqueducts
8 real sprites should be given. Firstly: 4 bridge end sprites in the order: SW, SE, NE, NW, where the direction is that heading onto the aqueduct. Then 2 middle part sprites for the X and Y directions. Followed by two pillar sprites for the X and Y directions. For examples of where the division between middle sprites and pillars should be made see sprites 2437 to 2592 (1), or an existing aqueduct GRF. Note, that for higher bridges to work effectively, pillars should be approximately 8px in height.
15 / 95 OpenTTD GUI sprites
OpenTTD defines 190 GUI sprites. Additional sprites not needed by an OpenTTD are simply ignored, so that new(er) base sets can be used by old OpenTTD versions. One can (re-)define a subset of the GUI sprites by giving an offset into the GUI sprites. The sprites are:
16 / 96 Airport preview sprites
Preview sprites for the airports in the order
- Small airport
- City airport
- Heliport
- Metropolitan airport
- International airport
- Commuter airport
- Heli depot
- Intercontinental airport
- Heli station
Sprites are without any offsets and should all be the same size. Make sure so by using the forbid cropping.
17 / 97 Tunnel overlay sprites
The sprites provide the ground for the tunnel sprites to be used by railtype NewGRFs which only need to provide the tunnel portals. They must be provided for both terrain types which could be used in any given climate (grass; grass+snow; grass+desert; grass).
num-sprites
The number of sprites that follow.
Since TTDPatch 2.0.1 alpha 49, this value is an extended byte.
Note that it is not generally an error to provide more sprites than required, but this does expend sprite slots unnecessarily.
offset
The offset in the Action 5 assignable block of sprites. This term is only read when bit 7 of the type has been set. It can be used to only replace a subset of sprites from a set.
Note: When creating a TTDPatch compatible grf, you have to skip the OpenTTD specific Action 05's using an Action 09 rather than an Action 07. Using the latter will result in an error on your Action 05 when using the grf in TTDPatch.
Note: NFORenum distinguishes Action5 with no offset and Action5 with offset 0. While they have technically the same effect, NFORenum assumes an Action5 with no offset has the intention to replace all sprites and checks the number of sprites accordingly. An Action5 with offset is considered to only replace a subset of the sprites, so the sprites are not checked for completeness.
Example
// Replace the piers for the aqueduct 1457 * 3 05 12 02 06 // action5, type 12, 2 sprites, at offset 6 into that type 9 sprites/png/terrain/waterfeatures.png 546 8 09 23 33 -26 0 10 sprites/png/terrain/waterfeatures.png 594 8 09 23 33 -5 0