View source for Action10


'''''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. &nbsp;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:

<pre>-+&lt;sprite-number&gt; * &lt;length&gt; 10 &lt;label&gt; <nowiki><nowiki>[&lt;comment&gt;]</nowiki></nowiki>+-</pre>

||'''Element'''|[[GRFActionsDetailed|'''Size''']]|'''Description'''

&lt;sprite-number&gt;|dec|A sequential sprite number

&lt;length&gt;|dec|The total number of bytes in the action

10|B|Action 10

&lt;label&gt;|B|Which label to define

&lt;comment&gt;|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 [[Action7#num-sprites|action 7]] for details.