OpenTTD

Data Structures | Typedefs | Functions | Variables
townname.cpp File Reference

Town name generators. More...

`#include "stdafx.h"`
`#include "string_func.h"`
`#include "townname_type.h"`
`#include "town.h"`
`#include "strings_func.h"`
`#include "core/random_func.hpp"`
`#include "genworld.h"`
`#include "gfx_layout.h"`
`#include "table/townname.h"`
`#include "safeguards.h"`

Go to the source code of this file.

## Data Structures
struct | TownNameGeneratorParams
| Contains pointer to generator and minimum buffer size (not incl. More...

## Typedefs
typedef char * | TownNameGenerator(char *buf, const char *last, uint32 seed)
| Type for all town name generator functions. More...

## Functions
char * | GetTownName (char *buff, const TownNameParams *par, uint32 townnameparts, const char *last)
| Fills buffer with specified town name. More...
char * | GetTownName (char *buff, const Town *t, const char *last)
| Fills buffer with town's name. More...
bool | VerifyTownName (uint32 r, const TownNameParams *par, TownNames *town_names)
| Verifies the town name is valid and unique. More...
bool | GenerateTownName (uint32 *townnameparts, TownNames *town_names)
| Generates valid town name. More...
static uint32 | SeedChance (byte shift_by, int max, uint32 seed)
| Generates a number from given seed. More...
static uint32 | SeedModChance (byte shift_by, int max, uint32 seed)
| Generates a number from given seed. More...
static int32 | SeedChanceBias (byte shift_by, int max, uint32 seed, int bias)
| Generates a number from given seed. More...
static void | ReplaceWords (const char *org, const char *rep, char *buf)
| Replaces a string beginning in 'org' with 'rep'. More...
static void | ReplaceEnglishWords (char *buf, bool original)
| Replaces english curses and ugly letter combinations by nicer ones. More...
static char * | MakeEnglishOriginalTownName (char *buf, const char *last, uint32 seed)
| Generates English (Original) town name from given seed. More...
static char * | MakeEnglishAdditionalTownName (char *buf, const char *last, uint32 seed)
| Generates English (Additional) town name from given seed. More...
static char * | MakeAustrianTownName (char *buf, const char *last, uint32 seed)
| Generates Austrian town name from given seed. More...
static char * | MakeGermanTownName (char *buf, const char *last, uint32 seed)
| Generates German town name from given seed. More...
static char * | MakeSpanishTownName (char *buf, const char *last, uint32 seed)
| Generates Latin-American town name from given seed. More...
static char * | MakeFrenchTownName (char *buf, const char *last, uint32 seed)
| Generates French town name from given seed. More...
static char * | MakeSillyTownName (char *buf, const char *last, uint32 seed)
| Generates Silly town name from given seed. More...
static char * | MakeSwedishTownName (char *buf, const char *last, uint32 seed)
| Generates Swedish town name from given seed. More...
static char * | MakeDutchTownName (char *buf, const char *last, uint32 seed)
| Generates Dutch town name from given seed. More...
static char * | MakeFinnishTownName (char *buf, const char *last, uint32 seed)
| Generates Finnish town name from given seed. More...
static char * | MakePolishTownName (char *buf, const char *last, uint32 seed)
| Generates Polish town name from given seed. More...
static char * | MakeCzechTownName (char *buf, const char *last, uint32 seed)
| Generates Czech town name from given seed. More...
static char * | MakeRomanianTownName (char *buf, const char *last, uint32 seed)
| Generates Romanian town name from given seed. More...
static char * | MakeSlovakTownName (char *buf, const char *last, uint32 seed)
| Generates Slovak town name from given seed. More...
static char * | MakeNorwegianTownName (char *buf, const char *last, uint32 seed)
| Generates Norwegian town name from given seed. More...
static char * | MakeHungarianTownName (char *buf, const char *last, uint32 seed)
| Generates Hungarian town name from given seed. More...
static char * | MakeSwissTownName (char *buf, const char *last, uint32 seed)
| Generates Swiss town name from given seed. More...
static char * | MakeDanishTownName (char *buf, const char *last, uint32 seed)
| Generates Danish town name from given seed. More...
static char * | MakeTurkishTownName (char *buf, const char *last, uint32 seed)
| Generates Turkish town name from given seed. More...
static char * | MakeItalianTownName (char *buf, const char *last, uint32 seed)
| Generates Italian town name from given seed. More...
static char * | MakeCatalanTownName (char *buf, const char *last, uint32 seed)
| Generates Catalan town name from given seed. More...
char * | GenerateTownNameString (char *buf, const char *last, size_t lang, uint32 seed)
| Generates town name from given seed. More...

## Variables
static const TownNameGeneratorParams | _town_name_generators []
| Town name generators. More...

## Detailed Description

Town name generators.

Definition in file townname.cpp.

## Typedef Documentation

## ◆ TownNameGenerator

typedef char* TownNameGenerator(char *buf, const char *last, uint32 seed)

Type for all town name generator functions.

Parameters

  buf | The buffer to write the name to.
  last | The last element of the buffer.
  seed | The seed of the town name.

Returns
  The end of the filled buffer.

Definition at line 1013 of file townname.cpp.

## Function Documentation

## ◆ GenerateTownName()

bool GenerateTownName | ( | uint32 * | townnameparts,
|  | TownNames * | town_names
| ) |  |

Generates valid town name.

Parameters

  townnameparts | if a name is generated, it's stored there
  town_names | if a name is generated, check its uniqueness with the set

Returns
  true iff a name was generated

Definition at line 122 of file townname.cpp.

References _generating_world, _settings_game, GameSettings::game_creation, Layouter::ReduceLineCache(), and GameCreationSettings::town_name.

## ◆ GenerateTownNameString()

char* GenerateTownNameString | ( | char * | buf,
|  | const char * | last,
|  | size_t | lang,
|  | uint32 | seed
| ) |  |

Generates town name from given seed.

a language.

Parameters

  buf | output buffer
  last | end of buffer
  lang | town name language
  seed | generation seed

Returns
  last character ('/0')

Definition at line 1055 of file townname.cpp.

## ◆ GetTownName() [1/2]

char* GetTownName | ( | char * | buff,
|  | const TownNameParams * | par,
|  | uint32 | townnameparts,
|  | const char * | last
| ) |  |

Fills buffer with specified town name.

Parameters

  buff | buffer start
  par | town name parameters
  townnameparts | 'encoded' town name
  last | end of buffer

Returns
  pointer to terminating '\0'

Definition at line 51 of file townname.cpp.

References GetStringWithArgs(), TownNameParams::grfid, and TownNameParams::type.

Referenced by GetTownName(), and VerifyTownName().

## ◆ GetTownName() [2/2]

char* GetTownName | ( | char * | buff,
|  | const Town * | t,
|  | const char * | last
| ) |  |

Fills buffer with town's name.

Parameters

  buff | buffer start
  t | we want to get name of this town
  last | end of buffer

Returns
  pointer to terminating '\0'

Definition at line 70 of file townname.cpp.

References GetTownName().

## ◆ MakeAustrianTownName()

static char* MakeAustrianTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Austrian town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 310 of file townname.cpp.

References lengthof, and SeedChanceBias().

## ◆ MakeCatalanTownName()

static char* MakeCatalanTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Catalan town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 975 of file townname.cpp.

References SeedModChance(), and strecpy().

## ◆ MakeCzechTownName()

static char* MakeCzechTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Czech town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 599 of file townname.cpp.

References SeedModChance(), and strecpy().

## ◆ MakeDanishTownName()

static char* MakeDanishTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Danish town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 870 of file townname.cpp.

References lengthof, and SeedChanceBias().

## ◆ MakeDutchTownName()

static char* MakeDutchTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Dutch town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 463 of file townname.cpp.

References lengthof, and SeedChanceBias().

## ◆ MakeEnglishAdditionalTownName()

static char* MakeEnglishAdditionalTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates English (Additional) town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 271 of file townname.cpp.

References lengthof, and SeedChanceBias().

## ◆ MakeEnglishOriginalTownName()

static char* MakeEnglishOriginalTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates English (Original) town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 235 of file townname.cpp.

References lengthof, and SeedChanceBias().

## ◆ MakeFinnishTownName()

static char* MakeFinnishTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Finnish town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 489 of file townname.cpp.

References SeedChance(), and strecpy().

## ◆ MakeFrenchTownName()

static char* MakeFrenchTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates French town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 409 of file townname.cpp.

References strecpy().

## ◆ MakeGermanTownName()

static char* MakeGermanTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates German town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 354 of file townname.cpp.

References lengthof, and SeedChance().

## ◆ MakeHungarianTownName()

static char* MakeHungarianTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Hungarian town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 828 of file townname.cpp.

References SeedChance(), and strecpy().

## ◆ MakeItalianTownName()

static char* MakeItalianTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Italian town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 927 of file townname.cpp.

References SeedModChance(), and strecpy().

## ◆ MakeNorwegianTownName()

static char* MakeNorwegianTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Norwegian town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 804 of file townname.cpp.

References SeedChance(), and strecpy().

## ◆ MakePolishTownName()

static char* MakePolishTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Polish town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 537 of file townname.cpp.

References lengthof, and SeedChance().

## ◆ MakeRomanianTownName()

static char* MakeRomanianTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Romanian town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 780 of file townname.cpp.

References strecpy().

## ◆ MakeSillyTownName()

static char* MakeSillyTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Silly town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 421 of file townname.cpp.

References strecpy().

## ◆ MakeSlovakTownName()

static char* MakeSlovakTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Slovak town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 792 of file townname.cpp.

References strecpy().

## ◆ MakeSpanishTownName()

static char* MakeSpanishTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Latin-American town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 397 of file townname.cpp.

References strecpy().

## ◆ MakeSwedishTownName()

static char* MakeSwedishTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Swedish town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 436 of file townname.cpp.

References lengthof, and SeedChanceBias().

## ◆ MakeSwissTownName()

static char* MakeSwissTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Swiss town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 858 of file townname.cpp.

References strecpy().

## ◆ MakeTurkishTownName()

static char* MakeTurkishTownName | ( | char * | buf,
|  | const char * | last,
|  | uint32 | seed
| ) |  |
| static

Generates Turkish town name from given seed.

Parameters

  buf | output buffer
  seed | town name seed
  last | end of buffer

Definition at line 890 of file townname.cpp.

References SeedModChance(), and strecpy().

## ◆ ReplaceEnglishWords()

static void ReplaceEnglishWords | ( | char * | buf,
|  | bool | original
| ) |  |
| static

Replaces english curses and ugly letter combinations by nicer ones.

Parameters

  buf | buffer with town name
  original | English (Original) generator was used

Definition at line 215 of file townname.cpp.

References ReplaceWords().

## ◆ ReplaceWords()

static void ReplaceWords | ( | const char * | org,
|  | const char * | rep,
|  | char * | buf
| ) |  |
| static

Replaces a string beginning in 'org' with 'rep'.

Parameters

  org | string to replace, has to be 4 characters long
  rep | string to be replaced with, has to be 4 characters long
  buf | buffer with string

Definition at line 203 of file townname.cpp.

Referenced by ReplaceEnglishWords().

## ◆ SeedChance()

static uint32 SeedChance | ( | byte | shift_by,
|  | int | max,
|  | uint32 | seed
| ) |  |
| inline static

Generates a number from given seed.

Parameters

  shift_by | number of bits seed is shifted to the right
  max | generated number is in interval 0...max-1
  seed | seed

Returns
  seed transformed to a number from given range

Definition at line 155 of file townname.cpp.

References GB().

Referenced by MakeFinnishTownName(), MakeGermanTownName(), MakeHungarianTownName(), MakeNorwegianTownName(), MakePolishTownName(), and SeedChanceBias().

## ◆ SeedChanceBias()

static int32 SeedChanceBias | ( | byte | shift_by,
|  | int | max,
|  | uint32 | seed,
|  | int | bias
| ) |  |
| inline static

Generates a number from given seed.

Parameters

  shift_by | number of bits seed is shifted to the right
  max | generated number is in interval -bias...max-1
  seed | seed
  bias | minimum value that can be returned

Returns
  seed transformed to a number from given range

Definition at line 191 of file townname.cpp.

References SeedChance().

Referenced by MakeAustrianTownName(), MakeDanishTownName(), MakeDutchTownName(), MakeEnglishAdditionalTownName(), MakeEnglishOriginalTownName(), and MakeSwedishTownName().

## ◆ SeedModChance()

static uint32 SeedModChance | ( | byte | shift_by,
|  | int | max,
|  | uint32 | seed
| ) |  |
| inline static

Generates a number from given seed.

Uses different algorithm than SeedChance().

Parameters

  shift_by | number of bits seed is shifted to the right
  max | generated number is in interval 0...max-1
  seed | seed

Returns
  seed transformed to a number from given range

Definition at line 168 of file townname.cpp.

References max().

Referenced by MakeCatalanTownName(), MakeCzechTownName(), MakeItalianTownName(), and MakeTurkishTownName().

## ◆ VerifyTownName()

bool VerifyTownName | ( | uint32 | r,
|  | const TownNameParams * | par,
|  | TownNames * | town_names
| ) |  |

Verifies the town name is valid and unique.

Parameters

  r | random bits
  par | town name parameters
  town_names | if a name is generated, check its uniqueness with the set

Returns
  true iff name is valid and unique

Definition at line 84 of file townname.cpp.

References GetTownName(), lastof, MAX_CHAR_LENGTH, MAX_LENGTH_TOWN_NAME_CHARS, and Utf8StringLength().

## Variable Documentation

## ◆ _town_name_generators

const TownNameGeneratorParams _town_name_generators[]
| static

Initial value:
= {
{ 4, MakeEnglishOriginalTownName},
{ 0, MakeFrenchTownName},
{ 0, MakeGermanTownName},
{ 4, MakeEnglishAdditionalTownName},
{ 0, MakeSpanishTownName},
{ 0, MakeSillyTownName},
{ 0, MakeSwedishTownName},
{ 0, MakeDutchTownName},
{ 8, MakeFinnishTownName},
{ 0, MakePolishTownName},
{ 0, MakeSlovakTownName},
{ 0, MakeNorwegianTownName},
{ 0, MakeHungarianTownName},
{ 0, MakeAustrianTownName},
{ 0, MakeRomanianTownName},
{ 28, MakeCzechTownName},
{ 0, MakeSwissTownName},
{ 0, MakeDanishTownName},
{ 0, MakeTurkishTownName},
{ 0, MakeItalianTownName},
{ 0, MakeCatalanTownName},
}
MakeDanishTownName
static char * MakeDanishTownName(char *buf, const char *last, uint32 seed)
Generates Danish town name from given seed.
Definition: townname.cpp:870
MakeHungarianTownName
static char * MakeHungarianTownName(char *buf, const char *last, uint32 seed)
Generates Hungarian town name from given seed.
Definition: townname.cpp:828
MakePolishTownName
static char * MakePolishTownName(char *buf, const char *last, uint32 seed)
Generates Polish town name from given seed.
Definition: townname.cpp:537
MakeDutchTownName
static char * MakeDutchTownName(char *buf, const char *last, uint32 seed)
Generates Dutch town name from given seed.
Definition: townname.cpp:463
MakeCatalanTownName
static char * MakeCatalanTownName(char *buf, const char *last, uint32 seed)
Generates Catalan town name from given seed.
Definition: townname.cpp:975
MakeRomanianTownName
static char * MakeRomanianTownName(char *buf, const char *last, uint32 seed)
Generates Romanian town name from given seed.
Definition: townname.cpp:780
MakeItalianTownName
static char * MakeItalianTownName(char *buf, const char *last, uint32 seed)
Generates Italian town name from given seed.
Definition: townname.cpp:927
MakeSlovakTownName
static char * MakeSlovakTownName(char *buf, const char *last, uint32 seed)
Generates Slovak town name from given seed.
Definition: townname.cpp:792
MakeAustrianTownName
static char * MakeAustrianTownName(char *buf, const char *last, uint32 seed)
Generates Austrian town name from given seed.
Definition: townname.cpp:310
MakeSwissTownName
static char * MakeSwissTownName(char *buf, const char *last, uint32 seed)
Generates Swiss town name from given seed.
Definition: townname.cpp:858
MakeEnglishOriginalTownName
static char * MakeEnglishOriginalTownName(char *buf, const char *last, uint32 seed)
Generates English (Original) town name from given seed.
Definition: townname.cpp:235
MakeGermanTownName
static char * MakeGermanTownName(char *buf, const char *last, uint32 seed)
Generates German town name from given seed.
Definition: townname.cpp:354
MakeSpanishTownName
static char * MakeSpanishTownName(char *buf, const char *last, uint32 seed)
Generates Latin-American town name from given seed.
Definition: townname.cpp:397
MakeSillyTownName
static char * MakeSillyTownName(char *buf, const char *last, uint32 seed)
Generates Silly town name from given seed.
Definition: townname.cpp:421
MakeSwedishTownName
static char * MakeSwedishTownName(char *buf, const char *last, uint32 seed)
Generates Swedish town name from given seed.
Definition: townname.cpp:436
MakeEnglishAdditionalTownName
static char * MakeEnglishAdditionalTownName(char *buf, const char *last, uint32 seed)
Generates English (Additional) town name from given seed.
Definition: townname.cpp:271
MakeCzechTownName
static char * MakeCzechTownName(char *buf, const char *last, uint32 seed)
Generates Czech town name from given seed.
Definition: townname.cpp:599
MakeFinnishTownName
static char * MakeFinnishTownName(char *buf, const char *last, uint32 seed)
Generates Finnish town name from given seed.
Definition: townname.cpp:489
MakeFrenchTownName
static char * MakeFrenchTownName(char *buf, const char *last, uint32 seed)
Generates French town name from given seed.
Definition: townname.cpp:409
MakeNorwegianTownName
static char * MakeNorwegianTownName(char *buf, const char *last, uint32 seed)
Generates Norwegian town name from given seed.
Definition: townname.cpp:804
MakeTurkishTownName
static char * MakeTurkishTownName(char *buf, const char *last, uint32 seed)
Generates Turkish town name from given seed.
Definition: townname.cpp:890

Town name generators.

Definition at line 1022 of file townname.cpp.