1

#ifndef RENDER_PNG_H

     2

#define RENDER_PNG_H

     3

     4

#include "render.h"

     5

     6

/*

     7

 * For rendering PNG images

     8

 */

     9

struct render_png;

    10

    11

/*

    12

 * Build and return a render_png that can be used to render a PNG of the given struct render.

    13

 *

    14

 * The dimensions of the PNG image will be read from render. If render's I/O 

    15

 * was set using render_io_stream, then the PNG data will be written to that

    16

 * stream. If it was set using render_io_custom, then the write_fn will be

    17

 * called with chunks of PNG data, and flush_fn from time to time as a hint to

    18

 * flush the data, but this may be omitted.

    19

 *

    20

 * returns NULL on failure.

    21

 */

    22

struct render_png *render_png_alloc (struct render *render);

    23

    24

/*

    25

 * Feed a full row of raw pixel data into the PNG image.

    26

 *

    27

 * buf must be render.img_w bytes wide.

    28

 */

    29

int render_png_row (struct render_png *ctx, unsigned char *rowbuf);

    30

    31

/*

    32

 * Mark the render as complete and free the render_png, flushing out any remaining data.

    33

 */

    34

int render_png_done (struct render_png *ctx);

    35

    36

/*

    37

 * Abort the render, free the render_png, and discard any remaining data.

    38

 */

    39

int render_png_abort (struct render_png *ctx);

    40

    41

#endif /* RENDER_PNG_H */