Аргументи Командного Рядка – Command Line Arguments

Blender 2.81 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 (лише для скриптів виконуваних із командного рядка), значення «нуль» вимикає це.
--addons <addon(s)>
Розділений комами список додатків (без пробілів).

Опції Логування – Logging Options

--log <match>
Увімкнути логування категорій, беручи аргументи по одному, розділені комою. Багато категорій можуть узгоджуватися, використовуючи суфікс .* suffix, так --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-all
Увімкнути усі повідомлення зневадження.
--debug-io
Увімкнути повідомлення зневадження для Імпорту/Експорту (collada, …).
--debug-fpe
Увімкнути дійсночислові винятки.
--disable-crash-handler
Вимкнути обробник краху.
--disable-abort-handler
Disable the abort handler.

Різні Опції – Misc Options

--app-template <template>
Задати шаблон застосунку (узгоджується з іменем каталогу), використовуйте``default`` для жодного.
--factory-startup
Skip reading the startup.blend in the user’s home directory.
--enable-library-override
Увімкнути функції Заміщення Бібліотек – Library Override в інтерфейсі користувача.
--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
Enable debug messages for Freestyle.
--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.
PYTHONHOME:Шлях до каталогу Python directory, наприклад, /usr/lib/python.