.TH "BLENDER" "1" "1 سپتامبر 2026" "Blender 5\&.2\&.1 LTS" .SH "نام (NAME)" blender \- نرم‌افزار کامل و حرفه‌ای مدل‌سازی سه‌بعدی، انیمیشن و رندرینگ .SH "خلاصه دستور (SYNOPSIS)" .B blender [args ...] [file] [args ...] .br .SH "توضیحات (DESCRIPTION)" .PP .B blender یک نرم‌افزار سه‌بعدی کامل و جامع است. این برنامه از تمام مراحل خط تولید (پایپ‌لاین) سه‌بعدی پشتیبانی می‌کند \- مدل‌سازی، ریگ‌بندی (استخوان‌بندی)، انیمیشن (پویانمایی)، شبیه‌سازی، رندرینگ، کامپوزیت (ترکیب تصاویر)، ردیابی حرکت و ویرایش ویدیو. از بلندر برای ساخت تصاویر و انیمیشن‌های سه‌بعدی، فیلم‌ها و تیزرهای تبلیغاتی، محتوا برای بازی‌های ویدیویی، مصورسازی‌های معماری و صنعتی، و مصورسازی‌های علمی استفاده می‌شود. https://www.blender.org .SH "گزینه‌ها (OPTIONS)" نحوه استفاده: blender [args ...] [file] [args ...] .br .SS "گزینه‌های رندر (Render Options):" .TP .B \-b or \-\-background .br اجرا در پس‌زمینه (اغلب برای رندر بدون رابط گرافیکی کاربر استفاده می‌شود). .br .IP دستگاه صوتی در حالت پس‌زمینه به‌طور پیش‌فرض غیرفعال است .br و با ارسال \(aq\-setaudio Default\(aq پس از آن، می‌توان دوباره آن را فعال کرد. .br .TP .B \-a or \-\-render\-anim .br رندر فریم‌ها از ابتدا تا انتها (شامل هر دو). .br .TP .B \-S or \-\-scene .br تنظیم صحنه فعال برای رندرینگ. .br .TP .B \-f or \-\-render\-frame .br رندر فریم و ذخیره آن. .br .IP * + فریم شروع به صورت نسبی، \- فریم پایان به صورت نسبی. .br * می‌توان از فهرستی از فریم‌ها که با کاما از هم جدا شده‌اند نیز استفاده کرد (بدون فاصله). .br * یک بازه از فریم‌ها را می‌توان با استفاده از جداکننده \(aq..\(aq بین فریم‌های اول و آخر (شامل هر دو) مشخص کرد. .br .IP .TP .B \-s or \-\-frame\-start .br تنظیم فریم شروع روی ، همچنین از +/\- برای فریم‌های نسبی پشتیبانی می‌کند. .br .TP .B \-e or \-\-frame\-end .br تنظیم فریم پایان روی ، همچنین از +/\- برای فریم‌های نسبی پشتیبانی می‌کند. .br .TP .B \-j or \-\-frame\-jump .br تنظیم تعداد فریم‌هایی که پس از رندر هر فریم به جلو پرش می‌شود (گام فریم). .br .TP .B \-o or \-\-render\-output .br تنظیم مسیر رندر و نام فایل. .br برای رندر به صورت نسبی نسبت به فایل blend، از \(aq//\(aq در ابتدای مسیر استفاده کنید. .br .IP می‌توانید از قابلیت‌های قالب‌بندی مسیر مانند \(aq{blend_name}\(aq در مسیر استفاده کنید. .br برای جزئیات بیشتر به مستندات بلندر درباره الگوهای مسیر مراجعه کنید. .br .IP نویسه‌های \(aq#\(aq با شماره فریم جایگزین می‌شوند و برای تعیین صفرهای پرکننده (zero padding) به کار می‌روند. .br .IP * \(aqanimation_##_test.png\(aq تبدیل می‌شود به \(aqanimation_01_test.png\(aq .br * \(aqtest\-######.png\(aq تبدیل می‌شود به \(aqtest\-000001.png\(aq .br .IP هنگامی که نام فایل شامل \(aq#\(aq نباشد، پسوند \(aq####\(aq به نام فایل اضافه می‌شود. .br .IP شماره فریم در انتهای نام فایل اضافه خواهد شد، برای مثال: .br # blender \-b animation.blend \-o //render_ \-F PNG \-x 1 \-a .br \(aq//render_\(aq تبدیل می‌شود به \(aq//render_####\(aq، و فریم‌ها را به صورت \(aq//render_0001.png\(aq می‌نویسد .br .TP .B \-E or \-\-engine .br مشخص کردن موتور رندر. .br برای مشاهده فهرست موتورهای موجود از \(aq\-E help\(aq استفاده کنید. .br .TP .B \-t or \-\-threads .br استفاده از تعداد رشته (threads) برای رندرینگ و سایر عملیات .br [1\-1024]، مقدار 0 برای استفاده از تعداد پردازنده‌های سیستم. .br .SS "گزینه‌های رندر سایکلز (Cycles Render Options):" گزینه‌های افزونه Cycles باید پس از دو خط تیره مشخص شوند. .br .TP .B \-\-cycles\-device .br تنظیم دستگاه مورد استفاده برای رندرینگ. .br گزینه‌های معتبر عبارتند از: \(aqCPU\(aq \(aqCUDA\(aq \(aqOPTIX\(aq \(aqHIP\(aq \(aqONEAPI\(aq \(aqMETAL\(aq. .br .IP افزودن +CPU به یک دستگاه GPU برای رندر همزمان روی CPU و GPU. .br .IP مثال: .br # blender \-b file.blend \-f 20 \-\- \-\-cycles\-device OPTIX .TP .B \-\-cycles\-print\-stats .br ثبت گزارش آماری درباره حافظه مصرفی و زمان رندر. .br .SS "گزینه‌های قالب و فرمت (Format Options):" .TP .B \-F or \-\-render\-format .br تنظیم قالب (فرمت) رندر. .br گزینه‌های معتبر عبارتند از: .br \(aqTGA\(aq \(aqRAWTGA\(aq \(aqJPEG\(aq \(aqIRIS\(aq \(aqPNG\(aq \(aqBMP\(aq \(aqHDR\(aq \(aqTIFF\(aq. .br .IP فرمت‌هایی که می‌توانند درون بلندر کامپایل شوند، اما در همه سیستم‌ها در دسترس نیستند: .br \(aqOPEN_EXR\(aq \(aqOPEN_EXR_MULTILAYER\(aq \(aqFFMPEG\(aq \(aqCINEON\(aq \(aqDPX\(aq \(aqJP2\(aq \(aqWEBP\(aq. .br .TP .B \-x or \-\-use\-extension .br تنظیم گزینه برای اضافه کردن پسوند فایل به انتهای نام فایل. .br .IP .SS "گزینه‌های پخش پویانمایی (Animation Playback Options):" .TP .B \-a .br به جای نمایش رابط کاربری بلندر، بلندر را به عنوان یک پخش‌کننده انیمیشن اجرا می‌کند، .br تا فیلم‌ها و توالی‌های تصویری رندرشده در بلندر را مشاهده کنید (اگر \(aq\-b\(aq تنظیم شده باشد، نادیده گرفته می‌شود). .br .IP شناسه‌های پخش: .br .IP \-p .br باز کردن با گوشه پایین سمت چپ در , . .br \-m .br خواندن از دیسک (بدون ذخیره در بافر). .br \-f .br مشخص کردن FPS برای شروع. .br \-j .br تنظیم گام فریم به . .br \-s .br پخش از فریم . .br \-e .br پخش تا فریم . .br \-c .br میزان حافظه بر حسب مگابایت برای اختصاص به حافظه موقت (کش) تصاویر هنگام پخش. .br مقدار صفر آن را غیرفعال می‌کند (در عوض به تعداد ثابتی از فریم‌ها محدود می‌شود). .br .IP .SS "گزینه‌های پنجره (Window Options):" .TP .B \-w or \-\-window\-border .br اجبار به باز شدن با حاشیه، در حالت عادی (بزرگ‌نمایی‌نشده). .br .TP .B \-M or \-\-window\-maximized .br اجبار به باز شدن در حالت بیشینه (Maximized). .br .TP .B \-W or \-\-window\-fullscreen .br اجبار به باز شدن تمام‌صفحه (Fullscreen). .br .TP .B \-p or \-\-window\-geometry .br باز کردن با گوشه پایین سمت چپ در , و عرض و ارتفاع به صورت , . .br .TP .B \-con or \-\-start\-console .br شروع با پنجره کنسول باز (اگر \(aq\-b\(aq تنظیم شده باشد نادیده گرفته می‌شود)، (فقط ویندوز). .br .TP .B \-\-no\-native\-pixels .br عدم استفاده از اندازه پیکسل بومی، برای نمایشگرهای با وضوح بالا (MacBook \(aqRetina\(aq). .br .TP .B \-\-no\-window\-frame .br غیرفعال کردن تمامی تزیینات و قاب پنجره (فقط لینوکس). .br .TP .B \-\-no\-window\-focus .br باز شدن در پشت سایر پنجره‌ها و بدون گرفتن فوکوس. .br .IP .SS "گزینه‌های پایتون (Python Options):" .TP .B \-y or \-\-enable\-autoexec .br فعال‌سازی اجرای خودکار اسکریپت‌های پایتون. .br .TP .B \-Y or \-\-disable\-autoexec .br غیرفعال کردن اجرای خودکار اسکریپت‌های پایتون (درایورهای پایتون و اسکریپت‌های راه‌اندازی)، (پیش‌فرض). .br .IP .TP .B \-P or \-\-python .br اجرای فایل اسکریپت پایتون مشخص‌شده. .br .TP .B \-\-python\-text .br اجرای بلوک متنی اسکریپت پایتون داده‌شده. .br .TP .B \-\-python\-expr .br اجرای عبارت مشخص‌شده به عنوان یک اسکریپت پایتون. .br .IP عبارت می‌تواند یک اسکریپت چندخطی کامل باشد؛ .br شما تنها به حداکثر طول آرگومان پلتفرم محدود هستید. .br .TP .B \-\-python\-console .br اجرای بلندر با یک کنسول تعاملی. .br .TP .B \-\-python\-exit\-code .br تنظیم کد خروج در بازه [0..255] برای خروج در صورت بروز استثنا (Exception) در پایتون .br (فقط برای اسکریپت‌های اجراشده از خط فرمان)، صفر غیرفعال می‌کند. .br .TP .B \-\-python\-use\-system\-env .br اجازه به پایتون برای استفاده از متغیرهای محیطی سیستم مانند \(aqPYTHONPATH\(aq. .br این کار همچنین محیط کاربر را فعال می‌کند، ببینید: \(aq\-\-python\-use\-user\-env\(aq. .br .TP .B \-\-python\-use\-user\-env .br اجازه به پایتون برای استفاده از پوشه site\-packages کاربر. .br این گزینه ایزوله‌سازی کامل محیط پایتون را غیرفعال می‌کند. .br .TP .B \-\-addons .br فهرستی از افزونه‌ها جداشده با کاما (بدون فاصله) برای فعال‌سازی علاوه بر افزونه‌های پیش‌فرض. .br .IP .SS "گزینه‌های شبکه (Network Options):" .TP .B \-\-online\-mode .br اجازه دسترسی به اینترنت، با نادیده گرفتن تنظیمات ترجیحی. .br .TP .B \-\-offline\-mode .br عدم اجازه دسترسی به اینترنت، با نادیده گرفتن تنظیمات ترجیحی. .br .IP .SS "گزینه‌های ثبت وقایع (Logging Options):" .TP .B \-\-log .br فعال کردن دسته‌بندی‌های ثبت وقایع، با دریافت یک آرگومان جداشده با کاما. .br .IP \-\-log "*": ثبت تمام وقایع .br \-\-log "event": ثبت تمام دسته‌هایی که با \(aqevent\(aq شروع می‌شوند. .br \-\-log "render,cycles": ثبت پیام‌های هر دو دسته render و cycles. .br \-\-log "*mesh*": ثبت تمام دسته‌های شامل زیررشته \(aqmesh\(aq. .br \-\-log "*,^operator": ثبت همه چیز به جز عملگرها، با استفاده از پیشوند \(aq^prefix\(aq برای استثنا کردن. .br .TP .B \-\-log\-level .br تنظیم سطح پرگویی (verbosity) ثبت وقایع. .br .IP fatal: فقط خطاهای مهلک .br error: فقط خطاها .br warning: هشدارها .br info: اطلاعات درباره دستگاه‌ها، فایل‌ها، پیکربندی، عملیات‌ها .br debug: پیام‌های با جزئیات برای توسعه‌دهندگان .br trace: ردگیری بسیار دقیق و پرجزئیات اجرای کد .br .TP .B \-\-log\-show\-memory .br نمایش مصرف حافظه برای هر پیام لاگ. .br .TP .B \-\-log\-show\-source .br نمایش فایل منبع و نام تابع در خروجی. .br .TP .B \-\-log\-show\-backtrace .br نمایش ردگیری پشته (backtrace) برای هر پیام لاگ (فقط ساخت‌های اشکال‌زدایی). .br .TP .B \-\-log\-file .br تنظیم فایلی برای هدایت خروجی لاگ به آن. .br .TP .B \-\-log\-list\-categories .br نمایش فهرست تمام دسته‌بندی‌های موجود برای \(aq\-\-log\(aq و خروج. .br .IP .IP .SS "گزینه‌های اشکال‌زدایی (Debug Options):" .TP .B \-d or \-\-debug .br روشن کردن حالت اشکال‌زدایی (دیباگ). .br .IP * فعال‌سازی تشخیص خطاهای حافظه .br * غیرفعال کردن تصاحب ماوس (mouse grab) (جهت تعامل با دیباگر در برخی موارد) .br * حفظ \(aqsys.stdin\(aq پایتون به جای تنظیم آن روی None .br .TP .B \-\-debug\-value .br تنظیم مقدار اشکال‌زدایی روی هنگام راه‌اندازی. .br .IP .TP .B \-\-debug\-events .br فعال کردن پیام‌های اشکال‌زدایی برای سیستم رویدادها. .br .TP .B \-\-debug\-handlers .br فعال کردن پیام‌های اشکال‌زدایی برای گرداننده‌های رویداد (Event Handlers). .br .TP .B \-\-debug\-libmv .br فعال کردن پیام‌های اشکال‌زدایی از کتابخانه libmv. .br .TP .B \-\-debug\-memory .br فعال کردن تخصیص حافظه با محافظت کامل و اشکال‌زدایی. .br .TP .B \-\-debug\-jobs .br فعال کردن تحلیل زمانی (time profiling) برای کارهای پس‌زمینه. .br .TP .B \-\-debug\-python .br فعال کردن پیام‌های اشکال‌زدایی برای پایتون. .br .TP .B \-\-debug\-depsgraph .br فعال کردن تمام پیام‌های اشکال‌زدایی نمودار وابستگی (Dependency Graph). .br .TP .B \-\-debug\-depsgraph\-eval .br فعال کردن پیام‌های اشکال‌زدایی نمودار وابستگی مربوط به ارزیابی. .br .TP .B \-\-debug\-depsgraph\-build .br فعال کردن پیام‌های اشکال‌زدایی نمودار وابستگی مربوط به ساخت نمودار. .br .TP .B \-\-debug\-depsgraph\-tag .br فعال کردن پیام‌های اشکال‌زدایی نمودار وابستگی مربوط به برچسب‌گذاری. .br .TP .B \-\-debug\-depsgraph\-no\-threads .br تغییر ارزیابی نمودار وابستگی به حالت تک‌رشته‌ای. .br .TP .B \-\-debug\-depsgraph\-time .br فعال کردن پیام‌های اشکال‌زدایی نمودار وابستگی مربوط به زمان‌بندی. .br .TP .B \-\-debug\-depsgraph\-pretty .br فعال کردن رنگ‌ها برای پیام‌های اشکال‌زدایی نمودار وابستگی. .br .TP .B \-\-debug\-depsgraph\-uid .br بررسی اعتبار شناسه‌های سراسری نشست اختصاص‌یافته به بلوک‌های داده ID. .br .TP .B \-\-debug\-ghost .br فعال کردن پیام‌های اشکال‌زدایی برای Ghost (فقط لینوکس). .br .TP .B \-\-debug\-wintab .br فعال کردن پیام‌های اشکال‌زدایی برای Wintab. .br .TP .B \-\-debug\-gpu .br فعال کردن کانتکست و اطلاعات اشکال‌زدایی GPU برای OpenGL 4.3+. .br .TP .B \-\-debug\-gpu\-force\-workarounds .br فعال کردن راه‌حل‌های موقت (workarounds) برای مشکلات متداول GPU و غیرفعال کردن تمامی افزونه‌های GPU. .br .TP .B \-\-debug\-gpu\-compile\-shaders .br کامپایل تمام شیدرهای تعریف‌شده به صورت ایستا برای آزمایش سازگاری با پلتفرم. .br .TP .B \-\-debug\-gpu\-shader\-debug\-info .br فعال کردن تولید اطلاعات اشکال‌زدایی شیدر (فقط Vulkan). .br .TP .B \-\-debug\-gpu\-scope\-capture .br ضبط دستورات GPU صادرشده در داخل نام دامنه (scope) مشخص‌شده. .br .TP .B \-\-debug\-gpu\-shader\-source .br ذخیره کد منبع کامپایل‌شده شیدر GPU برای نام شیدر داده‌شده. .br نام مشخص‌شده می‌تواند حاوی نویسه عام "*" در ابتدا یا انتها برای تطبیق با چندین شیدر باشد. .br فایل‌ها در پوشه کاری جاری درون پوشه‌ای به نام "Shaders" ذخیره می‌شوند. .br .TP .B \-\-debug\-gpu\-shader\-no\-preprocessor .br رد کردن مرحله پیش‌پردازنده و تکیه بر پیش‌پردازنده درایور یا کامپایلر شیدر. .br همچنین حذف کدهای مرده (dead code elimination) را غیرفعال می‌کند. .br .TP .B \-\-debug\-gpu\-shader\-no\-dce .br رد کردن مرحله حذف کدهای مرده. .br .TP .B \-\-debug\-gpu\-no\-texture\-pool .br غیرفعال کردن بهینه‌سازی‌های نام مستعار حافظه در استخر بافت‌های GPU. .br .TP .B \-\-debug\-gpu\-vulkan\-local\-read .br اجبار به خواندن محلی رندرینگ پویای Vulkan در صورت پشتیبانی توسط دستگاه. .br .TP .B \-\-debug\-wm .br فعال کردن پیام‌های اشکال‌زدایی برای مدیر پنجره، نمایش تمام عملگرها در جستجو، نمایش خطاهای نقشه‌کلید. .br .TP .B \-\-debug\-xr .br فعال کردن پیام‌های اشکال‌زدایی برای محیط‌های واقعیت مجازی. .br لایه‌های اعتبارسنجی OpenXR API، پیام‌های اشکال‌زدایی (OpenXR) و چاپ اطلاعات عمومی را فعال می‌کند. .br .TP .B \-\-debug\-xr\-time .br فعال کردن پیام‌های اشکال‌زدایی برای زمان‌های رندر فریم در واقعیت مجازی. .br .TP .B \-\-debug\-all .br فعال کردن تمام پیام‌های اشکال‌زدایی. .br .TP .B \-\-debug\-io .br فعال کردن پیام‌های اشکال‌زدایی برای ورودی/خروجی (I/O). .br .IP .TP .B \-\-debug\-fpe .br فعال کردن استثناهای ممیز شناور (floating\-point exceptions). .br .TP .B \-\-debug\-exit\-on\-error .br خروج فوری هنگام تشخیص خطاهای داخلی. .br .TP .B \-\-debug\-freestyle .br فعال کردن پیام‌های اشکال‌زدایی برای Freestyle. .br .TP .B \-\-console\-crash\-handler .br استفاده از کنسول برای گزارش خرابی‌ها (crash). .br .TP .B \-\-disable\-crash\-handler .br غیرفعال کردن گرداننده خرابی (crash handler). .br .TP .B \-\-disable\-abort\-handler .br غیرفعال کردن گرداننده توقف اجباری (abort handler). .br .TP .B \-\-verbose .br تنظیم سطح پرگویی برای پیام‌های اشکال‌زدایی که از آن پشتیبانی می‌کنند. .br .TP .B \-q or \-\-quiet .br جلوگیری از چاپ وضعیت (هشدارها و خطاها همچنان چاپ می‌شوند). .br .IP .SS "گزینه‌های پردازنده گرافیکی (GPU Options):" .TP .B \-\-gpu\-backend .br اجبار به استفاده از یک بک‌اند گرافیکی خاص. گزینه‌های معتبر: \(aqopengl\(aq یا \(aqvulkan\(aq. .br .TP .B \-\-gpu\-device .br انتخاب یک دستگاه GPU مشخص، با نادیده گرفتن دستگاه GPU در تنظیمات کاربری تنها برای این .br اجرا. قالب‌های قابل قبول: .br .IP * \(aq//\(aq (منطبق بر شناسه استفاده‌شده در ترجیحات .br کاربر، با شناسه PCI سازنده، شناسه PCI دستگاه و شاخص شمارش همگی به صورت هگزادسیمال). .br * \(aq\(aq (بدون اسلش) انتخاب N\-امین دستگاه پشتیبانی‌شده بر اساس ترتیب شمارش، به صورت ده‌دهی. .br * \(aqhelp\(aq چاپ دستگاه‌های Vulkan پشتیبانی‌شده و خروج. .br .IP تنها با بک‌اند Vulkan استفاده می‌شود. سایر بک‌اندها یک هشدار چاپ کرده و این گزینه را نادیده می‌گیرند. .br اگر دستگاه Vulkan درخواست‌شده در دسترس نباشد، بلندر به ترجیح ذخیره‌شده GPU .br بازمی‌گردد مگر اینکه \(aq\-\-gpu\-device\-no\-fallback\(aq نیز تنظیم شده باشد. .br .TP .B \-\-gpu\-device\-no\-fallback .br شکست به جای بازگشت به حالت پیش‌فرض زمانی که \(aq\-\-gpu\-device\(aq با هیچ دستگاه Vulkan قابل استفاده‌ای تطابق ندارد. .br .TP .B \-\-gpu\-vsync .br تنظیم VSync (همگام‌سازی عمودی). .br گزینه‌های معتبر عبارتند از: \(aqon\(aq، \(aqoff\(aq و \(aqauto\(aq برای همگام‌سازی انطباقی. .br .IP * تنظیمات پیش‌فرض به درایور GPU بستگی دارد. .br * غیرفعال کردن VSync می‌تواند برای آزمایش کارایی مفید باشد. .br * مقدار \(aqauto\(aq تنها توسط بک‌اند OpenGL پشتیبانی می‌شود. .br .TP .B \-\-gpu\-compilation\-subprocesses .br بازنویسی تنظیم حداکثر زیرفرآیندهای کامپایل (فقط OpenGL). .br .TP .B \-\-profile\-gpu .br فعال کردن پروفایل کارایی CPU و GPU برای گروه‌های اشکال‌زدایی GPU .br (یک فایل profile.json در قالب Trace Event Format در پوشه کاری جاری خروجی می‌دهد) .br .IP .SS "سایر گزینه‌ها (Misc Options):" .TP .B \-\-open\-last .br باز کردن آخرین فایل blend بازشده، به جای فایل راه‌اندازی پیش‌فرض. .br .TP .B \-\-app\-template