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)