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

Blender 2.91 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>

Specify the render engine. Use -E help to list available engines.

-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-depsgraph-uuid: Увімкнути повідомлення зневадження від графа залежностей, пов’язаних із конструкцією графа.
--debug-exit-on-error: Immediately exit when internal errors are detected.
--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.