Аргументи Командного Рядка – Command Line Arguments¶
Blender 2.90 Usage: blender [args …] [file] [args …]
Опції Рендера – Render Options¶
-b
,--background
Запуск у фоні (часто використовується для рендерингу без інтерфейсу користувача).
-a
,--render-anim
Рендерити кадри від початку до кінця (включно).
-S
,--scene
<name>
Задати ім’я
<name>
активної сцени для рендерингу.-f
,--render-frame
<frame>
Рендерити кадр
<frame>
та зберегти його.+<frame>
початковий кадр відносно,-<frame>
кінцевий кадр відносно.Може також використовуватися розділений комами список кадрів (без пробілів).
Діапазон кадрів може бути виражений, використовуючи роздільник
..
між першим та останнім кадрами (включно).
-s
,--frame-start
<frame>
Задати початок діапазону кадрів
<frame>
, підтримує +/- для відносно кадрів також.-e
,--frame-end
<frame>
Задати кінець діапазону кадрів
<frame>
, підтримує +/- для відносно кадрів також.-j
,--frame-jump
<frames>
Задати кількість кадрів, які перестрибувати після кожного рендереного кадру.
-o
,--render-output
<path>
Задати шлях рендера та ім’я файлу. Використовуйте
//
на початку шляху для рендера відносно цього blend-файлу.Символи
#
замінюються номерами кадрів та використовуються для визначення заповнення нулями розрядів номерів.animation_##_test.png
стаєanimation_01_test.png
test-######.png
стаєtest-000001.png
Коли ім’я файлу не містить жодних
#
, то стандартно додасться суфікс####
у це ім’я файлу.Такий номер кадру буде додано у кінець такого імені файлі, наприклад:
blender -b animation.blend -o //render_ -F PNG -x 1 -a
//render_
стане//render_####
, а кадри запишуться як//render_0001.png
-E
,--engine
<engine>
Визначити рушій рендера. Використовуйте
-E
довідку для виводу списку доступних рушіїв.-t
,--threads
<threads>
Використати кількість потоків
<threads>
для рендерингу та інших операцій [1-64], 0 дає їх визначення головним процесором системи.
Опції Формату – Format Options¶
-F
,--render-format
<format>
Задати формат рендера. Дійсні варіанти:
TGA
RAWTGA
JPEG
IRIS
IRIZ
AVIRAW
AVIJPEG
PNG
BMP
Формати, що можуть бути скомпільовані у Blender, не доступні на всіх системах:
HDR
TIFF
OPEN_EXR
OPEN_EXR_MULTILAYER
MPEG
CINEON
DPX
DDS
JP2
-x
,--use-extension
<bool>
Задати опцію для додання розширення файлу у кінець його імені.
Опції Програвання Анімації – Animation Playback Options¶
-a
<options>
<file(s)>
Замість показування інтерфейсу користувача Blender’а, це проганяє Blender як програвач анімації, для перегляду фільмів та послідовностей, рендерених у Blender (ігнорується, якщо задано
-b
).Аргументи Програвання:
-p
<sx>
<sy>
Відкрити у нижньому лівому кутку з координатами
<sx>
,<sy>
.-m
Читати з диска (Не з буфера)
-f
<fps>
<fps-base>
Визначити початкову частоту кадрів за секунду – FPS.
-j
<frame>
Задати крок перестрибування кадрів аргументом
<frame>
.-s
<frame>
Грати з кадру
<frame>
.-e
<frame>
Грати до кадру
<frame>
.
Опції Вікна – Window Options¶
-w
,--window-border
Силувати відкриття з границями.
-W
,--window-fullscreen
Силувати відкриття у повноекранному режимі.
-p
,--window-geometry
<sx>
<sy>
<w>
<h>
Відкрити у нижньому лівому кутку з координатами
<sx>
,<sy>
та із шириною і висотою як<w>
,<h>
.-M
,--window-maximized
Силувати відкриття максимізовано.
-con
,--start-console
Запустити з відкритим вікном консолі (ігнорується, якщо задано
-b
), (лише для Windows).--no-native-pixels
Не використовувати нативний розмір пікселя, для високо роздільних дисплеїв (MacBook
Retina
).--no-window-focus
Відкрити позаду інших вікон та без фокусування.
Опції Python – Python Options¶
-y
,--enable-autoexec
Увімкнути автоматичне виконання скрипту Python (стандарт).
-Y
,--disable-autoexec
Вимкнути автоматичне виконання скрипту Python (pydrivers & startup scripts).
-P
,--python
<filename>
Запустити даний файл скрипту Python.
--python-text
<name>
Запустити текстовий блок даного файлу скрипту Python.
--python-expr
<expression>
Запустити даний вираз як скрипт Python.
--python-console
Запустити Blender з інтерактивною консоллю.
--python-exit-code
<code>
Задати код завершення у [0..255] для виходу, якщо сталося виключення Python (лише для скриптів виконуваних із командного рядка), значення «нуль» вимикає це.
--python-use-system-env
Дозволити Python використовувати змінні середовища системи, такі як
PYTHONPATH
та каталог користувача site-packages.--addons
<addon(s)>
Розділений комами список додатків (без пробілів).
Опції Логування – Logging Options¶
--log
<match>
Увімкнути логування категорій, взявши одиничний розділений комами аргумент. Кілька категорій можна зіставити за допомогою суфікса
.*
, так--log "wm.*"
логує всі види повідомлень менеджера вікон. Використовуйте префікс «^» для ігнорування, так--log "*,^wm.operator.*"
логує все, за виняткомwm.operators.*
Використовуйте «*» для логування всього.--log-level
<level>
Задати рівень багатослівності логування (вище для більшої детальності), стандарт – 1, вживайте -1 для логування всіх рівнів.
--log-show-basename
Показати лише ім’я файлу у виводі (без ведучого шляху).
--log-show-backtrace
Показати зворотне простеження для кожного повідомлення логу (лише побудови зневадження).
--log-show-timestamp
Показати часоштамп для кожного повідомлення логу у секундах після старту.
--log-file
<filename>
Задати файл для виводу у нього логу.
Опції Зневадження – Debug Options¶
-d
,--debug
Увімкнути зневаджування.
Вмикає виявлення помилок пам’яті
Вимикає захоплення мишею (для взаємодії зі зневадником у деяких випадках)
Зберігає
sys.stdin
Python’а, щоб не задавати його як «Нема» – None
--debug-value
<value>
Задати значення зневадження
<value>
при запуску.--debug-events
Увімкнути повідомлення зневадження для подій системи.
--debug-ffmpeg
Увімкнути повідомлення зневадження від бібліотеки FFmpeg.
--debug-handlers
Увімкнути повідомлення зневадження для оброблення подій.
--debug-libmv
Увімкнути повідомлення зневадження від бібліотеки libmv.
--debug-cycles
Увімкнути повідомлення зневадження від Cycles.
--debug-memory
Увімкнути повно охоронюване розподілення та зневаджування пам’яті.
--debug-jobs
Увімкнути профілювання часу для фонових завдань.
--debug-python
Увімкнути повідомлення зневадження від Python.
--debug-depsgraph
Увімкнути усі повідомлення зневадження від графа залежностей.
--debug-depsgraph-eval
Увімкнути повідомлення зневадження від графа залежностей, пов’язаних з обчисленням.
--debug-depsgraph-build
Увімкнути повідомлення зневадження від графа залежностей, пов’язаних із конструкцією графа.
--debug-depsgraph-tag
Увімкнути повідомлення зневадження від графа залежностей, пов’язаних зі значінням.
--debug-depsgraph-no-threads
Перемкнути граф залежностей в однопотокове оцінювання.
--debug-depsgraph-time
Увімкнути повідомлення зневадження від графа залежностей, пов’язаних із часуванням.
--debug-depsgraph-pretty
Увімкнути кольори для повідомлення зневадження графа залежностей.
--debug-gpu
Увімкнути контекст та інформацію зневадження GPU для OpenGL 4.3+.
--debug-gpumem
Увімкнути статистику пам’яті GPU у смузі стану.
--debug-gpu-shaders
Увімкнути статистику пам’яті GPU у смузі стану.
--debug-gpu-force-workarounds
Увімкнути статистику пам’яті GPU у смузі стану.
--debug-wm
Увімкнути повідомлення зневадження для менеджера вікон, показує всі оператори у пошуку, показує помилки розкладки клавіш.
--debug-xr
Увімкнути повідомлення зневадження для контекстів віртуальної реальності. Вмикає шар валідації OpenXR API, повідомлення зневадження (OpenXR) та виводи загальної інформації.
--debug-xr-time
Увімкнути повідомлення зневадження для разів рендерингу кадрів віртуальної реальності.
--debug-all
Увімкнути усі повідомлення зневадження.
--debug-io
Увімкнути повідомлення зневадження для уводу-виводу I/O (Collada, …).
--debug-fpe
Увімкнути дійсночислові винятки.
--disable-crash-handler
Вимкнути обробник краху.
--disable-abort-handler
Disable the abort handler.
Різні Опції – Misc Options¶
--app-template
<template>
Задати шаблон застосунку (узгоджується з іменем каталогу), використовуйте``default`` для жодного.
--factory-startup
Пропустити читання startup.blend у домашньому каталозі користувачів.
--enable-event-simulate
Увімкнути тестову функцію симуляції подій
bpy.types.Window.event_simulate
.--env-system-datafiles
Задати змінну середовища
BLENDER_SYSTEM_DATAFILES
.--env-system-scripts
Задати змінну середовища
BLENDER_SYSTEM_SCRIPTS
.--env-system-python
Задати змінну середовища
BLENDER_SYSTEM_PYTHON
.-noaudio
Силувати звукову систему як «Нема» — None.
-setaudio
Силувати систему звуку виводитися на певний пристрій.
NULL
SDL
OPENAL
JACK
.-h
,--help
Вивести цей текст довідки та вийти.
-R
Зареєструвати розширення blend-file, потім вийти (лише Windows).
-r
Тихо зареєструвати розширення blend-file, потім вийти (лише Windows).
-v
,--version
Вивести номер версії Blender’а та вийти.
--
Завершити обробку опції, наступні аргументи передано беззмінними. Доступ через
sys.argv
Python’а.
Інші Опції – Other Options¶
/?
Вивести цей текст довідки та вийти (лише Windows).
--debug-freestyle
Увімкнути повідомлення зневадження для Freestyle.
--debug-ghost
Увімкнути повідомлення зневадження для оброблення подій.
--verbose
<verbose>
Задати рівень багатослівності логування для повідомлень зневадження, що підтримує його.
Парсинг Аргументів – Argument Parsing¶
Аргументи повинні бути відокремлені пробілом, наприклад:
blender -ba test.blend
…дасть вихід, оскільки -ba
є невідомим аргументом.
Порядок Аргументів – Argument Order¶
Аргументи виконуються у порядку, в якому вони задані. наприклад:
blender --background test.blend --render-frame 1 --render-output '/tmp'
…не буде рендеритися у /tmp
, оскільки --render-frame 1
рендериться перед тим, як задано шлях виводу.
blender --background --render-output /tmp test.blend --render-frame 1
…не буде рендеритися у /tmp
, оскільки завантаження цього blend-файлу перезапише вивід рендера, який було задано.
blender --background test.blend --render-output /tmp --render-frame 1
…працює, як очікується.
Змінні Середовища – Environment Variables¶
- BLENDER_USER_CONFIG
Каталог для файлів конфігурації користувача.
- BLENDER_USER_SCRIPTS
Каталог для скриптів користувача.
- BLENDER_SYSTEM_SCRIPTS
Каталог для розширювальних системних скриптів.
- BLENDER_USER_DATAFILES
Каталог для файлів даних користувача (іконки, переклади, ..).
- BLENDER_SYSTEM_DATAFILES
Каталог для розширювальних системних файлів даних.
- BLENDER_SYSTEM_PYTHON
Каталог для системних бібліотек Python.
- TEMP
Тут зберігатимуться тимчасові файли.
- TMP
або $TMPDIR Тут зберігатимуться тимчасові файли.
- SDL_AUDIODRIVER
Аудіо драйвер LibSDL - alsa, esd, dma.