Next: libgfx, Previous: libdyn, Up: C API [Contents][Index]

### 5.18 libgen

#### 5.18.1 Overview

View lcov test coverage results on http://www.ufoot.org/liquidwar/v6/doc/coverage/src/lib/gen/index.html.

#### 5.18.2 API

Function: lw6map_level_t * lw6gen_create_from_seed (const char * seed, int map_w, int map_h)

  seed: a random seed used to generate the map

  map_w: width of the screen, in pixels

  map_h: height of the screen, in pixels

  Builds a complete, usable map from the string passed in seed. Each triplet composed of seed/map_w/map_h should build the same map on any computer, in any context, for a given version of the game (no backwards compatibility).

  Return value: new map on success, NULL on failure.

Function: char * lw6gen_seed_new ()

  Generate a new random seed. The seed is composed of letters and numbers.

  Return value: newly allocated string.

Function: char * lw6gen_seed_normalize (const char * seed)

  seed: the seed to normalize

  Builds a normalized seed from an arbitrary string. The idea is to avoid sending strange stuff on the network and/or storing strange stuff in config files, so we process correct strings only

  Return value: newly allocated string.

Function: char lw6gen_seed_char ()

  Returns a random char suitable for seed (letter or digit).

  Return value: a single char

Function: int lw6gen_test_register (int mode)

  mode: test mode (bitmask)

  Registers all tests for the libgen module.

  Return value: 1 if test is successfull, 0 on error.

Function: int lw6gen_test_run (int mode)

  mode: test mode (bitmask)

  Runs the `gen` module test suite, testing most (if not all...) functions.

  Return value: 1 if test is successfull, 0 on error.

Next: libgfx, Previous: libdyn, Up: C API [Contents][Index]