DistRen Changeset - 4c92a6a1bfd9 · protofusion repositories

Changeset - 4c92a6a1bfd9

Parent rev.

Child rev.

[Not reviewed]

default

0 1 0

Nathan Brink (binki) - 16 years ago 2009-05-23 20:35:30
ohnobinki@ohnopublishing.net

Declared distren_job_getid

1 file changed with 8 insertions and 0 deletions:

src/client/distren.h

0 comments (0 inline, 0 general)

src/client/distren.h

➞

Show inline comments

@@ @@ -27,41 +27,49 @@ typedef struct distren *distren_t; @@
 typedef void* (*distren_malloc_t)(size_t);
 typedef void (*distren_free_t)(void*);
 typedef struct distren_job *distren_job_t;
 /**
  Initialize a libdistren handle. In the spirit of respecting client programs' choices,
  this initialization function allows malloc() and free() compatible function pointers
  to be passed.
 */
 int distren_init_mf(distren_t *handle, distren_malloc_t mymalloc, distren_free_t myfree);
 /**
  Initializes a libdistren handle using the system malloc() and free() implementation.
 */
 int distren_init(distren_t *handle);
 /**
  Submits a file to distren.
  @param job must not refer to a valid job.
  TODO: create a stream-based interface
 */
 int distren_submit_file(distren_job_t *job, const char *filename);
 /**
    Retrieve a job-ID that can be used to refer to the job after the client's process has recycled. Currently, this will be the only way to retrieve a job handle (a distren_job_t) and, consequently, the only way to retrieve a finished render.
    A job ID is representable using a character string. Hopefully, they will be kept at a reasonably small length. It should be made up of alphanumeric characters so as to be useful in most situations.
    @param jobid This will be set to a string allocated by the specified malloc implementation
    @param job The distren_job_t from which to retrieve a jobid
 */
 distren_job_getid(distren_job_t job, char **jobid);
 /*
  TODO: extraction of a job-ID, retrieving job handle by job-ID, getting information
  for a job handle, retrieving results of a job, callbacks for progress (i.e., job_is_finished callback)
  -- threads?
 */
 /**
  Destroys and frees a job handle
 */
 int distren_job_free(distren_job_t job);
 /**
  Destroys and frees a libdistren handle
 */
 int distren_free(distren_t handle);
 #endif

0 comments (0 inline, 0 general)