ActionF - Revision history

Pm-bot: Bot: Automated text replacement (- 2.5 + TTDPatch 2.5)

2011-06-15T17:33:09Z

Bot: Automated text replacement (- 2.5 + TTDPatch 2.5)

← Older revision		Revision as of 17:33, 15 June 2011
Line 53:		Line 53:
	There can be any number of style names, until a literal "00" terminates the style name definition. If no appliable name is found, "(unnamed style)" will be displayed in the Options window.		There can be any number of style names, until a literal "00" terminates the style name definition. If no appliable name is found, "(unnamed style)" will be displayed in the Options window.

	The language selection works the same as the [[Action4#language id\|action 4 language ID]], including the difference for grf version 7 and up, however bit 7 is ignored. This means that there is an ambiguity whether a value of "00" is a list terminator, or the ID of the American language. To resolve this, the first style name definition is never a list terminator (starting with 2.5 beta 4). This means that the definition of the American language name must be the first in the list. Alternatively, since bit 7 is ignored, it is valid to use the value "80" for the ID of the American language as well, but putting it first in the list is the preferred way of defining it.		The language selection works the same as the [[Action4#language id\|action 4 language ID]], including the difference for grf version 7 and up, however bit 7 is ignored. This means that there is an ambiguity whether a value of "00" is a list terminator, or the ID of the American language. To resolve this, the first style name definition is never a list terminator (starting with TTDPatch 2.5 beta 4). This means that the definition of the American language name must be the first in the list. Alternatively, since bit 7 is ignored, it is valid to use the value "80" for the ID of the American language as well, but putting it first in the list is the preferred way of defining it.

	== Parts ==		== Parts ==

Pm-bot: Always link size in table headers

2011-06-15T17:14:44Z

Always link size in table headers

← Older revision		Revision as of 17:14, 15 June 2011
Line 42:		Line 42:

	{\|		{\|
	!Element!!Size!!Meaning		!Element!![[GRFActionsDetailed\|Size]]!!Meaning

	\|-		\|-
Line 62:		Line 62:

	{\|		{\|
	!Element!!Size!!Meaning		!Element!![[GRFActionsDetailed\|Size]]!!Meaning

	\|-		\|-
Line 81:		Line 81:

	{\|		{\|
	!Element!!Size!!Meaning		!Element!![[GRFActionsDetailed\|Size]]!!Meaning

	\|-		\|-

Pm-bot: change city to town

2011-06-15T15:56:08Z

change city to town

← Older revision		Revision as of 15:56, 15 June 2011
Line 5:		Line 5:


	This action can be used to define new town name styles for random games and random ~~cities~~ placed in the scenario editor.		This action can be used to define new town name styles for random games and random towns placed in the scenario editor.

	== Syntax ==		== Syntax ==

Pm-bot: Beautify wiki markup

2011-06-15T14:48:43Z

Beautify wiki markup

← Older revision		Revision as of 14:48, 15 June 2011
Line 1:		Line 1:

	== Introduction ==		== Introduction ==

Line 8:		Line 7:
	This action can be used to define new town name styles for random games and random cities placed in the scenario editor.		This action can be used to define new town name styles for random games and random cities placed in the scenario editor.

	==Syntax==		== Syntax ==

	The data looks as follows:		The data looks as follows:
Line 36:		Line 35:
	\|}		\|}

	==Style names==		== Style names ==

	This item is only present if bit 7 is set in the ID. Its contents are in the format:		This item is only present if bit 7 is set in the ID. Its contents are in the format:

	[<langs> <name>]... 00		[<langs> <name>]... 00
Line 54:		Line 53:
	There can be any number of style names, until a literal "00" terminates the style name definition. If no appliable name is found, "(unnamed style)" will be displayed in the Options window.		There can be any number of style names, until a literal "00" terminates the style name definition. If no appliable name is found, "(unnamed style)" will be displayed in the Options window.

	The language selection works the same as the [[Action4#~~language_id~~\|action 4 language ID]], including the difference for grf version 7 and up, however bit 7 is ignored. This means that there is an ambiguity whether a value of "00" is a list terminator, or the ID of the American language. To resolve this, the first style name definition is never a list terminator (starting with 2.5 beta 4). This means that the definition of the American language name must be the first in the list. Alternatively, since bit 7 is ignored, it is valid to use the value "80" for the ID of the American language as well, but putting it first in the list is the preferred way of defining it.		The language selection works the same as the [[Action4#language id\|action 4 language ID]], including the difference for grf version 7 and up, however bit 7 is ignored. This means that there is an ambiguity whether a value of "00" is a list terminator, or the ID of the American language. To resolve this, the first style name definition is never a list terminator (starting with 2.5 beta 4). This means that the definition of the American language name must be the first in the list. Alternatively, since bit 7 is ignored, it is valid to use the value "80" for the ID of the American language as well, but putting it first in the list is the preferred way of defining it.

	==Parts==		== Parts ==

	The following fields are repeated for every part (num-parts times):		The following fields are repeated for every part (num-parts times):
Line 94:		Line 93:
	\|}		\|}

	===Notes===		=== Notes ===

	That town name styles are special since they have to be available on the title screen as well, where the graphics files aren't activated yet. This means they're processed at the initialization stage only, and can be skipped only by action 9, but doing so will prevent them from working for the rest of the game. The only way to disable a new town name style once it's loaded is to disable the entire GRF file it's situated in (by using the "New GRF status" window or by putting an exclamation mark next to the filename in newgrf(w).txt).		That town name styles are special since they have to be available on the title screen as well, where the graphics files aren't activated yet. This means they're processed at the initialization stage only, and can be skipped only by action 9, but doing so will prevent them from working for the rest of the game. The only way to disable a new town name style once it's loaded is to disable the entire GRF file it's situated in (by using the "New GRF status" window or by putting an exclamation mark next to the filename in newgrf(w).txt).

	A town name generated this way must meet some requirements to be accepted by TTD: it can't be empty (so you don't have to worry even if your chain can generate an empty string), can't be a name that's already given to a town (to avoid duplicate town names), can't be longer than 31 characters and its displayed form can't be wider than 130 pixels. If a generated name doesn't meet all these requirements, TTD tries again with a different random value. For this reason, your town name style must be able to generate at least 70 different acceptable combinations, since this is the maximum number of towns possible on a map, and TTD may deadlock if it can't find different names for every town on the map.		A town name generated this way must meet some requirements to be accepted by TTD: it can't be empty (so you don't have to worry even if your chain can generate an empty string), can't be a name that's already given to a town (to avoid duplicate town names), can't be longer than 31 characters and its displayed form can't be wider than 130 pixels. If a generated name doesn't meet all these requirements, TTD tries again with a different random value. For this reason, your town name style must be able to generate at least 70 different acceptable combinations, since this is the maximum number of towns possible on a map, and TTD may deadlock if it can't find different names for every town on the map.

	The town name style dropdown menu doesn't support more than 19 entries, and since six entries are already reserved for the old styles, only 13 remain for new styles. If there are more than 13 final style definitions available, only the first 13 will be displayed in the dropdown menu, and therefore be selectable. The other definitions will still be available (e.g. they'll show up in games started with them), but cannot be selected from the user interface.		The town name style dropdown menu doesn't support more than 19 entries, and since six entries are already reserved for the old styles, only 13 remain for new styles. If there are more than 13 final style definitions available, only the first 13 will be displayed in the dropdown menu, and therefore be selectable. The other definitions will still be available (e.g. they'll show up in games started with them), but cannot be selected from the user interface.
Line 104:		Line 103:
	If your GRF isn't available while its name style definition is used in a savegame, the town name style reverts back to German, but the towns get both English and German names; they appear in the wrong order in the town list and duplicate town names may appear. However, no data loss occurs, so the correct names are restored as soon as your definition becomes available again.		If your GRF isn't available while its name style definition is used in a savegame, the town name style reverts back to German, but the towns get both English and German names; they appear in the wrong order in the town list and duplicate town names may appear. However, no data loss occurs, so the correct names are restored as soon as your definition becomes available again.

	==Example==		== Example ==

	2 * 52 0F 80 7F "Mars" 00 00 02		2 * 52 0F 80 7F "Mars" 00 00 02
Line 111:		Line 110:
	03 "Alpha" 00 01 "Beta" 00		03 "Alpha" 00 01 "Beta" 00
	03 02 04		03 02 04
	01 " ~~Andromedæ~~" 00 01 " ~~Carinæ~~" 00 81 01		01 " Andromedæ" 00 01 " Carinæ" 00 81 01

	{\|		{\|
Line 166:		Line 165:

	\|-		\|-
	\|01 " ~~Andromedæ~~" 00 \|\|<probability>/<part>: First option for second part, probability ~1/3		\|01 " Andromedæ" 00 \|\|<probability>/<part>: First option for second part, probability ~1/3

	\|-		\|-
	\|01 " ~~Carinæ~~" 00 \|\|<probability>/<part>: Second option for second part, probability ~1/3		\|01 " Carinæ" 00 \|\|<probability>/<part>: Second option for second part, probability ~1/3

	\|-		\|-

Pm-bot: /* Example */ remove stray tiki wiki syntax

2011-06-14T23:23:41Z

Example: remove stray tiki wiki syntax

← Older revision		Revision as of 23:23, 14 June 2011
Line 106:		Line 106:
	==Example==		==Example==

	2 * 52 0F 80 7F "Mars" 00 00 02 +-		2 * 52 0F 80 7F "Mars" 00 00 02

	-+ 02 00 02+-		02 00 02
		⚫	03 "Alpha" 00 01 "Beta" 00

		⚫	03 02 04
⚫	-+ 03 "Alpha" 00 01 "Beta" 00+-
		⚫	01 " Andromedæ" 00 01 " Carinæ" 00 81 01

⚫	-+ 03 02 04+-

⚫	-+ 01 " Andromedæ" 00 01 " Carinæ" 00 81 01

	{\|		{\|

Pm-bot: Bot: Automated text replacement (--= +==)

2011-06-14T23:22:37Z

Bot: Automated text replacement (--= +==)

Show changes

Orudge: 8 revisions

2011-06-12T19:22:44Z

8 revisions

← Older revision	Revision as of 19:22, 12 June 2011
(No difference)

Orudge: 7 revisions

2011-06-12T19:02:48Z

7 revisions

← Older revision	Revision as of 19:02, 12 June 2011
(No difference)

Terkhen at 21:22, 15 December 2010

2010-12-15T21:22:46Z

← Older revision		Revision as of 21:22, 15 December 2010
Line 50:		Line 50:
	The following fields are repeated for every part (num-parts times):		The following fields are repeated for every part (num-parts times):

	<pre> -+ <textcount> <firstbit> <bitcount> <nowiki><nowiki>[ <~~probablity~~> <part/ID> ]</nowiki></nowiki>... +-</pre>		<pre> -+ <textcount> <firstbit> <bitcount> <nowiki><nowiki>[ <probability> <part/ID> ]</nowiki></nowiki>... +-</pre>

	\|\|Element\|Size\|Meaning		\|\|Element\|Size\|Meaning
Line 68:		Line 68:
	\|\|Element\|Size\|Meaning		\|\|Element\|Size\|Meaning

	~~probablity~~\|B\|The relative ~~probablity~~ of the following name to appear in the bottom 7 bits. Bit 7 decides the meaning of the following field.		probability\|B\|The relative probability of the following name to appear in the bottom 7 bits. Bit 7 decides the meaning of the following field.

	part\|S\|If bit 7 of ~~probablity~~ is clear, the following field is a null-terminated string containing a name part itself. This can be an empty string (just a plain zero byte) to avoid generating this part. (This can be useful for an optional part: give a high ~~probablity~~ to an empty part to appear, and low probablities to many non-empty parts, so you effectively decrease the chance that the part appears at all)		part\|S\|If bit 7 of probability is clear, the following field is a null-terminated string containing a name part itself. This can be an empty string (just a plain zero byte) to avoid generating this part. (This can be useful for an optional part: give a high probability to an empty part to appear, and low probablities to many non-empty parts, so you effectively decrease the chance that the part appears at all)

	ID\|B\|If bit 7 of the ~~probablity~~ is set, the following byte is an ID for an intermediate action F. The random name defined by the given ID is generated, then inserted into the current name as a name part. Specifying an ID that isn't defined yet results in an error and therefore disabling all town name definitions in the file.\|\|		ID\|B\|If bit 7 of the probability is set, the following byte is an ID for an intermediate action F. The random name defined by the given ID is generated, then inserted into the current name as a name part. Specifying an ID that isn't defined yet results in an error and therefore disabling all town name definitions in the file.\|\|

	-=Notes=-		-=Notes=-

dmccoy at 03:16, 25 July 2006

2006-07-25T03:16:49Z

New page

'''''Define new town name styles'''''

=Action F - Town names=

Define new town name styles

-=Introduction=-

This action can be used to define new town name styles for random games and random cities placed in the scenario editor.

-=Format=-

The data looks as follows:

<pre> -+<Sprite-number> * <Length> 0F <ID> <stylenames> <num-parts> <parts>...+-</pre>

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

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

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

<ID>|B|    ID of this definition in the bottom 7 bits. If bit 7 is set, this is a final definition (it will be displayed in the Options window), if it's clear, this is an intermediate definition that can be used to create more complex decision chains, see below. Final and intermediate definitions share the same 128 IDs, so 01h and 81h define the same ID for different usages, and not two separate IDs.

<style-names>|V|This is only present in final definitions, see below for the format

<num-parts>|B|How many parts this name is put together from.

<parts>|V|Data about the various parts, see below||

==Style names==

This item is only present if bit 7 is set in the ID.  Its contents are in the format:

<pre> -+<nowiki><nowiki>[<langs> <name>]</nowiki></nowiki>... 00+-</pre>

||Element|Size|Meaning

langs|B|Language ID definition, see below

name|S|Null-terminated style name to be displayed in the Options window.||

There can be any number of style names, until a literal "00" terminates the style name definition. If no appliable name is found, "(unnamed style)" will be displayed in the Options window.

The language selection works the same as the [[Action4#language_id|action 4 language ID]], including the difference for grf version 7 and up, however bit 7 is ignored. This means that there is an ambiguity whether a value of "00" is a list terminator, or the ID of the American language. To resolve this, the first style name definition is never a list terminator (starting with 2.5 beta 4). This means that the definition of the American language name must be the first in the list. Alternatively, since bit 7 is ignored, it is valid to use the value "80" for the ID of the American language as well, but putting it first in the list is the preferred way of defining it.

==Parts==

The following fields are repeated for every part (num-parts times):

<pre> -+ <textcount> <firstbit> <bitcount> <nowiki><nowiki>[ <probablity> <part/ID> ]</nowiki></nowiki>... +-</pre>

||Element|Size|Meaning

textcount|B|The number of possible values for this part

firstbit|B|Number of the lowest bit that counts for determining the value of the part

bitcount|B|How many bits are used for determining the value of this part||

Every town has 32 random bits for random naming. You can use the <firstbit> field to make the decisions for every part linearly independent, or at least as independent as possible.

The minimal number for the <bitcount> field should be the lowest power of 2 that is higher than the sum of all probabilities (e.g. 2 if the sum is <=4, 3 if it's <=8, 4 if <=16 and so on), but allowing more bits can make the distribution of decisions smoother.

The following fields are repeated for every text (textcount times) in every part:

||Element|Size|Meaning

probablity|B|The relative probablity of the following name to appear in the bottom 7 bits. Bit 7 decides the meaning of the following field.

part|S|If bit 7 of probablity is clear, the following field is a null-terminated string containing a name part itself. This can be an empty string (just a plain zero byte) to avoid generating this part. (This can be useful for an optional part: give a high probablity to an empty part to appear, and low probablities to many non-empty parts, so you effectively decrease the chance that the part appears at all)

ID|B|If bit 7 of the probablity is set, the following byte is an ID for an intermediate action F. The random name defined by the given ID is generated, then inserted into the current name as a name part. Specifying an ID that isn't defined yet results in an error and therefore disabling all town name definitions in the file.||

-=Notes=-

That town name styles are special since they have to be available on the title screen as well, where the graphics files aren't activated yet. This means they're processed at the initialization stage only, and can be skipped only by action 9, but doing so will prevent them from working for the rest of the game. The only way to disable a new town name style once it's loaded is to disable the entire GRF file it's situated in (by using the "New GRF status" window or by putting an exclamation mark next to the filename in newgrf(w).txt).

A town name generated this way must meet some requirements to be accepted by TTD: it can't be empty (so you don't have to worry even if your chain can generate an empty string), can't be a name that's already given to a town (to avoid duplicate town names),  can't be longer than 31 characters and its displayed form can't be wider than 130 pixels. If a generated name doesn't meet all these requirements, TTD tries again with a different random value. For this reason, your town name style must be able to generate at least 70 different acceptable combinations, since this is the maximum number of towns possible on a map, and TTD may deadlock if it can't find different names for every town on the map.

The town name style dropdown menu doesn't support more than 19 entries, and since six entries are already reserved for the old styles, only 13 remain for new styles. If there are more than 13 final style definitions available, only the first 13 will be displayed in the dropdown menu, and therefore be selectable. The other definitions will still be available (e.g. they'll show up in games started with them), but cannot be selected from the user interface.

If your GRF isn't available while its name style definition is used in a savegame, the town name style reverts back to German, but the towns get both English and German names; they appear in the wrong order in the town list and duplicate town names may appear. However, no data loss occurs, so the correct names are restored as soon as your definition becomes available again.

-=Example=-

<pre> -+ 2 * 52 0F 80 7F "Mars" 00 00 02 +-

-+ 02 00 02+-

-+     03 "Alpha" 00 01 "Beta" 00+-

-+ 03 02 04+-

-+     01 " Andromedæ" 00 01 " Carinæ" 00 81 01 +- </pre>

||Byte(s)|Meaning

0F|Action F

80|<ID> Final definition; show in town-name list.

7F|<lang-id>: Name for all languages follows

"Mars" 00|Style name

00|End of style names

02|<num-parts>: Two <parts> fields follow:

'''First <parts> field:'''

02|<textcount>: two options for this part.

00|<firstbit>: start with bit 0, and

02|<bitcount>: use two bits (sum of probabilities is 04; minimum number of bits is 2)

03|<probability> (probability is 3/4)

"Alpha" 00|<part>: First option for first part

01 "Beta" 00|<probability>/<part>: Second option for first part, probability 1/4

'''Second <parts> field:'''

03|<textcount>: three options for this part:

02|<firstbit>: start with bit 2, and

04|<bitcount>: use four bits (sum of probabilities is 3; minimum number of bits is 2)

01 " Andromedæ" 00 |<probability>/<part>: First option for second part, probability ~1/3

01 " Carinæ" 00 |<probability>/<part>: Second option for second part, probability ~1/3

81 01|<probability>/<ID>: Third option, chain to the action F with ID 01, probability ~1/3||

Notes:
# ID 01 (and any Action F's chained to by ID 01 should all have <firstbit>s of 06 or higher, since bits 00..05 were used by ID 00, and if they are used again, the decision will be related to the decision in ID 00.
# Unless ID 01 produces at least 33 (dec) different strings, this will not provide a sufficient number of town names.
# The second <parts> uses four bits; the probabilities for each <part> are 5/16, 5/16, and 6/16, which are reasonably close to 1/3, and far better than the 1/4, 1/4, 1/2 that would have resulted if only two bits had been used. There is no reliable determination of which <part> will get the extra probability; if you want to know for certain which will have the extra probability, code the action F so that some <part>s have a higher or lower probability than the others.
# The <probability>/<ID> pair 81 01 could also chain to the action F with ID 81, but this is probably not a desirable result.