1BLENDER(1) General Commands Manual BLENDER(1)
2Blender 2.79 (sub 0)"
6
9 blender - a 3D modelling and rendering package
10
12 blender [args ...] [file] [args ...]
13
15 blender is a 3D modelling and rendering package. Originating as the in-
16 house software of a high quality animation studio, Blender has proven
17 to be an extremely fast and versatile design instrument. The software
18 has a personal touch, offering a unique approach to the world of Three
19 Dimensions.
20 Use Blender to create TV commercials, to make technical visualizations,
22 business graphics, to create content for games, or design user inter‐
23 faces. You can easy build and manage complex environments. The renderer
24 is versatile and extremely fast. All basic animation principles (curves
25 & keys) are well implemented.
26 http://www.blender.org
28
30 Color management: using fallback mode for management Blender 2.79 (sub
31 0) Usage: blender [args ...] [file] [args ...]
32 Render Options:
34 -b or --background
35 Run in background (often used for UI-less rendering).
36 -a or --render-anim
39 Render frames from start to end (inclusive).
40 -S or --scene <name>
43 Set the active scene <name> for rendering.
44 -f or --render-frame <frame>
47 Render frame <frame> and save it.
48 * +<frame> start frame relative, -<frame> end frame relative.
51 * A comma separated list of frames can also be used (no spaces).
52 * A range of frames can be expressed using '..' seperator
53 between the first and last frames (inclusive).
54 -s or --frame-start <frame>
57 Set start to frame <frame>, supports +/- for relative frames
58 too.
59 -e or --frame-end <frame>
62 Set end to frame <frame>, supports +/- for relative frames too.
63 -j or --frame-jump <frames>
66 Set number of frames to step forward after each rendered frame.
67 -o or --render-output <path>
70 Set the render path and file name.
71 Use '//' at the start of the path to render relative to the
72 blend-file.
73 The '#' characters are replaced by the frame number, and used to
76 define zero padding.
77 * 'ani_##_test.png' becomes 'ani_01_test.png'
80 * 'test-######.png' becomes 'test-000001.png'
81 When the filename does not contain '#', The suffix '####' is
84 added to the filename.
85 The frame number will be added at the end of the filename, eg:
88 # blender -b foobar.blend -o //render_ -F PNG -x 1 -a
89 -E or --engine <engine>
92 Specify the render engine.
93 Use -E help to list available engines.
94 -t or --threads <threads>
97 Use amount of <threads> for rendering and other operations
98 [1-1024], 0 for systems processor count.
99 Format Options:
102 -F or --render-format <format>
103 Set the render format.
104 Valid options are 'TGA' 'RAWTGA' 'JPEG' 'IRIS' 'IRIZ' 'AVIRAW'
105 'AVIJPEG' 'PNG' 'BMP'
106 Formats that can be compiled into Blender, not available on all
109 systems: 'HDR' 'TIFF' 'EXR' 'MULTILAYER'
110 -x or --use-extension <bool>
113 Set option to add the file extension to the end of the file.
114 Animation Playback Options:
117 -a or --render-anim
118 Render frames from start to end (inclusive).
119 Window Options:
122 -w or --window-border
123 Force opening with borders.
124 -W or --window-borderless
127 Force opening without borders.
128 -p or --window-geometry <sx> <sy> <w> <h>
131 Open with lower left corner at <sx>, <sy> and width and height
132 as <w>, <h>.
133 -con or --start-console
136 Start with the console window open (ignored if -b is set), (Win‐
137 dows only).
138 --no-native-pixels
141 Do not use native pixel size, for high resolution displays (Mac‐
142 Book 'Retina').
143 Game Engine Specific Options:
146 -g Game Engine specific options
147 Run on 50 hertz without dropping frames.
150 Use Vertex Arrays for rendering (usually faster).
151 No Texture Mipmapping.
152 Linear Texture Mipmapping instead of Nearest (default).
153 Python Options:
156 -y or --enable-autoexec
157 Enable automatic Python script execution.
158 -Y or --disable-autoexec
161 Disable automatic Python script execution (pydrivers & startup
162 scripts), (compiled as non-standard default).
163 -P or --python <filename>
166 Run the given Python script file.
167 --python-text <name>
170 Run the given Python script text block.
171 --python-expr <expression>
174 Run the given expression as a Python script.
175 --python-console
178 Run Blender with an interactive console.
179 --python-exit-code
182 Set the exit-code in [0..255] to exit if a Python exception is
183 raised
184 (only for scripts executed from the command line), zero dis‐
185 ables.
186 --addons
189 Comma separated list of add-ons (no spaces).
190 Debug Options:
193 -d or --debug
194 Turn debugging on.
195 * Enables memory error detection
198 * Disables mouse grab (to interact with a debugger in some
199 cases)
200 * Keeps Python's 'sys.stdin' rather than setting it to None
201 --debug-value <value>
204 Set debug value of <value> on startup.
205 --debug-events
208 Enable debug messages for the event system.
209 --debug-handlers
212 Enable debug messages for event handling.
213 --debug-libmv
216 Enable debug messages from libmv library.
217 --debug-cycles
220 Enable debug messages from Cycles.
221 --debug-memory
224 Enable fully guarded memory allocation and debugging.
225 --debug-jobs
228 Enable time profiling for background jobs.
229 --debug-python
232 Enable debug messages for Python.
233 --debug-depsgraph
236 Enable debug messages from dependency graph.
237 --debug-depsgraph-no-threads
240 Switch dependency graph to a single threaded evaluation.
241 --debug-gpumem
244 Enable GPU memory stats in status bar.
245 --debug-wm
248 Enable debug messages for the window manager, also prints every
249 operator call.
250 --debug-all
253 Enable all debug messages.
254 --debug-io
257 Enable debug messages for I/O (collada, ...).
258 --debug-fpe
261 Enable floating point exceptions.
262 --disable-crash-handler
265 Disable the crash handler.
266 Misc Options:
269 --factory-startup
270 Skip reading the BLENDER_STARTUP_FILE in the users home direc‐
271 tory.
272 --env-system-datafiles
275 Set the BLENDER_SYSTEM_DATAFILES environment variable.
276 --env-system-scripts
279 Set the BLENDER_SYSTEM_SCRIPTS environment variable.
280 --env-system-python
283 Set the BLENDER_SYSTEM_PYTHON environment variable.
284 -nojoystick
287 Disable joystick support.
288 -noglsl
291 Disable GLSL shading.
292 -noaudio
295 Force sound system to None.
296 -setaudio
299 Force sound system to a specific device.
300 -h or --help
303 Print this help text and exit.
304 -v or --version
307 Print Blender version and exit.
308 --
311 End option processing, following arguments passed unchanged.
312 Access via Python's 'sys.argv'.
313 Experimental Features:
316 --enable-new-depsgraph
317 Use new dependency graph.
318 --enable-new-basic-shader-glsl
321 Use new GLSL basic shader.
322 Other Options:
325 /?
326 Print this help text and exit (windows only).
327 --disable-abort-handler
330 Disable the abort handler.
331 -a <options> <file(s)>
334 Playback <file(s)>, only operates this way when not running in
335 background.
336 -p <sx> <sy>
339 Open with lower left corner at <sx>, <sy>.
340 -m
341 Read from disk (Do not buffer).
342 -f <fps> <fps-base>
343 Specify FPS to start with.
344 -j <frame>
345 Set frame step to <frame>.
346 -s <frame>
347 Play from <frame>.
348 -e <frame>
349 Play until <frame>.
350 --debug-freestyle
353 Enable debug messages for FreeStyle.
354 --debug-gpu
357 Enable gpu debug context and information for OpenGL 4.3+.
358 --verbose <verbose>
361 Set logging verbosity level.
362 -R
365 Register blend-file extension, then exit (Windows only).
366 -r
369 Silently register blend-file extension, then exit (Windows
370 only).
371 Argument Parsing:
374 Arguments must be separated by white space, eg:
375 # blender -ba test.blend
376 ...will ignore the 'a'.
377 # blender -b test.blend -f8
378 ...will ignore '8' because there is no space between the '-f' and the
379 frame value.
380 Argument Order:
382 Arguments are executed in the order they are given. eg:
383 # blender --background test.blend --render-frame 1 --render-output
384 '/tmp'
385 ...will not render to '/tmp' because '--render-frame 1' renders
386 before the output path is set.
387 # blender --background --render-output /tmp test.blend --render-frame
388 1
389 ...will not render to '/tmp' because loading the blend-file over‐
390 writes the render output that was set.
391 # blender --background test.blend --render-output /tmp --render-frame
392 1
393 ...works as expected.
394
396 $BLENDER_USER_CONFIG Directory for user configuration files.
397 $BLENDER_USER_SCRIPTS Directory for user scripts.
398 $BLENDER_SYSTEM_SCRIPTS Directory for system wide scripts.
399 $BLENDER_USER_DATAFILES Directory for user data files (icons,
400 translations, ..).
401 $BLENDER_SYSTEM_DATAFILES Directory for system wide data files.
402 $BLENDER_SYSTEM_PYTHON Directory for system Python libraries.
403 $TMP or $TMPDIR Store temporary files here.
404 $SDL_AUDIODRIVER LibSDL audio driver - alsa, esd, dma.
405 $PYTHONHOME Path to the Python directory, eg.
406 /usr/lib/python.
407
410 luxrender(1)
411
414 This manpage was written for a Debian GNU/Linux system by Daniel Mester
415 <mester@uni-bremen.de> and updated by Cyril Brulebois <cyril.brule‐
416 bois@enst-bretagne.fr> and Dan Eicher <dan@trollwerks.org>.
417Blender management: using fallbackMamyod2e0,fo2r01m9anagement BLENDER(1)