1

#ifndef PNGTILE_CACHE_H

     2

#define PNGTILE_CACHE_H

     3

     4

/**

     5

 * @file

     6

 *

     7

 * Internal image cache implementation

     8

 */

     9

#include "image.h"

    10

    11

#include <stdint.h>

    12

#include <stdbool.h>

    13

    14

#include <png.h>

    15

    16

/**

    17

 * State for cache access

    18

 */

    19

struct pt_cache {

    20

    /** Filesystem path to cache file */

    21

    char *path;

    22

    23

    /** The mode we are operating in, bitmask of PT_IMG_* */

    24

    int mode;

    25

    26

    /** Opened file */

    27

    int fd;

    28

    29

    /** The mmap'd header */

    30

    struct pt_cache_header *header;

    31

    32

    /** Memory-mapped file data, starting at PT_CACHE_HEADER_SIZE */

    33

    uint8_t *data;

    34

    35

    /** Size of the data segment in bytes, starting at PT_CACHE_HEADER_SIZE */

    36

    size_t size;

    37

};

    38

    39

/**

    40

 * Size used to store the cache header

    41

 */

    42

#define PT_CACHE_HEADER_SIZE 4096

    43

    44

/**

    45

 * On-disk header

    46

 */

    47

struct pt_cache_header {

    48

    /** Pixel dimensions of image */

    49

    uint32_t width, height;

    50

    51

    /** Pixel format */

    52

    uint8_t bit_depth, color_type;

    53

    54

    /** Number of png_color entries that follow */

    55

    uint16_t num_palette;

    56

    58

    uint32_t row_bytes;

    59

    60

    /** Number of bytes per pixel */

    61

    uint8_t col_bytes;

    62

    63

    /** Palette entries, up to 256 entries used */

    64

    png_color palette[PNG_MAX_PALETTE_LENGTH];

    65

};

    66

    67

/**

    68

 * Construct the image cache info object associated with the given image.

    69

 */

    70

int pt_cache_new (struct pt_cache **cache_ptr, const char *path, int mode);

    71

    72

/**

    73

 * Verify if the cached data eixsts, or has become stale compared to the given original file.

    74

 *

    75

 * @return one of pt_cache_status; <0 on error, 0 if fresh, >0 otherwise

    76

 */

    77

int pt_cache_status (struct pt_cache *cache, const char *img_path);

    78

    79

/**

    80

 * Get info for the cached image, open it if not already open.

    81

 */

    82

int pt_cache_info (struct pt_cache *cache, struct pt_image_info *info);

    83

    84

/**

    85

 * Update the cache data from the given PNG image.

    86

 */

    87

int pt_cache_update_png (struct pt_cache *cache, png_structp png, png_infop info);

    88

    89

/**

    90

 * Open the existing .cache for use. If already opened, does nothing.

    91

 */

    92

int pt_cache_open (struct pt_cache *cache);

    93

    94

/**

    95

 * Render out a PNG tile as given, into the established png object, up to (but not including) the png_write_end.

    96

 *

    97

 * If the cache is not yet open, this will open it

    98

 */

    99

int pt_cache_tile_png (struct pt_cache *cache, png_structp png, png_infop info, const struct pt_tile_info *ti);

   100

   101

/**

   102

 * Release all resources associated with the given cache object without any cleanup.

   103

 */

   104

void pt_cache_destroy (struct pt_cache *cache);

   105

   106

#endif