1

#ifndef PNGTILE_TILE_H

     2

#define PNGTILE_TILE_H

     3

     4

/**

     5

 * Generating PNG tiles from a cache

     6

 */

     7

#include "pngtile.h"

     8

#include "cache.h"

     9

    10

/** Types of tile output */

    11

enum pt_tile_output { 

    12

    PT_TILE_OUT_FILE,

    13

    PT_TILE_OUT_MEM,

    14

};

    15

    16

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

    17

#define PT_TILE_BUF_SIZE (16 * 1024)

    18

    19

    20

    21

/** Per-tile-render state */

    22

struct pt_tile {

    23

    /** Cache to render from */

    24

    struct pt_cache *cache;

    25

    26

    /** Render spec */

    27

    struct pt_tile_info info;

    28

    29

    /** Output type */

    30

    enum pt_tile_output out_type;

    31

    32

    union {

    33

        /** Output file */

    34

        FILE *file;

    35

    36

        /** Output buffer */

    37

        struct pt_tile_mem {

    38

            char *base;

    39

            size_t off, len;

    40

        } mem;

    41

    } out;

    42

};

    43

    44

/**

    45

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

    46

 */

    47

int pt_tile_new (struct pt_tile **tile_ptr);

    48

    49

/**

    50

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

    51

 */

    52

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

    53

    54

/**

    55

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

    56

 */

    57

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

    58

    59

/**

    60

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

    61

 */

    62

int pt_tile_render (struct pt_tile *tile);

    63

    64

/**

    65

 * Abort any failed render process, cleaning up.

    66

 */

    67

void pt_tile_abort (struct pt_tile *tile);

    68

    69

/**

    70

 * Destroy given pt_tile, aborting it and freeing it

    71

 */

    72

void pt_tile_destroy (struct pt_tile *tile);

    73

    74

#endif