| F3D(1) | دستورهای کاربری | F3D(1) |
نام (NAME)
F3D - نمایشگر سه‌بعدی سریع و کمینه‌گرا
توضیحات (DESCRIPTION)
F3D - یک نمایشگر سه‌بعدی سریع و کمینه‌گرا کاربرد:
- f3d [OPTIONS...] file1 file2 ...
- گزینه‌های کاربردی:
- --input <files>
- فایل‌های ورودی
- -D, --define libf3d.option=value
- تعریف گزینه‌های libf3d
- -R, --reset libf3d.option
- بازنشانی گزینه‌های libf3d
- --output <png file>
- رندر گرفتن در فایل
- --no-background [=<bool>(=1)]
- بدون پس‌زمینه هنگام رندر در فایل (پیش‌فرض: false)
- -h, --help
- نمایش راهنما
- --version
- نمایش جزئیات نسخه
- --list-readers
- نمایش فهرست خواننده‌ها (readers)
- --force-reader <reader>
- اجبار به استفاده از یک خواننده مشخص، بدون در نظر گرفتن پسوند فایل
- --list-bindings [=<bool>(=1)]
- چاپ فهرست کلیدهای میانبر و تعاملات و خروج، با `--no-render` نادیده گرفته می‌شود، فقط اولین گروه فایلی را در نظر می‌گیرد. (پیش‌فرض: false)
- --config <filePath/filename/fileStem>
- مشخص کردن فایل پیکربندی مورد استفاده. مسیر مطلق/نسبی یا نام فایل/ریشه نام فایل جهت جستجو در مکان‌های فایل پیکربندی
- --no-config [=<bool>(=1)]
- فایل پیکربندی خوانده نشود (پیش‌فرض: false)
- --no-render [=<bool>(=1)]
- هیچ چیزی رندر نشود و بلافاصله پس از بارگذاری اولین فایل خارج شود؛ برای بازیابی اطلاعات مربوط به یک فایل همراه با --verbose استفاده شود. (پیش‌فرض: false)
- --rendering-backend <string>
- بک‌اند مورد استفاده برای رندر (auto|glx|wgl|egl|osmesa) (پیش‌فرض: auto)
- --list-rendering-backends
- نمایش فهرست بک‌اندهای رندر موجود در این سیستم
- --max-size <size in Mib>
- حداکثر اندازه فایل برای بارگذاری بر حسب مبی‌بایت (Mib)، برای حالت نامحدود خالی بگذارید
- --dpi-aware [=<bool>(=1)]
- مقیاس‌بندی فونت و وضوح پنجره متناسب با مقیاس سیستم (پیش‌فرض: false)
- --watch [=<bool>(=1)]
- رصد فایل جاری و بارگذاری مجدد خودکار آن به محض هرگونه تغییر روی دیسک (پیش‌فرض: false)
- --frame-rate <fps>
- نرخ فریم استفاده‌شده برای تازه‌سازی پویانمایی و دیگر وظایف تکرارشونده (رصد، رابط کاربری). بر نرخ فریم رندر تأثیری ندارد. (پیش‌فرض: 30.0)
- --load-plugins <paths or names>
- فهرست افزونه‌ها جهت بارگذاری، جداشده با کاما
- --scan-plugins
- پویش دایرکتوری‌های استاندارد برای افزونه‌ها و نمایش افزونه‌های موجود (نتیجه ممکن است ناقص باشد)
- --screenshot-filename <filename>
- نام فایل تصویر صفحه (پیش‌فرض: {app}/{model}_{n}.png)
- گزینه‌های عمومی:
- --verbose [={debug, info, warning, error, quiet}(=debug)]
- تنظیم سطح گزارش جزئیات، ارائه اطلاعات بیشتر درباره داده‌های بارگذاری‌شده در خروجی کنسول (پیش‌فرض: info)
- --loading-progress [=<bool>(=1)]
- نمایش نوار پیشرفت بارگذاری (پیش‌فرض: false)
- --animation-progress [=<bool>(=1)]
- نمایش نوار پیشرفت پویانمایی (پیش‌فرض: false)
- --multi-file-mode <single|all|dir>
- انتخاب رفتار هنگام باز کردن چندین فایل. مقدار "single" یک فایل را در هر لحظه نشان می‌دهد، "all" همه فایل‌ها را در یک صحنه منفرد نمایش می‌دهد، "dir" فایل‌های موجود در یک دایرکتوری مشترک را در همان صحنه نمایش می‌دهد. (پیش‌فرض: single)
- --multi-file-regex <regex>
- الگوی عبارت باقاعده برای گروه‌بندی فایل‌ها. گروه‌های ضبط‌شده با "*" جایگزین می‌شوند به‌طوری که برای نمونه، الگوی "part(\d+)" فایل‌های "foo-part1.xyz" و "foo-part2.xyz" را با یکدیگر به‌صورت "foo-part*.xyz" گروه‌بندی می‌کند
- --recursive-dir-add [=<bool>(=1)]
- افزودن دایرکتوری‌ها به‌صورت بازگشتی (پیش‌فرض: false)
- --remove-empty-file-groups [=<bool>(=1)]
- حذف گروه‌های فایلی که منجر به یک صحنه خالی می‌شوند (پیش‌فرض: false)
- --up <direction>
- جهت بالا (پیش‌فرض: +Y)
- -x, --axis [=<bool>(=1)]
- نمایش محورها (پیش‌فرض: false)
- -g, --grid [=<bool>(=1)]
- نمایش شبکه (پیش‌فرض: false)
- --x-color <color>
- رنگ محور X (پیش‌فرض: #f94306)
- --y-color <color>
- رنگ محور Y (پیش‌فرض: #7aff7a)
- --z-color <color>
- رنگ محور Z (پیش‌فرض: #788bff)
- --grid-absolute [=<bool>(=1)]
- قرار دادن شبکه در مبدأ مطلق به‌جای قرارگیری در زیر مدل (پیش‌فرض: false)
- --grid-unit <value>
- اندازه مربع واحد شبکه، به‌طور پیش‌فرض به‌صورت خودکار محاسبه می‌شود
- --grid-subdivisions <value>
- تعداد تقسیمات فرعی شبکه (پیش‌فرض: 10)
- --grid-color <color>
- رنگ خطوط اصلی شبکه (پیش‌فرض: #000000)
- --axes-grid [=<bool>(=1)]
- فعال‌سازی محورهای شبکه (پیش‌فرض: false)
- -e, --edges [=<bool>(=1)]
- نمایش لبه‌های سلول
- --armature [=<bool>(=1)]
- فعال‌سازی مصورسازی آرماتور/اسکلت (پیش‌فرض: false).TP --camera-index <index> انتخاب دوربین مورد استفاده
- -k, --interaction-style [=<style>(=2d)]
- سبک تعامل (پیش‌فرض: default)
- --interaction-trackball [=<bool>(=1)]
- فعال‌سازی تعامل گوی‌ردان (منسوخ شده، از --interaction-style=trackball استفاده کنید) (پیش‌فرض: false)
- --invert-zoom [=<bool>(=1)]
- معکوس کردن جهت بزرگ‌نمایی با کلیک‌راست ماوس (پیش‌فرض: false)
- --animation-autoplay [=<bool>(=1)]
- شروع خودکار پویانمایی (پیش‌فرض: false)
- --animation-index <index>
- انتخاب پویانمایی برای نمایش (منسوخ شده) (پیش‌فرض: 0)
- --animation-indices <index,index,index>
- انتخاب پویانمایی‌ها برای نمایش (پیش‌فرض: 0)
- --animation-speed-factor <ratio>
- تنظیم ضریب سرعت پویانمایی (پیش‌فرض: 1)
- --animation-time <time>
- تنظیم زمان پویانمایی برای بارگذاری
- --font-file <file_path>
- مسیر فایل قلم سازگار با FreeType
- --font-scale <ratio>
- مقیاس قلم‌ها (پیش‌فرض: 1)
- --font-color <color>
- تنظیم رنگ قلم (پیش‌فرض: 0.957,0.957,0.957)
- --backdrop-opacity <value>
- کدری پس‌زمینهٔ رابط کاربری (پیش‌فرض: 0.9)
- --command-script <file_path>
- مسیر فایل اسکریپت حاوی دستورها برای اجرا
- --normal-glyphs [=<bool>(=1)]
- فعال‌سازی گلیف‌های عادی (پیش‌فرض: false)
- گزینه‌های مَتریال (Material options):
- -o, --point-sprites [=<string>(=sphere)]
- انتخاب نوع point sprites ("none"، "sphere"، "gaussian"، "circle"، "stddev"، "bound") (پیش‌فرض: none)
- --point-sprites-type <sphere|gaussian>
- نوع point sprites (منسوخ شده)
- --point-sprites-size <size>
- اندازهٔ کرهٔ point sprites (پیش‌فرض: 10)
- --point-sprites-absolute-size [=<bool>(=1)]
- عدم مقیاس‌بندی اندازهٔ point sprites بر اساس اندازهٔ صحنه (پیش‌فرض: false)
- --point-size <size>
- اندازهٔ نقطه هنگام نمایش رأس‌ها، تعیین‌شده توسط مدل در حالت پیش‌فرض
- --line-width <width>
- عرض خط هنگام نمایش لبه‌ها، تعیین‌شده توسط مدل در حالت پیش‌فرض
- --backface-type <visible|hidden>
- نوع وجه پشتی (backface)، می‌تواند visible یا hidden باشد، تعیین‌شده توسط مدل در حالت پیش‌فرض
- --color <color>
- رنگ یکدست
- --opacity <opacity>
- کدری (میزان ماتی)
- --roughness <roughness>
- ضریب زبری (0.0-1.0)
- --metallic <metallic>
- ضریب فلزی (0.0-1.0)
- --base-ior <base-ior>
- ضریب شکست (Index Of Refraction) لایهٔ پایه (1.0-2.5)
- --hdri-file <file path>
- مسیر فایل تصویری که می‌تواند به عنوان منبع نور و skybox استفاده شود
- -f, --hdri-ambient [=<bool>(=1)]
- فعال‌سازی نور محیطی HDRI (پیش‌فرض: false)
- -j, --hdri-skybox [=<bool>(=1)]
- فعال‌سازی پس‌زمینهٔ آسمان‌نما (skybox) اچ‌دی‌آر‌آی (پیش‌فرض: false)
- --texture-matcap <file path>
- مسیر فایل بافت حاوی مشخصات ضبط ماده (material capture)
- --texture-base-color <file path>
- مسیر فایل بافتی که رنگ شیء را تعیین می‌کند
- --texture-material <file path>
- مسیر فایل بافتی که مقادیر انسداد (Occlusion)، زبری (Roughness) و فلزی بودن (Metallic) شیء را تعیین می‌کند
- --texture-emissive <file path>
- مسیر فایل بافتی که نور تابیده‌شده از شیء را تعیین می‌کند
- --textures-transform <transform2d>
- ماتریس 3x3 برای تبدیل بافت‌ها
- --emissive-factor <color>
- ضریب تابش. این مقدار هنگام وجود بافت تابشی، در رنگ تابش ضرب می‌شود
- --texture-normal <file path>
- مسیر فایل بافتی که نقشهٔ بردار نرمال (normal map) شیء را تعیین می‌کند
- --checkerboard [=<bool>(=1)]
- اعمال بافت شطرنجی بر روی اشیاء (پیش‌فرض: false)
- --normal-scale <normalScale>
- مقیاس نرمال بر میزان شدت انحراف نرمال از بافت تأثیر می‌گذارد
- --unlit [=<bool>(=1)]
- نادیده گرفتن سایه‌زنی و بی‌نور کردن ماده
- گزینه‌های پنجره (Window options):
- --background-color <color>
- رنگ پس‌زمینه (پیش‌فرض: #333333)
- --resolution <width,height>
- وضوح تصویر پنجره (پیش‌فرض: 1000, 600)
- --position <x,y>
- موقعیت پنجره
- -z, --fps [=<bool>(=1)]
- نمایش نرخ فریم بر ثانیه در رندر (پیش‌فرض: false)
- -n, --filename [=<bool>(=1)]
- نمایش نام فایل (پیش‌فرض: false)
- -m, --metadata [=<bool>(=1)]
- نمایش فراداده‌های فایل (پیش‌فرض: false)
- --scene-hierarchy [=<bool>(=1)]
- نمایش ابزارک سلسله‌مراتب صحنه (پیش‌فرض: false)
- --notifications [=<bool>(=1)]
- نمایش اعلان‌ها (پیش‌فرض: false)
- --hdri-filename [=<bool>(=1)]
- نمایش نام فایل hdri (پیش‌فرض: false)
- -u, --blur-background [=<bool>(=1)]
- تار کردن پس‌زمینه (پیش‌فرض: false).TP --blur-coc <value> شعاع دایره ابهام مات‌شدگی (circle of confusion) (پیش‌فرض: 20)
- --light-intensity <value>
- شدت نور (پیش‌فرض: 1)
- گزینه‌های مصورسازی علمی:
- -s, --scalar-coloring [=<bool>(=1)]
- رنگ‌آمیزی بر اساس آرایه اسکالر (پیش‌فرض: false)
- --coloring-array <array_name>
- نام آرایه برای استفاده در رنگ‌آمیزی
- -y, --coloring-component [=<comp_index>(=-2)]
- مؤلفه‌ای از آرایه برای رنگ‌آمیزی با آن. مقدار -1 به معنای بزرگی (magnitude)، مقدار -2 یا گزینه کوتاه، -y، به معنای اسکالرهای مستقیم است (پیش‌فرض: -1)
- -c, --coloring-by-cells [=<bool>(=1)]
- استفاده از یک آرایه از سلول‌ها (پیش‌فرض: false)
- --coloring-range <min,max>
- بازه سفارشی برای رنگ‌آمیزی بر اساس آرایه، به‌طور پیش‌فرض به‌صورت خودکار محاسبه می‌شود
- -b, --coloring-scalar-bar [=<bool>(=1)]
- نمایش نوار اسکالر (پیش‌فرض: false)
- --colormap-file <filePath/filename/fileStem>
- مشخص کردن تصویر نقشه‌رنگ (colormap)
- --colormap-discretization <int>
- مشخص کردن تعداد رنگ‌ها در نقشه‌رنگ
- --colormap <color_list>
- مشخص کردن یک نقشه‌رنگ سفارشی (در صورت مشخص شدن "colormap-file" نادیده گرفته می‌شود) (پیش‌فرض: 0,#000000,0.4,0.9,0,0,0.8,0.9,0.9,0,1,#ffffff)
- --volume-opacity-map <opacity_list>
- مشخص کردن یک نقشه کدر بودن (opacity) سفارشی برای رندر حجمی (پیش‌فرض: 0,0,1,1)
- --volume-opacity-file <filePath/filename/fileStem>
- مشخص کردن یک تصویر نقشه کدر بودن سفارشی برای رندر حجمی
- -v, --volume [=<bool>(=1)]
- نمایش حجم در صورت سازگار بودن فایل (پیش‌فرض: false)
- -i, --volume-inverse [=<bool>(=1)]
- معکوس کردن تابع کدر بودن برای رندر حجمی (پیش‌فرض: false)
- گزینه‌های دوربین:
- --camera-position <X,Y,Z>
- موقعیت دوربین (در صورت وجود، جهت دوربین و ضریب بزرگ‌نمایی را بازنویسی می‌کند)
- --camera-focal-point <X,Y,Z>
- نقطه کانونی دوربین
- --camera-view-up <direction>
- جهت رو به بالای دوربین
- --camera-view-angle <angle>
- زاویه دید دوربین (غیر صفر، بر حسب درجه) (پیش‌فرض: 0.0)
- --camera-direction <direction>
- جهت دوربین
- --camera-zoom-factor <factor>
- ضریب بزرگ‌نمایی دوربین (غیر صفر) (پیش‌فرض: 0.0)
- --camera-azimuth-angle <angle>
- زاویه سمتی (azimuth) دوربین (بر حسب درجه)، پس از سایر گزینه‌های دوربین اعمال می‌شود (پیش‌فرض: 0.0)
- --camera-elevation-angle <angle>
- زاویه ارتفاعی (elevation) دوربین (بر حسب درجه)، پس از سایر گزینه‌های دوربین اعمال می‌شود (پیش‌فرض: 0.0)
- --camera-orthographic [=<bool>(=1)]
- استفاده از دوربین متعامد (orthographic)
- گزینه‌های ردگیری پرتو (Raytracing):
- -r, --raytracing [=<bool>(=1)]
- فعال‌سازی ردگیری پرتو (پیش‌فرض: false)
- --raytracing-samples <samples>
- تعداد نمونه‌ها در هر پیکسل (پیش‌فرض: 5)
- -d, --raytracing-denoise [=<bool>(=1)]
- کاهش نویز تصویر (پیش‌فرض: false)
- گزینه‌های PostFX (OpenGL):
- -p, --blending [=<string>(=ddp)]
- انتخاب حالت آمیختگی نیمه‌شفافیت ("none"، "ddp"، "sort"، "sort_cpu" یا "stochastic") (پیش‌فرض: none)
- --translucency-support [=<bool>(=1)]
- فعال‌سازی آمیختگی نیمه‌شفافیت (منسوخ شده) (پیش‌فرض: false)
- -q, --ambient-occlusion [=<bool>(=1)]
- فعال‌سازی انسداد محیطی (ambient occlusion) جهت ارائه سایه‌های تقریبی برای درک بهتر عمق، پیاده‌سازی‌شده با استفاده از SSAO (پیش‌فرض: false)
- -a, --anti-aliasing [=<string>(=fxaa)]
- انتخاب روش هموارسازی لبه‌ها ("none"، "fxaa"، "ssaa" یا "taa") (پیش‌فرض: none)
- --anti-aliasing-mode [=<string>(=fxaa)]
- انتخاب روش هموارسازی لبه‌ها ("fxaa"، "ssaa" یا "taa") (منسوخ شده)
- -t, --tone-mapping [=<bool>(=1)]
- فعال‌سازی نگاشت تن (Tone Mapping)، جهت ارائه رنگ‌آمیزی متوازن (پیش‌فرض: false)
- --final-shader <GLSL code>
- اجرای سایه‌زن (shader) نهایی در پایان خط لوله رندرینگ
- --display-depth [=<bool>(=1)]
- نمایش بافر عمق به صورت یک تصویر در مقیاس خاکستری یا با یک نقشه‌رنگ در صورتی که "--scalar-coloring" تعیین شده باشد (پیش‌فرض: false)
- گزینه‌های آزمایش:
- --reference <png file>
- مرجع
- --reference-threshold <threshold>
- آستانه آزمایش (پیش‌فرض: 0.04)
- --interaction-test-record <file_path>
- مسیر فایل گزارش تعامل برای ثبت رویدادهای تعامل در آن
- --interaction-test-play <file_path>
- مسیر فایل گزارش تعامل برای بازپخش رویدادهای تعامل از آن هنگام بارگذاری یک فایل.SH "مثال‌ها (EXAMPLES)"
- f3d file.vtu -xtgans
- نمایش یک مش ساختارنیافته در یک سبک تصویرسازی علمی (sciviz) معمول و چشم‌نواز
- f3d file.glb -tuqap --hdri-file=file.hdr --hdri-ambient --hdri-skybox
- نمایش یک فایل gltf در یک محیط واقع‌گرایانه
- f3d file.ply -so --point-size=0 --coloring-component=-2
- نمایش یک فایل ابر نقاط با رندر مستقیم مقادیر اسکالر
- f3d folder
- نمایش تمام فایل‌های موجود در پوشه
گزارش باگ‌ها (BUGS)
باگ‌ها را به https://github.com/f3d-app/f3d/issues گزارش دهید
F3D - یک
نمایشگر
سه‌بعدی
سریع و
مینیمال
نسخه: 3.5.0.
تاریخ ساخت:
2026-09-01 00:25:05.
سیستم ساخت:
Linux 64-bits.
کامپایلر: GNU 16.2.1.
ماژول ImGui: ON.
ماژول OpenEXR: ON.
ماژول Raytracing: ON.
ماژول WebP: OFF.
نسخه VTK: 9.6.2.
کپی‌رایت ©
2019-2021 Kitware SAS.
کپی‌رایت ©
2021-2025 Michael Migliore, Mathieu Westphal.
کپی‌رایت © 2025
F3D-APP Foundation.
مجوز BSD-3-Clause.
| سپتامبر ۲۰۲۶ | F3D 3.5.0 |