1

#ifndef RENDER_REMOTE_H

     2

#define RENDER_REMOTE_H

     3

     6

     7

#include "render.h"

     8

     9

/*

    10

 * Execute a render_t operation on a remote render_node

    11

 */

    12

    13

    14

#define RENDER_PORT 6159

    15

    16

struct remote_render_ctx;

    17

    18

/*

    19

 * Execute the given render operation on the render_node at the given remote address.

    20

 *

    21

 * The various callback functions must all be provided.

    22

 *

    23

 * cb_sent will be invoked after the request has succesfully been written, and before cb_data is called.

    24

 * cb_data is called whenever new data has been received. See also, render_remote_set_chunk_size

    25

 * cb_done is called when all the data has been passed to cb_data

    26

 * cb_fail is called when an error is encountered. This can (and will) happen at any time!

    27

 */

    28

struct remote_render_ctx *render_remote (

    30

        render_t *render_ctx,               // what to render

    31

        struct sockaddr_storage *remote,    // what render node to use

    32

        void (*cb_sent)(void *arg),

    33

        void (*cb_data)(struct evbuffer *buf, void *arg),

    34

        void (*cb_done)(void *arg),

    35

        void (*cb_fail)(void *arg),

    36

        void *cb_arg;

    37

);

    38

    39

/*

    40

 * Cancel the given request. No more callbacks will be called, buffered data is discarded and the remote render process will cancel asap.

    41

 */

    42

void render_remote_cancel (struct remote_render_ctx *ctx);

    43

    44

/*

    45

 * If you don't want to receive the rendered data one byte at a time, you can set a minimum chunk size.

    46

 *

    47

 * cb_done will only be called when the buffer contains at least chunk_size bytes, or no more data is available (cb_done will be called next).

    48

 *

    49

 * overflow_buffer is how many bytes will be buffered, at most, in addition to chunk_size (in case rendering is paused). After that, the render node will start to block.

    50

 *

    51

 * Only call this once cb_sent has fired

    52

 */

    53

int render_remote_set_chunk_size (struct remote_render_ctx *ctx, size_t chunk_size, size_t overflow_buffer);

    54

    55

#endif /* RENDER_REMOTE_H */