SYNOPSIS

k3d [OPTIONS]

DESCRIPTION

K-3D is the free (as in freedom) 3D modeling, animation, and rendering system for systems including GNU/Linux, Mac OSX, Windows, and others. K-3D features a robust, object-oriented plugin architecture and is capable of producing motion-picture-quality output when paired with a RenderMan Interface compliant render engine such as Aqsis.

OPTIONS

--add-path=PATH

Prepends a filesystem path to the PATH environment variable.

--batch

Enables batch (no user intervention) mode.

--color

Color-codes log messages based on their priority. Requires an ANSI color-capable terminal.

--disable-gl-extension=EXTENSION

Disables the given OpenGL extension (whether it is supported by the underlyinghardware or not).

--enable-gl-extension=EXTENSION

Enables the given OpenGL extension (whether it is supported by the underlying hardware or not).

--exit

Exits the program after startup (useful when running scripts in batch mode).

-h, --help

Prints this help information and exits.

--list-gl-extensions

List available OpenGL extensions and exit.

--locale=PATH

Overrides the path for loading locales.

--log-level=LEVEL

Specifies the minimal message priority to display: warning, information or debug. Defaults to warning.

--options=PATH

Overrides the filepath for storing user options (this overrides the default and the K3D_OPTIONS_PATH environment variable).

--plugins=PATHS

Overrides the path(s) for loading plugin libraries (this overrides the default and the K3D_PLUGIN_PATHS environment variable). Multiple colon-delimited paths are allowed. Use "&" as a synonym for the default paths.

--no-color

Disable color-coding of log messages based on their priority.

-e, --script=SCRIPT

Executes the given script text after startup.

-f, --script-file=PATH

Executes the given script file after startup (use - for stdin).

--setenv=ARG

Set an environment variable using name=value syntax.

--shadercache=PATH

Overrides the path where compiled shaders will be cached (this overrides the default and the K3D_SHADER_CACHE_PATH environment variable).

--share=PATH

Overrides the path for loading shared data files (this overrides the default and the K3D_SHARE_PATH environment variable).

--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=ARG

Specifies the user interface to use at startup: nui, ngui, qtui, pyui, or the path to a user interface plugin (this overrides the default and the K3D_USER_INTERFACE_PATH environment variable).

-H, --user-interface-help

Prints additional command line options based on the the current choice of user interface, and exits.

--version

Prints program version information and exits.

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. Typically used to pass command-line arguments when running the program from the build tree.

K3D_OPTIONS_PATH

Overrides the path for storing user options (this overrides the default, but can be overridden by the --options option).

K3D_PLUGIN_PATHS

Overrides the path(s) for loading plugin libraries (this overrides the default, but can be overridden by the --plugins option). 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).

K3D_SHARE_PATH

Overrides the path for loading shared data files (this overrides the default, but can be overridden by the --share option).

K3D_USER_INTERFACE_PATH

Overrides the path to the user interface plugin (this overrides the default, but can be overridden by the --ui option).

EXIT STATUS

0

Success

Non-zero

Failure (syntax or usage error; configuration error; runtime failure; unexpected error).

BUGS

See the K-3D tracker at http://developer.k-3d.org/tracker and report bugs to <[email protected]>

AUTHORS

K-3D by Timothy M. Shead <[email protected]>, and many others.

RESOURCES

K-3D home page: http://www.k-3d.org

COPYING

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.