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

    31

    36

    size_t size;

    37

};

    38

    39

/**

    41

 */

    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

    57

    /** Convenience field for number of bytes per row */

    58

    uint32_t row_bytes;

    59

    60

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

    61

    png_color palette[PNG_MAX_PALETTE_LENGTH];

    62

};

    63

    64

/**

    65

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

    66

 */

    67

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

    68

    69

/**

    70

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

    71

 */

    72

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

    73

    74

/**

    75

 * Update the cache data from the given PNG image.

    76

 */

    77

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

    78

    79

/**

    80

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

    81

 */

    82

void pt_cache_destroy (struct pt_cache *cache);

    83

    84

#endif