libgen - Liquid War 6
Description: Liquid War 6

Next: libgfx, Previous: libdyn, Up: C API

### 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.