Action12

2006-02-11T22:28:20Z

Lakie:

'''''Load font glyphs'''''

=Action 12=

Load font glyphs

-=Description=-

This action allows defining glyphs for any [http://www.unicode.org/|Unicode] character in the BMP (Basic Multilingual Plane), i.e. up to U+FFFF.

Available since 2.0.1 alpha 73.

-=Format=-

The data looks as follows:

<pre>-+<sprite-number> * <length> 12 <num-def> <nowiki><nowiki>( <num-char> <base-char>){n}</nowiki></nowiki>+-</pre>

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

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

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

12|B|Action 12

num-def|B|Number of definitions

font|B|Font for which to provide glyphs

num-char|B|Number of consecutive glyphs

base-char|W|First Unicode character for which to provide glyphs||

Following the action 12 must be the real sprites for all glyphs, as many sprites as all <num-char> added up.

-=Filling in the terms=-

===sprite-number===

The current sprite number.

===length===

The total number of bytes in this action 12.

===num-def===

This specifies how many definitions follow, each having , <basechar> and <numchar>.

===font===

The font to define glyphs for. The value can be 0 for the normal size, 1 for the small size, or 2 for the large size font.

===num-char===

The number of characters in the range.

===base-char===

The first Unicode character in a range to provide glyphs for.  This can be any Unicode character in the BMP.

Note that all characters of a definition (i.e., <basechar> <numchar> triplet) must fit within a "block" of 128 characters, i.e. you cannot define characters U+00E0..U+011F with one definition; instead you must split it into U+00E0..U+00FF and U+0100..U+011F because those are two different blocks.

-=Example=-

<pre>-+ 583 * 9 12 02 00 08 F8 00 0C 00 01+-</pre>

||'''Byte'''|'''Meaning'''

583|<sprite-number>

9|<length> of the action in bytes; start counting at 12 (<action>)

12|<action>: sets this pseudo-sprite to function as action 12

02|<num-def>: we're defining two ranges of characters

00|: first range, defining font 0 (normal size)

08|<num-char>: defining 8 characters in a row

F8 00|<base-char>: character U+00F8 is the first character

00|: second range, also defining font 0 (normal size)

0C|<num-char>: defining another 12 characters

00 01|<base-char>: character U+0100 is the first character||

Therefore, this action 12 defines glyphs for Unicode characters U+00F8..U+010B. They are split into two definitions because a definition cannot cross a block boundary.

After this action 12 follow 20 real sprites containing the glyphs for the above characters.

ActionA

2004-07-28T23:24:18Z

Lakie:

'''''Modify TTD's sprites'''''

=Action A=

Modify TTD's sprites.

-=Introduction=-

Unlike actions 1 and 5, which add new sprites for new features or vehicles, action A modifies TTD's built-in sprites.

-=Format=-

The data looks as follows:

<pre> -+<Sprite-number> * <Length> 0A <num-sets> <num-sprites> <first-sprite>...+-</pre>

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

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

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

0A|B|Defines action 0A

<num-sets>|B|How many consecutive sets of sprites to replace

<num-sprites>|B|How many consecutives sprites in this set

<first-sprites>|W|Number of first sprite in this set||

The set of <num-sprites> and <first-sprites> is repeated as often as <num-sets> specifies.

The following sprites will be real sprites that replace the given TTD sprites.  There must be as many of them as num-sprites of all sets added up.

-=Filling in the terms=-

===Sprite-number===

This is just the number you are at.

===Length===

Count the number of bytes in this action.

===num-sets===

This sets how many different sets of sprites to replace. Each set are a number of consecutive sprites.

===num-sprites===

How many consecutive sprites to replace in this particular set.

===first-sprite===

The first sprite number to replace in this set.

-=Notes=-

You can find the sprite numbers by looking in trg1.pcx, they're the little numbers above each sprite, except for the climate-specific sprites which are more complicated.

Unlike actions 1 and 5, the real sprites of action A do not count towards the sprite limit of 11484 total active sprites.

To replace Sprites in other climates, you first need to find out what the sprite number is trg1.grf

You set it to replace that number and add an Action7 which turns it off if it is not in the right climate.

-=Example=-

Below is an example of what a real Action A pseudo-sprite could look like with the sprite entries under it.

<pre>3 * 5     0A 01 0C 3A 08

4 c:\ttd\sprites\farmset.pcx 66 8 09 31 64 -31 0

5 c:\ttd\sprites\farmset.pcx 146 8 09 31 64 -31 0

6 c:\ttd\sprites\farmset.pcx 226 8 09 45 48 -15 -11

7 c:\ttd\sprites\farmset.pcx 290 8 09 33 22 1 -10

8 c:\ttd\sprites\farmset.pcx 322 8 09 31 64 -31 0

9 c:\ttd\sprites\farmset.pcx 402 8 09 29 57 -26 -4

10 c:\ttd\sprites\farmset.pcx 466 8 09 31 64 -31 0

11 c:\ttd\sprites\farmset.pcx 546 8 09 31 39 -19 -6

12 c:\ttd\sprites\farmset.pcx 594 8 09 31 64 -31 0

13 c:\ttd\sprites\farmset.pcx 674 8 09 49 28 -6 -28

14 c:\ttd\sprites\farmset.pcx 722 8 09 31 64 -31 0

15 c:\ttd\sprites\farmset.pcx 2 72 09 30 55 -29 0</pre>

||'''Byte'''|'''Meaning'''

3|<sprite-number>

5|<length> of the action in bytes; start counting at 0A (<action>)

0A|<action>: sets this pseudo-sprite to function as action A

01|<num-sets>: sets it to 1 set to replace

0C|<num-sprites>: sets it to 12 sprites in this set.

3A 08|<first-sprite>: First Sprite of the set (3A 08 - Farms)||

ActionA

2004-07-28T23:03:12Z

Lakie:

ActionA

2004-07-28T23:00:55Z

Lakie: