.TH OPENSCAD 1 "2021.01" .\" Please adjust this date whenever revising the manpage. .SH "نام (NAME)" openscad \- محیط گرافیکی CAD مبتنی بر فایل‌های اسکریپت .SH "خلاصه دستور (SYNOPSIS)" .B openscad .RI [ options ] .RI [ file ] .SH "توضیحات (DESCRIPTION)" این صفحهٔ راهنما به طور خلاصه دستور \fBopenscad\fP را شرح می‌دهد. .PP \fBopenscad\fP نرم‌افزاری برای ساخت اشیاء سه‌بعدی توپر CAD است. این برنامه بیش از جنبه‌های هنری، بر جنبه‌های CAD تمرکز دارد. برنامهٔ OpenSCAD به صورت یک برنامهٔ گرافیکی اجرا خواهد شد، مگر آنکه گزینه‌های صدور (export) داده شوند (به زیر مراجعه کنید). برای نحوهٔ استفاده از رابط کاربری گرافیکی (GUI) و توضیحات زبان OpenSCAD، به راهنمای کاربر OpenSCAD در مراجعه کنید. آموزش این نرم‌افزار را نیز می‌توانید در بیابید. .SH "گزینه‌ها (OPTIONS)" .TP \fB\-o\fP \fIoutputfile\fP صادر کردن فایل داده‌شده به \fIoutputfile\fP در قالب STL، OFF، AMF، 3MF، DXF، SVG یا PNG بسته به پسوند نام فایل \fIoutputfile\fP. در صورت ارائهٔ این گزینه، رابط گرافیکی (GUI) اجرا نخواهد شد. پسوندهای شناخته‌شده: stl، off، amf، 3mf، csg، dxf، svg، png، echo، ast، term، nef3، nefdbg. قالب‌های بیشتر، که عمدتاً برای اشکال‌زدایی و آزمایش استفاده می‌شوند (اما می‌توانند در خودکارسازی نیز به کار روند)، عبارتند از AST (فایل ورودی به صورت تجزیه‌شده و دوباره بازآرایی‌شده)، CSG (نمایش فایل ورودی به زبان OpenSCAD پس از انجام محاسبات و اعمال فراخوانی‌های ماژول)، TERM (عبارت هندسه فضایی ترکیبی یا همان constructive solid geometry که به OpenCSG ارسال می‌شود). اگر \fIoutputfile\fP برابر با \fBnull\fP باشد، هیچ فایل خروجی نوشته نخواهد شد، اما فایل همچنان ارزیابی شده و تمام دستورهای \fBecho\fP در خروجی خطای استاندارد نوشته می‌شوند. (در صورت ارائهٔ گزینهٔ \fB\-\-render\fP، فرایند رندر همچنان انجام خواهد شد.) .TP \fB\-\-export-format\fP هنگام استفاده از گزینهٔ \fB\-o\fP، قالب فایل scad صادرشده را بازنویسی می‌کند؛ آرگومان می‌تواند هر یک از پسوندهای فایل پشتیبانی‌شده باشد. .TP \fB\-q\fP حالت بی‌صدا (هیچ چیزی به جز خطاها چاپ نشود). .TP \fB\-d\fP \fIfile.deps\fP اگر گزینهٔ \fB\-d\fP داده شود، تمام فایل‌هایی که هنگام صدور به آن‌ها دسترسی پیدا شده است، با ساختار نحوی یک Makefile در فایل deps داده‌شده نوشته می‌شوند. .TP \fB\-m\fP \fImake_command\fP اگر در حین کارکرد OpenSCAD به فایلی دسترسی پیدا شود که وجود ندارد، تلاش می‌کند با اجرای دستور \fImake_command missing_file\fP فایل ناموجود را ایجاد کرده و سپس دوباره آن را بخواند. .TP \fB\-D\fP \fIvar=val\fP این گزینه می‌تواند برای انتساب مقادیر ثابت به متغیرهای OpenSCAD به کار رود. مقدار متغیر یک عبارت است، بنابراین اگر از این سازوکار برای انتساب رشته‌ها استفاده شود، باید دقت کرد که پوسته (shell) علامت‌های نقل‌قول را حذف نکند. می‌توان بیش از یک گزینهٔ \fB\-D\fP مشخص کرد. .TP .B \-p فایل پارامتر Customizer. .TP .B \-p مجموعه پارامترهای Customizer. .TP .B \-v چاپ نسخه. .TP .B \-\-render در صورت صدور یک تصویر، مدل به طور کامل رندر شود. (پیش‌فرض پیش‌نمایش است) .TP .B \-\-preview[=throwntogether] در صورت صدور یک تصویر، استفاده از پیش‌نمایش OpenCSG (اختیاراً در حالت throwntogether برای رندر سریع‌تر). .TP .B \-\-animate[=N] صادر کردن N فریم متحرک به صورت تصاویر PNG. .TP .B \-\-view[=axes|crosshairs|edges|scales|wireframe] گزینه‌های نما (view). .TP .B \-\-csglimit=limit در صورت صدور یک تصویر به صورت پیش‌نمایش OpenCSG، رندر پس از مواجهه با \fIlimit\fP عنصر متوقف شود تا از مصرف مهارنشدنی منابع جلوگیری به عمل آید. .TP .B \-\-camera=transx,transy,transz,rotx,roty,rotz,distance در صورت صدور یک تصویر، استفاده از دوربین گیمبال (Gimbal) با پارامترهای داده‌شده. rot چرخش حول محورهای x، y و z است؛ trans مسافتی است که شیء در جهت‌های x، y و z جابه‌جا می‌شود؛ و distance فاصلهٔ بین دوربین و مرکز شیء است. .TP .B \-\-camera=eyex,eyey,eyez,centerx,centery,centerz در صورت صدور یک تصویر، استفاده از دوربین برداری (Vector) با پارامترهای داده‌شده. سه مورد اول برای موقعیت Eye (چشم) هستند، در حالی که سه مورد بعدی برای Center (مرکز یا هدف) است که دوربین به آن نگاه خواهد کرد. بردار \(aqup\(aq در حال حاضر پشتیبانی نمی‌شود. .TP .B \-\-viewall در صورت صدور یک تصویر، تنظیم فاصلهٔ دوربین به گونه‌ای که کل طرح در کادر جای گیرد. .TP .B \-\-autocenter در صورت صدور یک تصویر، قرار دادن طرح در مرکز کادر. .TP .B \-\-imgsize=width,height در صورت صدور یک تصویر، تعیین عرض و ارتفاع بر حسب پیکسل. .TP .B \-\-projection=[o|ortho|p|perspective] در صورت صدور یک تصویر، تعیین اینکه از تصویرسازی قائم (orthographic) استفاده شود یا پرسپکتیو (perspective). .TP .B \-\-colorscheme=\fIscheme در صورت صدور یک تصویر، استفاده از طرح رنگ مشخص‌شده برای رندر. \fIscheme\fP می‌تواند هر یک از \fBCornfield\fP، \fBSunset\fP، \fBMetallic\fP، \fBStarnight\fP، \fBBeforeDawn\fP، \fBNature\fP یا \fBDeepOcean\fP، \fBSolarized\fP، \fBTomorrow\fP، \fBTomorrow 2\fP، \fBTomorrow Night\fP و \fBMonotone\fP باشد. .TP .B \-\-hardwarnings توقف در نخستین هشدار. .TP .B \-\-check-parameters=[true|false] پیکربندی بررسی پارامترها برای توابع و ماژول‌های کاربر. .TP .B \-\-check-parameter-ranges=[true|false] پیکربندی بررسی محدودهٔ پارامترها برای ماژول‌های توکار (builtin). .TP .B \-\-info نمایش اینکه کدام نسخه‌های کتابخانه‌ها برای کامپایل برنامه استفاده شده‌اند، و چه جزئیاتی از OpenGL شناسایی شده است. .SH "مثال‌ها (EXAMPLES)" .PP رندر کردن example001.scad در قالب .stl (داده‌های خام مثلث): .PP .B openscad -o example001.stl examples/example001.scad .PP کامپایل کردن یک تصویر دوبعدی با استفاده از دوربینی با چرخش ۲۵ درجه در x و ۳۵ درجه در z، با فاصلهٔ ۵۰۰ و تصویرسازی قائم (orthographic): .PP .B openscad -o o.png o.scad --camera=0,0,0,25,0,35,500 --projection=ortho .PP تنظیم متغیر \(aqmode\(aq در example017 به گونه‌ای که تنها بخش‌های شکل را رندر کند. صدور به یک فایل .dxf: .PP .B openscad -o example017.dxf -D'mode="parts"' examples/example017.scad .SH "نویسندگان (AUTHORS)" برنامهٔ OpenSCAD توسط Claire \(aqClifford\(aq Wolf، Marius Kintel و دیگران نوشته شده است. .PP این صفحهٔ راهنما توسط chrysn برای پروژهٔ Debian نوشته شده است (و ممکن است توسط دیگران نیز استفاده شود). توسط تیم OpenSCAD به‌روزرسانی شده است.