SpriteErrors

From GRFSpecs
Revision as of 17:24, 11 September 2008 by eis_os (talk)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Explanation of all possible sprite error messages

Sprite Errors

This page explains the error messages that may be generated due to incorrect pseudo-sprite data.  It does not include the messages that are only generated by an action B.

List of sprite error messages

||Message|Meaning

More sprites than specified|The file contains more sprites than the first pseudo-sprite specifies

Out of memory|TTDPatch could not read the sprite data because it ran out of memory

Wrong .grf version|Either the action 8 requires a different grf version, the file had no action 8, or the sprite uses an action that is not valid before action 8

Cannot load more sprites|The limit of active sprites has been exceeded

File file not found|The file was listed in newgrf(w).cfg but could not be opened

File file has invalid sprite #nr (code code/pos)|The pseudo-sprite data of the given sprite is invalid; see below for explanation of code and pos

File file is not a TTDPatch graphics file|The first sprite is not a pseudo-sprite, or it does not specify a valid number of sprites||

Invalid sprites

A pseudo-sprite has invalid data, if it does not follow the specifications of each action correctly.  In this error message (starting with TTDPatch 2.0.1 alpha 46), the code defines what kind of error occured, and the position pos in most cases (i.e. whenever possible) points to the byte in the sprite that follows the one which triggered the error.

||Code|Meaning

1|A real graphics sprite was encountered where a pseudo sprite was expected

2|The sprite uses an unknown action type, or this action is not valid before an action 8

3|The sprite uses an unknown feature

4|The sprite refers to an invalid vehicle/text/town part ID

5|The sprite has fewer bytes than expected

6|The given property number in action 0 is invalid

7|The sprite block following action 1/5/A/11/12 would go beyond the end of the file

8|The feature types of action 1, 2 and 3 don't agree

9|Action 2 refers to an action 1 sprite block that is beyond the size of the most recent action 1 sprite block

10|Action 2 (var./random) or action 3 refers to an action 2 cargo-id that hasn't been defined yet

11|Action 7, 9 or D refers to an invalid variable number

12|The grf file has multiple action 8 entries

13|Action A refers to an invalid TTD sprite

14|The message severity in action B is invalid

15|The message type in action B is invalid

16|The operation type in action D is invalid

17|Action E is trying to deactivate an already-active file

18|The number of parts in action F is zero when it must not be zero

19|The bit number or count in action F is invalid

20|Invalid label number in action 10

21|Resource not valid for action D (ID out of range, or invalid for this resource type)

22|Multiple action 11 present in GRF file, there may only be one

23|A sprite that is part of action 11 is not a binary include file

24|Attempt to modify ID not reserved with GRM (only with experimentalfeatures.mandatorygrm on)

25|Invalid font number in action 12

26|Range crosses 128-character block, must be split

27|Invalid property value in action 0

28|Invalid condition type in action 7/9

29|Invalid industry tile ID in industry layout

30|Inconsistent industry layout size|

31|Invalid subid in action3||

Note, if you do not see the code or the position, you need to edit your ttdpttxt.txt file, and change the "invalidsprite" line into the following format (and then rerun mkpttxt.exe):

-+invalidsprite="\94File \"\80\" has invalid sprite #\7c (code \7c/\7c).\00"+-

Resource conflicts

If a GRF file attempts to allocate a resource that is not available, it will be deactivated and the following message will be shown: "GRF conflict with <other-grf> (resource <r-id> at sprite <num>)".

The following resources can cause conflicts. Numbers 0 and above are allocated by a GRM action D, negative numbers are automatically allocated by an action 0 (IDs), action 4 (persistent GRF texts) or actions 1/5/D/12 (sprites).

||r-id(s)|Resource

-12|Duplicate GRFID

-11|Persistent GRF texts

-10|New industries

-9|New industry tiles

-8|New houses

-7|New stations

-6|House sprites

-5|Plane sprites

-4|Ship sprites

-3|Road vehicle sprites

-2|Train sprites

-1|"Other" sprites

0..255|Vehicle IDs

256..287|Cargo IDs

288..319|Cargo bits||