Action10

From GRFSpecs
Revision as of 20:11, 22 January 2006 by dmccoy (talk)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Define GOTO label for action 7/9

Action 10

Define GOTO label for action 7/9

-=Description=-

To eliminate having to change all action 7/9 entries after adding sprites to a .grf file, you can define labels using this action 10.  Additionally, this is the only way to skip more than 255 sprites at once.

Available since 2.0.1 alpha 49.

-=Format=-

The data looks as follows:

-+<sprite-number> * <length> 10 <label> <nowiki>[<comment>]</nowiki>+-

||Element|Size|Description

<sprite-number>|dec|A sequential sprite number

<length>|dec|The total number of bytes in the action

10|B|Action 10

<label>|B|Which label to define

<comment>|V|Optional comment, ignored by TTDPatch||

-=Filling in the terms=-

sprite-number

The current sprite number.

length

The total number of bytes in this action 7 or 9.

label

This sets the number of the label to define. It may range from E0 to FF (allowing 32 labels per grf file).

If two labels are defined with the same number, only the last definition counts.

Since 2.0.1 alpha 70, the label may have any number (instead of just E0..FF). In addition, duplicate labels are handled differently, see action 7 for details.