1

#ifndef PNGTILE_TILE_H

     2

#define PNGTILE_TILE_H

     3

     4

/**

     5

 * @file

     6

 * Generating PNG tiles from a cache

     7

 */

     8

     9

struct pt_tile;

    10

    11

#include "pngtile.h"

    12

#include "cache.h"

    13

    14

/** Types of tile output */

    15

enum pt_tile_output { 

    16

    PT_TILE_OUT_FILE,

    17

    PT_TILE_OUT_MEM,

    18

};

    19

    20

/** Initial size of out.mem.base, 16k */

    21

#define PT_TILE_BUF_SIZE (16 * 1024)

    22

    23

    24

    25

/** Per-tile-render state */

    26

struct pt_tile {

    27

    /** Cache to render from */

    28

    struct pt_cache *cache;

    29

    30

    /** Render spec */

    31

    struct pt_tile_info info;

    32

    33

    /** Output type */

    34

    enum pt_tile_output out_type;

    35

    36

    union {

    37

        /** Output file */

    38

        FILE *file;

    39

    40

        /** Output buffer */

    41

        struct pt_tile_mem {

    42

            char *base;

    43

            size_t off, len;

    44

        } mem;

    45

    } out;

    46

};

    47

    48

/**

    49

 * Write to the tile's output buffer

    50

 */

    51

int pt_tile_mem_write (struct pt_tile_mem *buf, void *data, size_t len);

    52

    53

    54

/**

    55

 * Alloc a new pt_tile, which must be initialized using pt_tile_init_*

    56

 */

    57

int pt_tile_new (struct pt_tile **tile_ptr);

    58

    59

/**

    60

 * Initialize to render with given params, writing output to given FILE*

    61

 */

    62

int pt_tile_init_file (struct pt_tile *tile, struct pt_cache *cache, const struct pt_tile_info *info, FILE *out);

    63

    64

/**

    65

 * Initialize to render with given params, writing output to a memory buffer

    66

 */

    67

int pt_tile_init_mem (struct pt_tile *tile, struct pt_cache *cache, const struct pt_tile_info *info);

    68

    69

/**

    70

 * Render PNG data from given cache according to parameters given to pt_tile_init_*

    71

 */

    72

int pt_tile_render (struct pt_tile *tile);

    73

    74

/**

    75

 * Abort any failed render process, cleaning up.

    76

 */

    77

void pt_tile_abort (struct pt_tile *tile);

    78

    79

/**

    80

 * Destroy given pt_tile, aborting it and freeing it

    81

 */

    82

void pt_tile_destroy (struct pt_tile *tile);

    83

    84

#endif