| OPENSCAD(1) | General Commands Manual | OPENSCAD(1) |
نام (NAME)
openscad - محیط گرافیکی CAD مبتنی بر فایل‌های اسکریپت
خلاصه دستور (SYNOPSIS)
openscad [options] [file]
توضیحات (DESCRIPTION)
این صفحهٔ راهنما به طور خلاصه دستور openscad را شرح می‌دهد.
openscad نرم‌افزاری برای ساخت اشیاء سه‌بعدی توپر CAD است. این برنامه بیش از جنبه‌های هنری، بر جنبه‌های CAD تمرکز دارد.
برنامهٔ OpenSCAD به صورت یک برنامهٔ گرافیکی اجرا خواهد شد، مگر آنکه گزینه‌های صدور (export) داده شوند (به زیر مراجعه کنید). برای نحوهٔ استفاده از رابط کاربری گرافیکی (GUI) و توضیحات زبان OpenSCAD، به راهنمای کاربر OpenSCAD در https://en.wikibooks.org/wiki/OpenSCAD_User_Manual مراجعه کنید. آموزش این نرم‌افزار را نیز می‌توانید در https://en.wikibooks.org/wiki/OpenSCAD_Tutorial بیابید.
گزینه‌ها (OPTIONS)
- -o outputfile
- صادر کردن
فایل
داده‌شده
به outputfile در
قالب STL، OFF، AMF،
3MF، DXF، SVG یا PNG
بسته به
پسوند نام
فایل outputfile. در
صورت
ارائهٔ این
گزینه،
رابط
گرافیکی (GUI)
اجرا
نخواهد شد.
پسوندهای شناخته‌شده: stl، off، amf، 3mf، csg، dxf، svg، png، echo، ast، term، nef3، nefdbg.
قالب‌های بیشتر، که عمدتاً برای اشکال‌زدایی و آزمایش استفاده می‌شوند (اما می‌توانند در خودکارسازی نیز به کار روند)، عبارتند از AST (فایل ورودی به صورت تجزیه‌شده و دوباره بازآرایی‌شده)، CSG (نمایش فایل ورودی به زبان OpenSCAD پس از انجام محاسبات و اعمال فراخوانی‌های ماژول)، TERM (عبارت هندسه فضایی ترکیبی یا همان constructive solid geometry که به OpenCSG ارسال می‌شود). اگر outputfile برابر با null باشد، هیچ فایل خروجی نوشته نخواهد شد، اما فایل همچنان ارزیابی شده و تمام دستورهای echo در خروجی خطای استاندارد نوشته می‌شوند. (در صورت ارائهٔ گزینهٔ --render، فرایند رندر همچنان انجام خواهد شد.)
- --export-format
- هنگام استفاده از گزینهٔ -o، قالب فایل scad صادرشده را بازنویسی می‌کند؛ آرگومان می‌تواند هر یک از پسوندهای فایل پشتیبانی‌شده باشد.
- -q
- حالت بی‌صدا (هیچ چیزی به جز خطاها چاپ نشود).
- -d file.deps
- اگر گزینهٔ -d داده شود، تمام فایل‌هایی که هنگام صدور به آن‌ها دسترسی پیدا شده است، با ساختار نحوی یک Makefile در فایل deps داده‌شده نوشته می‌شوند.
- -m make_command
- اگر در حین کارکرد OpenSCAD به فایلی دسترسی پیدا شود که وجود ندارد، تلاش می‌کند با اجرای دستور make_command missing_file فایل ناموجود را ایجاد کرده و سپس دوباره آن را بخواند.
- -D var=val
- این گزینه می‌تواند برای انتساب مقادیر ثابت به متغیرهای OpenSCAD به کار رود. مقدار متغیر یک عبارت است، بنابراین اگر از این سازوکار برای انتساب رشته‌ها استفاده شود، باید دقت کرد که پوسته (shell) علامت‌های نقل‌قول را حذف نکند. می‌توان بیش از یک گزینهٔ -D مشخص کرد.
- -p
- فایل پارامتر Customizer.
- -p
- مجموعه پارامترهای Customizer.
- -v
- چاپ نسخه.
- --render
- در صورت صدور یک تصویر، مدل به طور کامل رندر شود. (پیش‌فرض پیش‌نمایش است)
- --preview[=throwntogether]
- در صورت صدور یک تصویر، استفاده از پیش‌نمایش OpenCSG (اختیاراً در حالت throwntogether برای رندر سریع‌تر).
- --animate[=N]
- صادر کردن N فریم متحرک به صورت تصاویر PNG.
- --view[=axes|crosshairs|edges|scales|wireframe]
- گزینه‌های نما (view).
- --csglimit=limit
- در صورت صدور یک تصویر به صورت پیش‌نمایش OpenCSG، رندر پس از مواجهه با limit عنصر متوقف شود تا از مصرف مهارنشدنی منابع جلوگیری به عمل آید.
- --camera=transx,transy,transz,rotx,roty,rotz,distance
- در صورت صدور یک تصویر، استفاده از دوربین گیمبال (Gimbal) با پارامترهای داده‌شده. rot چرخش حول محورهای x، y و z است؛ trans مسافتی است که شیء در جهت‌های x، y و z جابه‌جا می‌شود؛ و distance فاصلهٔ بین دوربین و مرکز شیء است.
- --camera=eyex,eyey,eyez,centerx,centery,centerz
- در صورت صدور یک تصویر، استفاده از دوربین برداری (Vector) با پارامترهای داده‌شده. سه مورد اول برای موقعیت Eye (چشم) هستند، در حالی که سه مورد بعدی برای Center (مرکز یا هدف) است که دوربین به آن نگاه خواهد کرد. بردار 'up' در حال حاضر پشتیبانی نمی‌شود.
- --viewall
- در صورت صدور یک تصویر، تنظیم فاصلهٔ دوربین به گونه‌ای که کل طرح در کادر جای گیرد.
- --autocenter
- در صورت صدور یک تصویر، قرار دادن طرح در مرکز کادر.
- --imgsize=width,height
- در صورت صدور یک تصویر، تعیین عرض و ارتفاع بر حسب پیکسل.
- --projection=[o|ortho|p|perspective]
- در صورت صدور یک تصویر، تعیین اینکه از تصویرسازی قائم (orthographic) استفاده شود یا پرسپکتیو (perspective).
- --colorscheme=scheme
- در صورت صدور یک تصویر، استفاده از طرح رنگ مشخص‌شده برای رندر. scheme می‌تواند هر یک از Cornfield، Sunset، Metallic، Starnight، BeforeDawn، Nature یا DeepOcean، Solarized، Tomorrow، Tomorrow 2، Tomorrow Night و Monotone باشد.
- --hardwarnings
- توقف در نخستین هشدار.
- --check-parameters=[true|false]
- پیکربندی بررسی پارامترها برای توابع و ماژول‌های کاربر.
- --check-parameter-ranges=[true|false]
- پیکربندی بررسی محدودهٔ پارامترها برای ماژول‌های توکار (builtin).
- --info
- نمایش اینکه کدام نسخه‌های کتابخانه‌ها برای کامپایل برنامه استفاده شده‌اند، و چه جزئیاتی از OpenGL شناسایی شده است.
مثال‌ها (EXAMPLES)
رندر کردن example001.scad در قالب .stl (داده‌های خام مثلث):
openscad -o example001.stl examples/example001.scad
کامپایل کردن یک تصویر دوبعدی با استفاده از دوربینی با چرخش ۲۵ درجه در x و ۳۵ درجه در z، با فاصلهٔ ۵۰۰ و تصویرسازی قائم (orthographic):
openscad -o o.png o.scad --camera=0,0,0,25,0,35,500 --projection=ortho
تنظیم متغیر 'mode' در example017 به گونه‌ای که تنها بخش‌های شکل را رندر کند. صدور به یک فایل .dxf:
openscad -o example017.dxf -D'mode="parts"' examples/example017.scad
نویسندگان (AUTHORS)
برنامهٔ OpenSCAD توسط Claire 'Clifford' Wolf، Marius Kintel و دیگران نوشته شده است.
این صفحهٔ راهنما توسط chrysn <chrysn@fsfe.org> برای پروژهٔ Debian نوشته شده است (و ممکن است توسط دیگران نیز استفاده شود). توسط تیم OpenSCAD به‌روزرسانی شده است.
| 2021.01 |