NAME
k3d-renderjob - Part of a simple system for queueing K-3D render jobs
on the local host
SYNOPSIS
k3d-renderjob [options] [directory ...]
DESCRIPTION
Extracted from http://www.k-3d.org/wiki/Network_Rendering
Currently, K-3D implements a simple system for queueing
rendering jobs on the local host. When the user initiates a job
(such as rendering a preview image, rendering a final frame, or
rendering an animation), a job directory is created (usually in
/tmp, although this can be configured). The job directory
contains a lock file, a control file named control.k3d, and one-
to-many numbered frame directories. The name of the lock file
changes to flag the sta.IP tus of the job as "ready", "running",
"complete", or "error". The control.k3d file is currently
unused. Each frame directory contains a lock file, a control
file named control.k3d and zero-to-many frame resources. The
name of the lock file changes to flag the status of the frame as
"ready", "running", "complete", or "error". The control.k3d file
is an XML file that encodes a set of operations that must be
completed successfully to change the status of the frame from
"ready" to "complete". Three types of operation are allowed: a
"render" operation that executes a pre-configured render command
using a fixed set of command-line arguments, a "copy" operation
that copies a file from one filesystem location to another; and
a "view" operation that displays a bitmap image using the user's
choice of image viewer. The frame resources are inputs to the
render engine, such as RIB files, texture images, shaders, etc.
The k3d-renderjob executable is run with the path to a job
directory as an argument. k3d-renderjob updates the job lock
file, iterating over each frame directory, spawning an instance
of k3d-renderframe for each frame (one at a time). k3d-
renderframe is run with the path to a frame directory as an
argument, updating the frame lock file, reading the control
file, and executing the operations that it specifies.
-h, --help
prints this help information and exits
--version
prints program version information and exits
AUTHOR
Written by Manuel A. Fernandez Montecelo <manuel.montezelo@gmail.com>
COPYRIGHT
Copyright (c) 1995-2010, Timothy M. Shead. All Rights Reserved.
This software is licensed under the terms of the GNU General Public
License; see the source for copying conditions. There is NO warranty;
not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
SEE ALSO
The K-3D Home Page: http://www.k-3d.org