گزینه‌های رندر (Render Options):

-b or --background

اجرا در پس‌زمینه (اغلب برای رندر بدون رابط گرافیکی کاربر استفاده می‌شود).

دستگاه صوتی در حالت پس‌زمینه به‌طور پیش‌فرض غیرفعال است
و با ارسال '-setaudio Default' پس از آن، می‌توان دوباره آن را فعال کرد.

-a or --render-anim

رندر فریم‌ها از ابتدا تا انتها (شامل هر دو).

-S or --scene <name>

تنظیم صحنه فعال <name> برای رندرینگ.

-f or --render-frame <frame>

رندر فریم <frame> و ذخیره آن.

* +<frame> فریم شروع به صورت نسبی، -<frame> فریم پایان به صورت نسبی.
* می‌توان از فهرستی از فریم‌ها که با کاما از هم جدا شده‌اند نیز استفاده کرد (بدون فاصله).
* یک بازه از فریم‌ها را می‌توان با استفاده از جداکننده '..' بین فریم‌های اول و آخر (شامل هر دو) مشخص کرد.

-s or --frame-start <frame>

تنظیم فریم شروع روی <frame>، همچنین از +/- برای فریم‌های نسبی پشتیبانی می‌کند.

-e or --frame-end <frame>

تنظیم فریم پایان روی <frame>، همچنین از +/- برای فریم‌های نسبی پشتیبانی می‌کند.

-j or --frame-jump <frames>

تنظیم تعداد فریم‌هایی که پس از رندر هر فریم به جلو پرش می‌شود (گام فریم).

-o or --render-output <path>

تنظیم مسیر رندر و نام فایل.
برای رندر به صورت نسبی نسبت به فایل blend، از '//' در ابتدای مسیر استفاده کنید.

می‌توانید از قابلیت‌های قالب‌بندی مسیر مانند '{blend_name}' در مسیر استفاده کنید.
برای جزئیات بیشتر به مستندات بلندر درباره الگوهای مسیر مراجعه کنید.

نویسه‌های '#' با شماره فریم جایگزین می‌شوند و برای تعیین صفرهای پرکننده (zero padding) به کار می‌روند.

* '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 or --engine <engine>

مشخص کردن موتور رندر.
برای مشاهده فهرست موتورهای موجود از '-E help' استفاده کنید.

-t or --threads <threads>

استفاده از تعداد <threads> رشته (threads) برای رندرینگ و سایر عملیات
[1-1024]، مقدار 0 برای استفاده از تعداد پردازنده‌های سیستم.

گزینه‌های رندر سایکلز (Cycles Render Options):

گزینه‌های افزونه 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

ثبت گزارش آماری درباره حافظه مصرفی و زمان رندر.

گزینه‌های قالب و فرمت (Format Options):

-F or --render-format <format>

تنظیم قالب (فرمت) رندر.
گزینه‌های معتبر عبارتند از:
'TGA' 'RAWTGA' 'JPEG' 'IRIS' 'PNG' 'BMP' 'HDR' 'TIFF'.

فرمت‌هایی که می‌توانند درون بلندر کامپایل شوند، اما در همه سیستم‌ها در دسترس نیستند:
'OPEN_EXR' 'OPEN_EXR_MULTILAYER' 'FFMPEG' 'CINEON' 'DPX' 'JP2' 'WEBP'.

-x or --use-extension <bool>

تنظیم گزینه برای اضافه کردن پسوند فایل به انتهای نام فایل.

گزینه‌های پخش پویانمایی (Animation Playback Options):

-a <options> <file(s)>

به جای نمایش رابط کاربری بلندر، بلندر را به عنوان یک پخش‌کننده انیمیشن اجرا می‌کند،
تا فیلم‌ها و توالی‌های تصویری رندرشده در بلندر را مشاهده کنید (اگر '-b' تنظیم شده باشد، نادیده گرفته می‌شود).

شناسه‌های پخش:

-p <sx> <sy>
باز کردن با گوشه پایین سمت چپ در <sx>, <sy>.
-m
خواندن از دیسک (بدون ذخیره در بافر).
-f <fps> <fps_base>
مشخص کردن FPS برای شروع.
-j <frame>
تنظیم گام فریم به <frame>.
-s <frame>
پخش از فریم <frame>.
-e <frame>
پخش تا فریم <frame>.
-c <cache_memory>
میزان حافظه بر حسب مگابایت برای اختصاص به حافظه موقت (کش) تصاویر هنگام پخش.
مقدار صفر آن را غیرفعال می‌کند (در عوض به تعداد ثابتی از فریم‌ها محدود می‌شود).

گزینه‌های پنجره (Window Options):

-w or --window-border

اجبار به باز شدن با حاشیه، در حالت عادی (بزرگ‌نمایی‌نشده).

-M or --window-maximized

اجبار به باز شدن در حالت بیشینه (Maximized).

-W or --window-fullscreen

اجبار به باز شدن تمام‌صفحه (Fullscreen).

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

باز کردن با گوشه پایین سمت چپ در <sx>, <sy> و عرض و ارتفاع به صورت <w>, <h>.

-con or --start-console

شروع با پنجره کنسول باز (اگر '-b' تنظیم شده باشد نادیده گرفته می‌شود)، (فقط ویندوز).

--no-native-pixels

عدم استفاده از اندازه پیکسل بومی، برای نمایشگرهای با وضوح بالا (MacBook 'Retina').

--no-window-frame

غیرفعال کردن تمامی تزیینات و قاب پنجره (فقط لینوکس).

--no-window-focus

باز شدن در پشت سایر پنجره‌ها و بدون گرفتن فوکوس.

گزینه‌های پایتون (Python Options):

-y or --enable-autoexec

فعال‌سازی اجرای خودکار اسکریپت‌های پایتون.

-Y or --disable-autoexec

غیرفعال کردن اجرای خودکار اسکریپت‌های پایتون (درایورهای پایتون و اسکریپت‌های راه‌اندازی)، (پیش‌فرض).

-P or --python <filepath>

اجرای فایل اسکریپت پایتون مشخص‌شده.

--python-text <name>

اجرای بلوک متنی اسکریپت پایتون داده‌شده.

--python-expr <expression>

اجرای عبارت مشخص‌شده به عنوان یک اسکریپت پایتون.

عبارت می‌تواند یک اسکریپت چندخطی کامل باشد؛
شما تنها به حداکثر طول آرگومان پلتفرم محدود هستید.

--python-console

اجرای بلندر با یک کنسول تعاملی.

--python-exit-code <code>

تنظیم کد خروج در بازه [0..255] برای خروج در صورت بروز استثنا (Exception) در پایتون
(فقط برای اسکریپت‌های اجراشده از خط فرمان)، صفر غیرفعال می‌کند.

--python-use-system-env

اجازه به پایتون برای استفاده از متغیرهای محیطی سیستم مانند 'PYTHONPATH'.
این کار همچنین محیط کاربر را فعال می‌کند، ببینید: '--python-use-user-env'.

--python-use-user-env

اجازه به پایتون برای استفاده از پوشه site-packages کاربر.
این گزینه ایزوله‌سازی کامل محیط پایتون را غیرفعال می‌کند.

--addons <addon(s)>

فهرستی از افزونه‌ها جداشده با کاما (بدون فاصله) برای فعال‌سازی علاوه بر افزونه‌های پیش‌فرض.

گزینه‌های شبکه (Network Options):

--online-mode

اجازه دسترسی به اینترنت، با نادیده گرفتن تنظیمات ترجیحی.

--offline-mode

عدم اجازه دسترسی به اینترنت، با نادیده گرفتن تنظیمات ترجیحی.

گزینه‌های ثبت وقایع (Logging Options):

--log <match>

فعال کردن دسته‌بندی‌های ثبت وقایع، با دریافت یک آرگومان جداشده با کاما.

--log "*": ثبت تمام وقایع
--log "event": ثبت تمام دسته‌هایی که با 'event' شروع می‌شوند.
--log "render,cycles": ثبت پیام‌های هر دو دسته render و cycles.
--log "*mesh*": ثبت تمام دسته‌های شامل زیررشته 'mesh'.
--log "*,^operator": ثبت همه چیز به جز عملگرها، با استفاده از پیشوند '^prefix' برای استثنا کردن.

--log-level <level>

تنظیم سطح پرگویی (verbosity) ثبت وقایع.

fatal: فقط خطاهای مهلک
error: فقط خطاها
warning: هشدارها
info: اطلاعات درباره دستگاه‌ها، فایل‌ها، پیکربندی، عملیات‌ها
debug: پیام‌های با جزئیات برای توسعه‌دهندگان
trace: ردگیری بسیار دقیق و پرجزئیات اجرای کد

--log-show-memory

نمایش مصرف حافظه برای هر پیام لاگ.

--log-show-source

نمایش فایل منبع و نام تابع در خروجی.

--log-show-backtrace

نمایش ردگیری پشته (backtrace) برای هر پیام لاگ (فقط ساخت‌های اشکال‌زدایی).

--log-file <filepath>

تنظیم فایلی برای هدایت خروجی لاگ به آن.

--log-list-categories

نمایش فهرست تمام دسته‌بندی‌های موجود برای '--log' و خروج.

گزینه‌های اشکال‌زدایی (Debug Options):

-d or --debug

روشن کردن حالت اشکال‌زدایی (دیباگ).

* فعال‌سازی تشخیص خطاهای حافظه
* غیرفعال کردن تصاحب ماوس (mouse grab) (جهت تعامل با دیباگر در برخی موارد)
* حفظ 'sys.stdin' پایتون به جای تنظیم آن روی None

--debug-value <value>

تنظیم مقدار اشکال‌زدایی روی <value> هنگام راه‌اندازی.

--debug-events

فعال کردن پیام‌های اشکال‌زدایی برای سیستم رویدادها.

--debug-handlers

فعال کردن پیام‌های اشکال‌زدایی برای گرداننده‌های رویداد (Event Handlers).

--debug-libmv

فعال کردن پیام‌های اشکال‌زدایی از کتابخانه libmv.

--debug-memory

فعال کردن تخصیص حافظه با محافظت کامل و اشکال‌زدایی.

--debug-jobs

فعال کردن تحلیل زمانی (time profiling) برای کارهای پس‌زمینه.

--debug-python

فعال کردن پیام‌های اشکال‌زدایی برای پایتون.

--debug-depsgraph

فعال کردن تمام پیام‌های اشکال‌زدایی نمودار وابستگی (Dependency Graph).

--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 (فقط لینوکس).

--debug-wintab

فعال کردن پیام‌های اشکال‌زدایی برای Wintab.

--debug-gpu

فعال کردن کانتکست و اطلاعات اشکال‌زدایی GPU برای OpenGL 4.3+.

--debug-gpu-force-workarounds

فعال کردن راه‌حل‌های موقت (workarounds) برای مشکلات متداول GPU و غیرفعال کردن تمامی افزونه‌های GPU.

--debug-gpu-compile-shaders

کامپایل تمام شیدرهای تعریف‌شده به صورت ایستا برای آزمایش سازگاری با پلتفرم.

--debug-gpu-shader-debug-info

فعال کردن تولید اطلاعات اشکال‌زدایی شیدر (فقط Vulkan).

--debug-gpu-scope-capture

ضبط دستورات GPU صادرشده در داخل نام دامنه (scope) مشخص‌شده.

--debug-gpu-shader-source

ذخیره کد منبع کامپایل‌شده شیدر GPU برای نام شیدر داده‌شده.
نام مشخص‌شده می‌تواند حاوی نویسه عام "*" در ابتدا یا انتها برای تطبیق با چندین شیدر باشد.
فایل‌ها در پوشه کاری جاری درون پوشه‌ای به نام "Shaders" ذخیره می‌شوند.

--debug-gpu-shader-no-preprocessor

رد کردن مرحله پیش‌پردازنده و تکیه بر پیش‌پردازنده درایور یا کامپایلر شیدر.
همچنین حذف کدهای مرده (dead code elimination) را غیرفعال می‌کند.

--debug-gpu-shader-no-dce

رد کردن مرحله حذف کدهای مرده.

--debug-gpu-no-texture-pool

غیرفعال کردن بهینه‌سازی‌های نام مستعار حافظه در استخر بافت‌های 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

فعال کردن استثناهای ممیز شناور (floating-point exceptions).

--debug-exit-on-error

خروج فوری هنگام تشخیص خطاهای داخلی.

--debug-freestyle

فعال کردن پیام‌های اشکال‌زدایی برای Freestyle.

--console-crash-handler

استفاده از کنسول برای گزارش خرابی‌ها (crash).

--disable-crash-handler

غیرفعال کردن گرداننده خرابی (crash handler).

--disable-abort-handler

غیرفعال کردن گرداننده توقف اجباری (abort handler).

--verbose <verbose>

تنظیم سطح پرگویی برای پیام‌های اشکال‌زدایی که از آن پشتیبانی می‌کنند.

-q or --quiet

جلوگیری از چاپ وضعیت (هشدارها و خطاها همچنان چاپ می‌شوند).

گزینه‌های پردازنده گرافیکی (GPU Options):

--gpu-backend

اجبار به استفاده از یک بک‌اند گرافیکی خاص. گزینه‌های معتبر: 'opengl' یا 'vulkan'.

--gpu-device <device>

انتخاب یک دستگاه GPU مشخص، با نادیده گرفتن دستگاه GPU در تنظیمات کاربری تنها برای این
اجرا. قالب‌های قابل قبول:

* '<vendor-hex>/<device-hex>/<index-hex>' (منطبق بر شناسه استفاده‌شده در ترجیحات
کاربر، با شناسه PCI سازنده، شناسه PCI دستگاه و شاخص شمارش همگی به صورت هگزادسیمال).
* '<index>' (بدون اسلش) انتخاب N-امین دستگاه پشتیبانی‌شده بر اساس ترتیب شمارش، به صورت ده‌دهی.
* 'help' چاپ دستگاه‌های Vulkan پشتیبانی‌شده و خروج.

تنها با بک‌اند Vulkan استفاده می‌شود. سایر بک‌اندها یک هشدار چاپ کرده و این گزینه را نادیده می‌گیرند.
اگر دستگاه Vulkan درخواست‌شده در دسترس نباشد، بلندر به ترجیح ذخیره‌شده GPU
بازمی‌گردد مگر اینکه '--gpu-device-no-fallback' نیز تنظیم شده باشد.

--gpu-device-no-fallback

شکست به جای بازگشت به حالت پیش‌فرض زمانی که '--gpu-device' با هیچ دستگاه Vulkan قابل استفاده‌ای تطابق ندارد.

--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' برای عدم استفاده از الگو استفاده کنید.

-X or --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 or --command <command>

اجرای یک دستور که تمام شناسه‌های باقی‌مانده را مصرف می‌کند.
برای مشاهده فهرست تمام دستورات دیگر از '-c help' استفاده کنید.
عبارت '--help' را پس از دستور وارد کنید تا متن راهنمای آن را ببینید.

این گزینه حالت '--background' را اعمال می‌کند.

-h or --help

چاپ این متن راهنما و خروج.

/?

چاپ این متن راهنما و خروج (فقط ویندوز).

-r or --register

ثبت پسوند فایل blend برای کاربر فعلی، و سپس خروج (فقط ویندوز و لینوکس).

--register-allusers

ثبت پسوند فایل blend برای تمام کاربران، و سپس خروج (فقط ویندوز و لینوکس).

--unregister

لغو ثبت پسوند فایل blend برای کاربر فعلی، و سپس خروج (فقط ویندوز و لینوکس).

--unregister-allusers

لغو ثبت پسوند فایل blend برای تمام کاربران، و سپس خروج (فقط ویندوز و لینوکس).

--qos <level>

تنظیم حالت کیفیت خدمات (QoS) برای معماری‌های ترکیبی پردازنده (فقط ویندوز).

default: از رفتار پیش‌فرض سیستم‌عامل استفاده می‌کند.
high: همیشه از هسته‌های با کارایی بالا (performance cores) استفاده می‌کند.
eco: زمان‌بندی رشته‌های بلندر منحصراً روی هسته‌های کم‌مصرف (efficiency cores).

-v or --version

چاپ نسخه بلندر و خروج.

--

پایان پردازش گزینه‌ها، شناسه‌های بعدی بدون تغییر منتقل می‌شوند. دسترسی از طریق 'sys.argv' در پایتون.

سایر گزینه‌ها (Other Options):

--disable-depsgraph-on-file-load

حالت پس‌زمینه: عدم ساخت و ارزیابی سیستماتیک نمودارهای وابستگی ViewLayers
هنگام بارگذاری فایل blend در حالت پس‌زمینه (گزینه‌های '-b' یا '-c').

اسکریپت‌هایی که به داده‌های ارزیابی‌شده نیاز دارند باید صراحتاً اطمینان حاصل کنند که
یک نمودار وابستگی ارزیابی‌شده در دسترس است
(مثلاً با فراخوانی 'depsgraph = context.evaluated_depsgraph_get()').

نکته: این یک گزینه موقت است، در آینده نمودار وابستگی هرگز به طور خودکار
هنگام بارگذاری فایل در حالت پس‌زمینه تولید نخواهد شد.

--disable-liboverride-auto-resync

عدم انجام همگام‌سازی مجدد خودکار جایگزینی کتابخانه (library override) هنگام بارگذاری فایل 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
...همان‌طور که انتظار می‌رود کار می‌کند.