1K3D-RENDERJOB(1) K3D-RENDERJOB(1)
2
3
4
6 k3d-renderjob - Part of a simple system for queueing K-3D render jobs
7 on the local host
8
10 k3d-renderjob [OPTIONS] [DIRECTORY ...]
11
13 Extracted from http://www.k-3d.org/wiki/Network_Rendering
14
15 Currently, K-3D implements a simple system for queueing rendering jobs
16 on the local host. When the user initiates a job (such as rendering a
17 preview image, rendering a final frame, or rendering an animation), a
18 job directory is created (usually in /tmp, although this can be
19 configured). The job directory contains a lock file, a control file
20 named control.k3d, and one-to-many numbered frame directories. The name
21 of the lock file changes to flag the sta.IP tus of the job as "ready",
22 "running", "complete", or "error". The control.k3d file is currently
23 unused. Each frame directory contains a lock file, a control file named
24 control.k3d and zero-to-many frame resources. The name of the lock file
25 changes to flag the status of the frame as "ready", "running",
26 "complete", or "error". The control.k3d file is an XML file that
27 encodes a set of operations that must be completed successfully to
28 change the status of the frame from "ready" to "complete". Three types
29 of operation are allowed: a "render" operation that executes a
30 pre-configured render command using a fixed set of command-line
31 arguments, a "copy" operation that copies a file from one filesystem
32 location to another; and a "view" operation that displays a bitmap
33 image using the user’s choice of image viewer. The frame resources are
34 inputs to the render engine, such as RIB files, texture images,
35 shaders, etc.
36
37 The k3d-renderjob executable is run with the path to a job directory as
38 an argument. k3d-renderjob updates the job lock file, iterating over
39 each frame directory, spawning an instance of k3d-renderframe for each
40 frame (one at a time). k3d-renderframe is run with the path to a frame
41 directory as an argument, updating the frame lock file, reading the
42 control file, and executing the operations that it specifies.
43
45 -h, --help
46 Prints this help information and exits.
47
48 --version
49 Prints program version information and exits.
50
52 K-3D by Timothy M. Shead <tshead@k-3d.com>, and many others. This
53 manpage written by Manuel A. Fernandez Montecelo
54 <manuel.montezelo@gmail.com>
55
57 K-3D home page: http://www.k-3d.org
58
60 Copyright (c) 1995-2010, Timothy M. Shead. All Rights Reserved. This
61 software is licensed under the terms of the GNU General Public License;
62 see the source for copying conditions. There is NO warranty; not even
63 for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
64
65
66
67 02/20/2019 K3D-RENDERJOB(1)