1

/* $Id$ */

     2

     3

/** @file heightmap.h Functions related to creating heightmaps from files. */

     4

     5

#ifndef HEIGHTMAP_H

     6

#define HEIGHTMAP_H

     7

     8

/*

     9

 * Order of these enums has to be the same as in lang/english.txt

    10

 * Otherwise you will get inconsistent behaviour.

    11

 */

    12

enum {

    13

	HM_COUNTER_CLOCKWISE, ///< Rotate the map counter clockwise 45 degrees

    14

	HM_CLOCKWISE,         ///< Rotate the map clockwise 45 degrees

    15

};

    16

    17

/**

    18

 * Get the dimensions of a heightmap.

    19

 * @param filename to query

    20

 * @param x dimension x

    21

 * @param y dimension y

    22

 * @return Returns false if loading of the image failed.

    23

 */

    24

bool GetHeightmapDimensions(char *filename, uint *x, uint *y);

    25

    26

/**

    27

 * Load a heightmap from file and change the map in his current dimensions

    28

 *  to a landscape representing the heightmap.

    29

 * It converts pixels to height. The brighter, the higher.

    30

 * @param filename of the heighmap file to be imported

    31

 */

    32

void LoadHeightmap(char *filename);

    33

    34

/**

    35

 * Make an empty world where all tiles are of height 'tile_height'.

    36

 * @param tile_height of the desired new empty world

    37

 */

    38

void FlatEmptyWorld(byte tile_height);

    39

    40

#endif /* HEIGHTMAP_H */