1

#ifndef RENDER_REMOTE_H

     2

#define RENDER_REMOTE_H

     3

     4

#include <event2/util.h>

     5

#include <event2/buffer.h>

     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 (

    29

        render_t *render_ctx,               // what to render

    30

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

    31

        void (*cb_sent)(void *arg),

    32

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

    33

        void (*cb_done)(void *arg),

    34

        void (*cb_fail)(void *arg),

    35

        void *cb_arg;

    36

);

    37

    38

/*

    39

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

    40

 */

    41

void render_remote_cancel (struct remote_render_ctx *ctx);

    42

    43

/*

    45

 *

    51

 *

    55

 *

    56

 * Only call this once cb_sent has fired

    57

 */

    68

    69

#endif /* RENDER_REMOTE_H */