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

    /** Memory-mapped file data, from the second page on */

    30

    uint8_t *mmap;

    31

    32

    /** Size of the mmap'd segment in bytes */

    33

    size_t size;

    34

};

    35

    36

/**

    37

 * Size of a cache file page in bytes

    38

 */

    39

#define PT_CACHE_PAGE 4096

    40

    41

/**

    42

 * On-disk header

    43

 */

    44

struct pt_cache_header {

    45

    /** Pixel dimensions of image */

    46

    uint32_t width, height;

    47

    48

    /** Pixel format */

    49

    uint8_t bit_depth, color_type;

    50

    54

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

    55

    uint32_t row_bytes;

    59

};

    60

    61

/**

    62

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

    63

 */

    64

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

    65

    66

/**

    67

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

    68

 */

    69

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

    70

    71

/**

    72

 * Update the cache data from the given PNG image.

    73

 */

    74

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

    75

    76

/**

    77

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

    78

 */

    79

void pt_cache_destroy (struct pt_cache *cache);

    80

    81

#endif