k3d-renderjob(1) [debian man page]
K-3D(1) User Commands K-3D(1) 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-con- figured render command using a fixed set of command-line arguments, a "copy" operation that copies a file from one filesystem loca- tion 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, iter- ating 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 K-3D Version 0.8.0.2 June 2010 K-3D(1)
Check Out this Related Man Page
k3d(1) General Commands Manual k3d(1) NAME
k3d - 3D modeling and animation system SYNOPSIS
k3d [options] DESCRIPTION
K-3D is a free (as in freedom) 3D modeling, animation, and rendering system for GNU/Linux and Win32. K-3D features a robust, object-ori- ented plugin architecture and is capable of producing motion-picture-quality output when paired with a RenderMan Interface compliant render engine such as Aqsis. Please visit http://www.k-3d.org for more information. OPTIONS
--add-path [path] Prepends a filesystem path to the PATH environment variable. --color Color-codes log messages based on their priority. Requires an ANSI color-capable terminal. --disable-gl-extension [extension] Disables the given OpenGL extension. --exit Exits the program (useful after running scripts in batch mode). -h, --help Prints this help information and exits. --log-level [level] Specifies the minimum message priority to log (valid values are "warning", "information", or "debug"). --options [path] Overrides the filepath for storing user options (this overrides both defaults and the K3D_OPTIONS_PATH environment variable, below). --plugins [path] Overrides the path(s) for loading plugin libraries (this overrides both defaults and the K3D_PLUGIN_PATHS environment variable, below). Multiple colon-delimited paths are allowed. Use "&" as a synonym for the default paths. --script [file] Play the given script after startup (use - for stdin). --shadercache [path] Overrides the path where compiled shaders will be cached (this overrides both defaults and the K3D_SHADER_CACHE_PATH environment variable, below). --share [path] Overrides the path for loading shared data files (this overrides both defaults and the K3D_SHARE_PATH environment variable, below). --show-process Prints the process name next to log messages. --show-timestamps Prints timestamps next to log messages. --syslog Logs messages to syslog. -u, --ui [ui path] Specifies the path to a user interface plugin (this overrides both the default and the K3D_USER_INTERFACE_PATH environment variable, below). As a special-case the string "none" can be used as a synonym for the Null (no gui) User Interface. -H, --user-interface-help Prints a user-interface specific help message and exits. --version Prints program version information and exits. USER INTERFACE OPTIONS
--batch Operate in batch (no user intervention) mode. -n, --new Creates a new document after startup. --no-custom-layouts Disable custom user interface layouts (useful when playing-back recorded tutorials, which rely on the default layout). --no-splash Disables the startup splash screen. -o, --open [file] Opens the given file after startup. --show-tutorials Opens the tutorials menu immediately following startup. --tutorials [path] Overrides the path for loading interactive tutorials (this overrides both defaults and the K3D_TUTORIALS_PATH environment variable, below). ENVIRONMENT VARIABLES
K3D_EXTRA_OPTIONS Provides additional options that are appended to the command-line at startup. Note that unlike other K-3D environment variables, options specified via K3D_EXTRA_OPTIONS will override options specified on the command line. K3D_OPTIONS_PATH Overrides the path for storing user options (this overrides the default, but can be overridden by the --options option, above). K3D_PLUGIN_PATHS Overrides the path(s) for loading plugin libraries (this overrides the default, but can be overridden by the --plugins option, above). Multiple colon-delimited paths are allowed. Use "&" as a synonym for the default paths. K3D_SHADER_CACHE_PATH Overrides the path where compiled shaders are cached (this overrides the default, but can be overridden by the --shadercache option, above). K3D_SHARE_PATH Overrides the path for loading shared data files (this overrides the default, but can be overridden by the --share option, above). K3D_USER_INTERFACE_PATH Overrides the path to the user interface plugin (this overrides the default, but can be overridden by the --ui option, above). AUTHORS
Written by Timothy M. Shead <tshead@k-3d.com>, and many others. REPORTING BUGS
Report bugs to <k3d-development@lists.sourceforge.net> 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 K-3D Version 0.8.0.2 June 2010 k3d(1)