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

Blender 5.3

Використання: blender [args ...] [file] [args ...]

Опції Рендерингу

-b, --background

Запуск у фоні (часто використовується для рендерингу без інтерфейсу користувача).

Аудіо пристрій типово є вимкненим у фоновому режимі і може бути увімкнений після введення в -setaudio Default пізніше.

-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-файлу.

Ви можете використати цю шаблону функцію шляху {blend_name} в шляху. Дивіться документацію Blender про шляхи шаблонів для більших подробиць.

Символи # замінюються номерами кадрів та використовуються для визначення заповнення нулями розрядів номерів.

• 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 help для виводу списку доступних рушіїв.

-t, --threads <threads>

Використати кількість потоків <threads> для рендерингу та інших операцій [1-1024], 0 щоб використовувати кількість процесора системи.

Cycles Опції Рендерингу

Опції розширення Cycles повинні бути вказані після подвійного дефісу.

--cycles-device <device>

Встановіть пристрій який буде використовуватись для рендерингу. Правильними опціями є: CPU CUDA OPTIX HIP ONEAPI METAL.

Додайте напочатку +CPU до GPU пристрою, щоб рендеринг відбувався на обох CPU та GPU.

Приклад:

blender -b file.blend -f 20 -- --cycles-device OPTIX

--cycles-print-stats

Логувати статистику про використання рендер пам’яті та часу.

Опції Формату

-F, --render-format <format>

Встановіть формат рендерингу. Правильними опціями є: TGA RAWTGA JPEG IRIS PNG BMP HDR TIFF.

Формати які можна скомпілювати в Blender, не є доступними на всіх системах: OPEN_EXR OPEN_EXR_MULTILAYER FFMPEG CINEON DPX JP2 WEBP.

-x, --use-extension <bool>

Задання опції для додання розширення файлу у кінець його імені.

Опції Програвання Анімації

-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>.

-c <cache_memory>

Обсяг пам’яті в мегабайтах для кешування зображень під час програвання. Нуль вимикає (натомість затисніть фіксованою кількістю кадрів).

Опції Вікна

-w, --window-border

Силоміць відкриття з межами, в нормальному (не максимізованому) стані.

-M, --window-maximized

Силування відкриття максимізовано.

-W, --window-fullscreen

Силоміць відкриття на повний екран.

-p, --window-geometry <sx> <sy> <w> <h>

Відкриття у нижньому лівому кутку з координатами <sx>, <sy> та із шириною і висотою як <w>, <h>.

-con, --start-console

Запуск з відкритим вікном консолі (ігнорується, якщо задано -b), (лише для Windows).

--no-native-pixels

Не використовувати нативний розмір пікселя, для високо роздільних дисплеїв (MacBook Retina).

--no-window-frame

Вимкнути всі віконні оздоблення (тільки на Linux).

--no-window-focus

Відкриття позаду інших вікон та без фокусування.

Python Options – Опції Python

-y, --enable-autoexec

Увімкнути автоматичне виконання Python скриптів.

-Y, --disable-autoexec

Вимкнути автоматичне виконання Python скриптів (Python-драйвери & скрипти початкового запуску), (типово).

-P, --python <filepath>

Запуск заданого файлу скрипту 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)>

Comma separated list (no spaces) of add-ons to enable in addition to any default add-ons.

Мережеві Опції

--online-mode

Дозволити інтернет доступ, перезаписуючи уподобання.

--offline-mode

Не дозволяти інтернет доступ, перезаписуючи уподобання.

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

--log <match>

Увімкнути категорії логування, приймає аргументи розділені однією комою.

--log "*": everything --log "event": кожна категорія починається з event. --log "render,cycles": обидва render та cycles повідомлення. --log "*mesh*": кожна категорія, що містить mesh sub-string. --log "*,^operator": все окрім операторів, з ^prefix виключити.

--log-level <level>

Встановити рівень багатослівності логування.

fatal: Тільки фатальні помилки error: Тільки помилки warning: Попередження info: Інформація про пристрої, файли, конфігурацію, операції debug: Багатослівні повідомлення для розробників trace: Дуже багатослівні шляхи виконання коду

--log-show-memory

Показувати використання пам’яті для кожного лог-повідомлення.

--log-show-source

Відобразити основний файл та назву функції у виводі.

--log-show-backtrace

Показ зворотного простеження для кожного повідомлення логу (лише побудови зневадження).

--log-file <filepath>

Задання файлу для виводу у нього логу.

--log-list-categories

Скласти список всіх доступних категорій логування для --log, і вийти.

Debug Options – Опції Зневадження

-d, --debug

Увімкнення зневаджування.

• Вмикає виявлення помилок пам’яті

• Вимикає захоплення мишею (для взаємодії зі зневадником у деяких випадках)

• Зберігає sys.stdin Python’а, щоб не задавати його як «Нема» – None

--debug-value <value>

Задання значення зневадження <value> при запуску.

--debug-events

Увімкнення повідомлення зневадження для подій системи.

--debug-handlers

Увімкнення повідомлення зневадження для оброблення подій.

--debug-libmv

Увімкнення повідомлення зневадження від бібліотеки libmv.

--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-depsgraph-uid

Перевірити правильність ідентифікаторів для всієї сесії, призначених до ID блок-даних.

--debug-ghost

Увімкнути повідомлення налагодження для Ghost (тільки Linux).

--debug-wintab

Увімкнути повідомлення налагоджування для Wintab.

--debug-gpu

Увімкнення контексту та інформації зневадження GPU для OpenGL 4.3+.

--debug-gpu-force-workarounds

Увімкнення обходів для типових проблем GPU та вимкнення всіх розширень GPU.

--debug-gpu-compile-shaders

Скомпілювати всі статично визначені шейдери, щоб протестувати сумісність платформи.

--debug-gpu-shader-debug-info

Увімкнути генерацію інформації налагодження (тільки Vulkan).

--debug-gpu-scope-capture

Зловити GPU команди які видані в середині наданої області назви.

--debug-gpu-shader-source

Зберегти скомпільовані основні коди GPU шейдерів для даної назви шейдеру. Надана назва може містити спереду чи ззаду wildcard «*» щоб мати збіг з багатьма шейдерами. Файли будуть збережені в поточній робочій директорії, в середині директорії з назвою «Shaders».

--debug-gpu-shader-no-preprocessor

Пропустити шлях процесору і опиратись натомість на драйвер або процесор який компілює шейдери. Також вимкнути знищення мертвого коду.

--debug-gpu-shader-no-dce

Пропустити пропуск знищення мертвого коду.

--debug-gpu-no-texture-pool

Вимкнути оптимізацію пам’яті згладжування (aliasing) в пулі текстур GPU.

--debug-gpu-renderdoc

Увімкнути інтеграцію RenderDoc для GPU збирання кадрів та налагодження.

--debug-gpu-vulkan-local-read

Силоміць Vulkan динамічне рендерування місцевого читання коли підтримується пристроєм.

--debug-wm

Увімкнення повідомлень зневадження для менеджера вікон, показує всі оператори у пошуку, показує помилки розкладки клавіш.

--debug-xr

Увімкнення повідомлень зневадження для контекстів віртуальної реальності. Вмикає шар валідації OpenXR API, повідомлення зневадження (OpenXR) та виводи загальної інформації.

--debug-xr-time

Увімкнення повідомлень зневадження для разів рендерингу кадрів віртуальної реальності.

--debug-all

Увімкнення всіх повідомлень зневадження.

--debug-io

Увімкнути повідомлення налагодження для I/O.

--debug-fpe

Увімкнення дійсночислових винятків.

--debug-exit-on-error

Негайний вихід при виявленні внутрішніх помилок.

--debug-freestyle

Увімкнення повідомлень зневадження для Freestyle.

--disable-crash-handler

Вимкнення обробника краху.

--disable-abort-handler

Вимкнення обробника переривання.

--verbose <verbose>

Задання рівня багатослівності логування для повідомлень зневадження, що підтримує його.

-q, --quiet

Стримати статус друкування (попередження та помилки все ще будуть друкуватись).

GPU Опції

--gpu-backend

Силоміць використовувати вказаний GPU програмно-апаратний комплекс. Правильні опції: vulkan, metal, opengl.

--gpu-vsync

Встановити VSync. Правильними опціями є : on, off & auto для адаптивної синхронізації.

• Типові налаштування залежать від драйверу GPU.

• Вимикання VSync може бути корисним для тестування продуктивності.

• auto підтримується тільки апаратно-програмним комплексом OpenGL.

--gpu-compilation-subprocesses

Перевизначити налаштування Максимальна Компіляція Під-процесів (тільки OpenGL).

--profile-gpu

Увімкнути CPU та GPU профілювання продуктивності для GPU груп налагодження (Створює файл profile.json в форматі Trace Event Format в поточну директорії)

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

--open-last

Відкриття найбільш недавно відкритого файлу blend замість стандартного файлу запуску.

--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-extensions

Встановити BLENDER_SYSTEM_EXTENSIONS змінну середовища.

--env-system-python

Задання змінної середовища BLENDER_SYSTEM_PYTHON.

-noaudio

Силування звукової системи як None – «Нема».

-setaudio

Примусово додати звукову систему до певного пристрою. None Default SDL OpenAL CoreAudio JACK PulseAudio WASAPI.

-c, --command <command>

Виконайте команду яка використає всі аргументи які залишилися. Виконайте -c help , щоб подивитись список всіх інших команд. Додайте --help після команди, щоб побачити текст її довідки.

Це мається на увазі --background режим.

-h, --help

Виведення тексту цієї довідки та вихід.

/?

Виведення тексту цієї довідки та вихід (лише Windows).

-r, --register

Зареєструвати розширення blend-файлу для поточного користувача, потім вихід (лише Windows та Linux).

--register-allusers

Зареєструвати розширення blend-файлу, потім вихід (лише Windows та Linux).

--unregister

Від-реєструвати розширення blend-файлу для поточного користувача, потім вихід (лише Windows та Linux).

--unregister-allusers

Від-реєструвати розширення blend-файлу для всіх користувачів, потім вихід (лише Windows та Linux).

--qos <level>

Встановити Quality of Service (QoS) режим для гібридних CPU архітектур (Windows only).

default: Використовує типову поведінку ОС. high: Завжди використовувати продуктивні ядра. eco: Використовувати розклад для Blender потоків виключно для енергоефективних ядер.

-v, --version

Виведення номеру версії Blender’а та вихід.

--

Завершення обробки опції, наступні аргументи передано беззмінними. Доступ через sys.argv Python’а.

Інші Опції

--disable-depsgraph-on-file-load

Background mode: Не робити систематичну збірку та не оцінювати графіки залежностей Оглядових-Шарів при завантажені blend-файлу у фоновому режимі (-b або -c опції).

Скрипти яким потрібно оцінювати данні потім повинні чітко зрозуміти, що оцінений depsgraph є доступним (приклад, by calling depsgraph = context.evaluated_depsgraph_get()).

ЗАУВАЖТЕ: це є тимчасовою опцією, в майбутньому depsgraph ніколи не буде автоматично згенерований при завантажені файлу у фоновому режимі.

--disable-liboverride-auto-resync

Не робити автоматичну ре-синхронізацію перевизначення бібліотеки, коли завантажується новий blend-файл.

ЗАУВАЖТЕ: це є альтернативним шляхом, щоб отримати той самий ефект встановлюється No Override Auto Resync опція Налагодження Властивостей Користувача.

--debug-ffmpeg

Увімкнути повідомлення налагодження з FFmpeg відео вводу та виводу.

--debug-cycles

Увімкнення повідомлення зневадження від Cycles.

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

…працює, як очікується.

Змінні Середовища

BLENDER_USER_RESOURCES:

Замінити типову директорію всіх файлів користувача. Інша BLENDER_USER_* змінна буде перевизначена коли встановлено.

BLENDER_USER_CONFIG:

Каталог для файлів конфігурації користувача.

BLENDER_USER_SCRIPTS:

Каталог для скриптів користувача.

BLENDER_USER_EXTENSIONS:

Директорія для розширень користувача.

BLENDER_USER_DATAFILES:

Каталог для файлів даних користувача (іконки, переклади, ..).

BLENDER_SYSTEM_RESOURCES:

Замінити типову директорію всіх ресурсних файлів пакунку.

BLENDER_SYSTEM_SCRIPTS:

Директорії щоб додати додаткові скрипти.

BLENDER_SYSTEM_EXTENSIONS:

Директорія для системних розширень сховища.

BLENDER_SYSTEM_DATAFILES:

Директорія для заміни файлів з даними, що знаходяться в пакунку.

BLENDER_SYSTEM_PYTHON:

Директорія для заміни Python бібліотек, що містяться в пакунку.

BLENDER_CUSTOM_SPLASH:

Повний шлях до зображення, яке замінює заставку.

BLENDER_CUSTOM_SPLASH_BANNER:

Повний шлях до зображення, щоб перекрити на заставці.

BLENDER_OCIO:

Шлях для перевизначення файлу конфігурації OpenColorIO. Якщо не встановлено, OCIO змінні середовища буде використана.

SPNAV_SOCKET:

Шлях до сокету, щоб приєднатись до деймону 3D-миші (лише Unix).

TEMP:

Зберігати тимчасові файли тут (MS-Windows).

TMPDIR:

Зберігати тимчасові файли тут (UNIX Системи). Шлях повинен відповідати директорії яка існує або буде зігнорований.