Difference between revisions of "Action10"

From GRFSpecs
Jump to navigationJump to search
m (6 revisions)
m (cleanup in aisle 10)
Line 1: Line 1:
  +
==Introduction==
 
'''''Define GOTO label for action 7/9'''''
 
 
=Action 10=
 
   
 
Define GOTO label for action 7/9
 
Define GOTO label for action 7/9
   
 
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.
-=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.
 
Available since 2.0.1 alpha 49.
   
  +
==Syntax==
-=Format=-
 
   
 
The data looks as follows:
 
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>
+
<pre><sprite-number> * <length> 10 <label> [<comment>]</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||
 
 
!Element !![[GRFActionsDetailed|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
  +
|}
   
 
==Description==
-=Filling in the terms=-
 
   
 
===sprite-number===
 
===sprite-number===

Revision as of 15:40, 14 June 2011

Introduction

Define GOTO label for action 7/9

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.

Syntax

The data looks as follows:

<sprite-number> * <length> 10 <label> [<comment>]
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

Description

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.