Difference between revisions of "Action13"

From GRFSpecs
Jump to navigationJump to search
m (use grfID consistently)
m (use GRFID consistently)
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 <feature> <GRFID> <num-ent> <offset> <text...>
   
 
{|
 
{|
Line 29: Line 29:
 
|Action 13
 
|Action 13
 
|-
 
|-
|<grfID>
+
|<GRFID>
 
|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
 
|-
 
|-
 
|<num-ent>
 
|<num-ent>
Line 49: Line 49:
 
For action 13, <num-ent>, <offset> and <text...> work exactly as for [[Action4|action 4]], but the offset may only refer to a text ID in the D000 or DC00 range of IDs.
 
For action 13, <num-ent>, <offset> and <text...> work exactly as for [[Action4|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.
+
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.

Revision as of 16:05, 15 June 2011

Description

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.

Available since 2.6 alpha 1 (r857).

Format

The data looks as follows:

<sprite-number> * <length> 13 <feature> <GRFID> <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
<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.