1

#ifndef RENDER_H

     2

#define RENDER_H

     3

     4

#include <sys/types.h>

     5

#include <stdio.h>

     6

     7

/*

     8

 * This module provides various ways to render mandelbrot images in various formats

     9

 */

    10

    11

/*

    12

 * Custom callbacks

    13

 *

    14

 * These should return non-zero on error, whereupon the rendering will be aborted, or zero on success

    15

 */

    16

typedef int (*render_ctx_write_cb)(const unsigned char *data, size_t length, void *arg);

    17

typedef int (*render_ctx_flush_cb)(void *arg);

    18

typedef int (*render_ctx_row_cb)(void *arg, unsigned char *rowbuf);

    19

typedef int (*render_ctx_done_cb)(void *arg);

    20

    21

// include render_internal.h first if you need it

    22

struct render;

    23

    24

// output types

    25

enum {

    26

    RENDER_RAW,     // raw pixel data

    27

    RENDER_PNG,     // a png image

    28

};

    29

    30

/*

    31

 * Alloc a new render context

    32

 */

    33

struct render *render_alloc ();

    34

void render_free(struct render *ctx);

    35

    36

/*

    37

 * Clear out the value of the given render context

    38

 */

    39

int render_init (struct render *ctx);

    40

    41

/*

    42

 * What kind of image to render, PNG or RAW?

    43

 */

    44

int render_set_mode (struct render *ctx, int mode);

    45

    46

/*

    47

 * What size of image to render

    48

 */

    49

int render_set_size (struct render *ctx, u_int32_t img_w, u_int32_t img_h);

    50

int render_get_size (struct render *ctx, u_int32_t *img_w, u_int32_t *img_h);

    51

    52

/*

    53

 * Select what region to render

    54

 */

    55

    56

// the "full" mandelbrot region

    57

#define REGION_X1 -2.0

    58

#define REGION_Y1 -1.5

    59

#define REGION_X2 1.0

    60

#define REGION_Y2 1.5

    61

    62

#define REGION_W (REGION_X2 - REGION_X1)

    63

#define REGION_H (REGION_Y2 - REGION_Y1)

    64

    65

int render_region_full (struct render *ctx);

    66

int render_region_raw (struct render *ctx, double x1, double y1, double x2, double y2);

    67

    68

/*

    69

 * Render raw pixel data directly to local memory.

    70

 *

    71

 * rowbuf_addr should point to a memory address that the mandelbrot will be

    72

 * rendered into. This memory address should have room for <img_w> bytes.

    73

 *

    74

 * row_fn will be called after each row has been written, passing in arg and

    75

 * *rowbuf_addr as arguments.

    76

 * 

    77

 */

    78

int render_local_mem (struct render *ctx, unsigned char **rowbuf_addr, render_ctx_row_cb row_fn, void *arg);

    79

    80

/*

    81

 * How to handle the I/O

    82

 */

    83

int render_io_custom (struct render *ctx, render_ctx_write_cb write_fn, render_ctx_flush_cb flush_fn, void *arg);

    84

int render_io_stream (struct render *ctx, FILE *fh);

    85

    86

#endif /* RENDER_H */