Difference between revisions of "Action13"

From GRFSpecs
Jump to navigationJump to search
m (use GRFID consistently)
m (Fix <feature> incorrectly appearing in the format summary line)
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Description==
 
==Description==
  +
{{ottdp|0.6|2.6|ttdprev=r857}}
 
 
Translating regular strings is easy by just overwriting them with an [[Action4|action 4]], however this is not possible for translating GRF-specific strings in the D000 or DC00 range of IDs. Instead, these must be translated with this action 13.
 
Translating regular strings is easy by just overwriting them with an [[Action4|action 4]], however this is not possible for translating GRF-specific strings in the D000 or DC00 range of IDs. Instead, these must be translated with this action 13.
   
  +
{{ottd|}}Usage of this action with OpenTTD is troublesome in multiplayer. The action does not specify a language code for the translation, but forces the translation on every player. However, GRFs with only action 13 can be loaded as [[OpenTTD static NewGRF]]. {{grfFrom|8}} GRF version 8 alleviates this problem by providing the language that is overridden.
Available since 2.6 alpha 1 (r857).
 
   
 
== Format ==
 
== Format ==
Line 9: Line 9:
 
The data looks as follows:
 
The data looks as follows:
   
<sprite-number> * <length> 13 <feature> <GRFID> <num-ent> <offset> <text...>
+
<sprite-number> * <length> 13 <GRFID> (<language-id>)? <num-ent> <offset> <text...>
   
 
{|
 
{|
Line 32: Line 32:
 
|4*B
 
|4*B
 
|The GRFID of the file whose texts are to be translated
 
|The GRFID of the file whose texts are to be translated
  +
|-
  +
|<language-id>
  +
|B
  +
|{{grfFrom|8}} Which of TTD's languages these strings are for (only for GRF version 8 an higher)
 
|-
 
|-
 
|<num-ent>
 
|<num-ent>

Latest revision as of 23:25, 27 January 2022

Description

Supported by OpenTTD 0.60.6 Supported by TTDPatch 2.6 (r857)2.6 Translating regular strings is easy by just overwriting them with an action 4, however this is not possible for translating GRF-specific strings in the D000 or DC00 range of IDs. Instead, these must be translated with this action 13.

Supported by OpenTTDUsage of this action with OpenTTD is troublesome in multiplayer. The action does not specify a language code for the translation, but forces the translation on every player. However, GRFs with only action 13 can be loaded as OpenTTD static NewGRF. GRFv≥8 GRF version 8 alleviates this problem by providing the language that is overridden.

Format

The data looks as follows:

<sprite-number> * <length> 13 <GRFID> (<language-id>)? <num-ent> <offset> <text...>
Element Size Description
<sprite-number> dec A sequential sprite number
<length> dec The total number of bytes in the action
13 B Action 13
<GRFID> 4*B The GRFID of the file whose texts are to be translated
<language-id> B GRFv≥8 Which of TTD's languages these strings are for (only for GRF version 8 an higher)
<num-ent> B Number of strings
<offset> W First text ID
<text...> S Zero-terminated strings


For action 13, <num-ent>, <offset> and <text...> work exactly as for action 4, but the offset may only refer to a text ID in the D000 or DC00 range of IDs.

Action 13 is skipped if the given GRFID cannot be found or if the file is inactive; action 13 generates an error message and disables the current file if it appears before the GRF that it is translating.