.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "gtk4-path-tool" "1" "" "GTK" "دستورهای GTK" .SH "نام (NAME)" gtk4-path-tool \- ابزار کاربردی GskPath .SH "خلاصه دستور (SYNOPSIS)" .nf \fBgtk4\-path\-tool\fP [OPTIONS...] \fBgtk4\-path\-tool\fP decompose [OPTIONS...] \fBgtk4\-path\-tool\fP show [OPTIONS...] ... \fBgtk4\-path\-tool\fP render [OPTIONS...] ... \fBgtk4\-path\-tool\fP reverse [OPTIONS...] \fBgtk4\-path\-tool\fP info [OPTIONS...] .fi .sp .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgtk4\-path\-tool\fP می‌تواند وظایف گوناگونی را روی مسیرها (paths) انجام دهد. مسیرها در ساختار دستوری SVG و به‌صورت رشته‌هایی مانند \(dqM 100 100 C 100 200 200 200 200 100 Z\(dq مشخص می‌شوند. .sp برای خواندن یک مسیر از یک فایل، از نام فایلی استفاده کنید که با یک \(aq.\(aq یا یک \(aq/\(aq آغاز می‌شود. برای خواندن مسیر از stdin، از \(aq\-\(aq استفاده کنید. .SH "دستورها (COMMANDS)" .SS "تجزیه کردن (Decomposing)" .sp دستور \fBdecompose\fP مسیر را با عنصرهای ساده‌تر تقریب می‌زند. هنگامی که بدون گزینه استفاده شود، منحنی‌های مسیر با پاره‌خط‌ها تقریب زده می‌شوند. .sp \fB\-\-allow\-quad\fP .INDENT 0.0 .INDENT 3.5 اجازه می‌دهد از منحنی‌های بزیه درجه دوم (quadratic Bézier) در مسیر تولیدشده استفاده شود. .UNINDENT .UNINDENT .sp \fB\-\-allow\-cubic\fP .INDENT 0.0 .INDENT 3.5 اجازه می‌دهد از منحنی‌های بزیه درجه سوم (cubic Bézier) در مسیر تولیدشده استفاده شود. .UNINDENT .UNINDENT .sp \fB\-\-allow\-conic\fP .INDENT 0.0 .INDENT 3.5 اجازه می‌دهد از منحنی‌های بزیه مخروطی (conic Bézier) در مسیر تولیدشده استفاده شود. .UNINDENT .UNINDENT .SS "نمایش (Showing)" .sp دستور \fBshow\fP مسیر داده‌شده را در یک پنجره نمایش می‌دهد. فضای داخلی مسیر پر می‌شود. این پنجره امکان کنترل تعاملی محدودی را با کلیدهای میان‌بر فراهم می‌کند: کلیدهای \(aq+\(aq/\(aq\-\(aq سطح بزرگ‌نمایی را تغییر می‌دهند، \(aqp\(aq نمایش نقاط را روشن/خاموش می‌کند، \(aqc\(aq نمایش نقاط کنترلی را تغییر وضعیت می‌دهد، \(aqi\(aq نمایش تقاطع‌ها را روشن/خاموش می‌کند و \(aqf\(aq قاعده پر کردن را تغییر می‌دهد. .sp \fB\-\-fill\fP .INDENT 0.0 .INDENT 3.5 پر کردن مسیر (این گزینه پیش‌فرض است). .UNINDENT .UNINDENT .sp \fB\-\-stroke\fP .INDENT 0.0 .INDENT 3.5 ترسیم خط دور مسیر (stroke) به‌جای پر کردن آن. .UNINDENT .UNINDENT .sp \fB\-\-points\fP .INDENT 0.0 .INDENT 3.5 نمایش نقاط روی مسیر. .UNINDENT .UNINDENT .sp \fB\-\-controls\fP .INDENT 0.0 .INDENT 3.5 نمایش نقاط کنترلی. .UNINDENT .UNINDENT .sp \fB\-\-intersections\fP .INDENT 0.0 .INDENT 3.5 اگر دو مسیر داده شده باشد، تقاطع‌های آن‌ها را نشان می‌دهد. اگر یک مسیر داده شده باشد، خودتقاطعی‌های آن را نشان می‌دهد. .UNINDENT .UNINDENT .sp \fB\-\-fill\-rule=VALUE\fP .INDENT 0.0 .INDENT 3.5 قاعده پر کردنی که برای تعیین نواحی داخلی مسیر به کار می‌رود. مقدارهای ممکن \fBwinding\fP یا \fBeven\-odd\fP هستند. مقدار پیش‌فرض \fBwinding\fP است. .UNINDENT .UNINDENT .sp \fB\-\-fg\-color=COLOR\fP .INDENT 0.0 .INDENT 3.5 رنگی که برای پر کردن فضای داخلی مسیر یا ترسیم خط دور آن استفاده می‌شود. در صورت عدم تعیین، رنگ سیاه استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-bg\-color=COLOR\fP .INDENT 0.0 .INDENT 3.5 رنگی که برای ترسیم پس‌زمینه در پشت مسیر استفاده می‌شود. در صورت عدم تعیین، رنگ سفید استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-point\-color=COLOR\fP .INDENT 0.0 .INDENT 3.5 رنگی که برای ترسیم نقاط استفاده می‌شود. در صورت عدم تعیین، رنگ قرمز استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-intersection\-color=COLOR\fP .INDENT 0.0 .INDENT 3.5 رنگی که برای ترسیم تقاطع‌ها استفاده می‌شود. در صورت عدم تعیین، رنگ سبز استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-line\-width=VALUE\fP .INDENT 0.0 .INDENT 3.5 عرض خط مورد استفاده برای stroke. مقدار \fBVALUE\fP باید یک عدد مثبت باشد. عرض خط پیش‌فرض ۱ است. .UNINDENT .UNINDENT .sp \fB\-\-line\-cap=VALUE\fP .INDENT 0.0 .INDENT 3.5 سبک کلاهک برای استفاده در انتهای خطوط. مقدارهای ممکن \fBbutt\fP، \fBround\fP یا \fBsquare\fP هستند. برای جزئیات این سبک‌ها مشخصات SVG را بررسی کنید. سبک کلاهک پیش‌فرض \fBbutt\fP است. .UNINDENT .UNINDENT .sp \fB\-\-line\-join=VALUE\fP .INDENT 0.0 .INDENT 3.5 سبک اتصال برای استفاده در محل اتصال خطوط. مقدارهای ممکن \fBmiter\fP، \fBmiter\-clip\fP، \fBround\fP، \fBbevel\fP یا \fBarcs\fP هستند. برای جزئیات این سبک‌ها مشخصات SVG را بررسی کنید. سبک اتصال پیش‌فرض \fBmiter\fP است. .UNINDENT .UNINDENT.sp \fB\-\-miter\-limit=VALUE\fP .INDENT 0.0 .INDENT 3.5 حد آستانه برای بریدن فارسی‌بُرها (miters) در محل اتصال خطوط. مقدار پیش‌فرض 4 است. .UNINDENT .UNINDENT .sp \fB\-\-dashes=VALUE\fP .INDENT 0.0 .INDENT 3.5 الگوی خط‌چین مورد استفاده برای این خط‌کشی (stroke). الگوی خط‌چین با فهرستی از اعداد غیرمنفی متناوب که با کاما از هم جدا شده‌اند مشخص می‌شود. هر عدد طول بخش‌های متناوب \(dqروشن\(dq و \(dqخاموش\(dq خط را تعیین می‌کند. اگر الگوی خط‌چین خالی باشد، خط‌چین غیرفعال می‌شود که حالت پیش‌فرض است. برای جزئیات درباره خط‌چین به مشخصات SVG مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-dash\-offset=VALUE\fP .INDENT 0.0 .INDENT 3.5 میزان جابه‌جایی (offset) در الگوی خط‌چین که خط‌چین‌گذاری باید از آنجا آغاز شود. مقدار پیش‌فرض 0 است. .UNINDENT .UNINDENT .sp \fB\-\-zoom=NUMBER\fP .INDENT 0.0 .INDENT 3.5 تنظیم سطح بزرگ‌نمایی روی عدد داده‌شده (بین 1 و 20). .UNINDENT .UNINDENT .SS "رندر (Rendering)" .sp دستور \fBrender\fP مسیر داده‌شده را به عنوان یک تصویر PNG رندر می‌کند. .sp \fB\-\-fill\fP .INDENT 0.0 .INDENT 3.5 پر کردن مسیر (این حالت پیش‌فرض است). .UNINDENT .UNINDENT .sp \fB\-\-stroke\fP .INDENT 0.0 .INDENT 3.5 خط‌کشی دور مسیر به‌جای پر کردن آن. .UNINDENT .UNINDENT .sp \fB\-\-points\fP .INDENT 0.0 .INDENT 3.5 نمایش نقاط روی مسیر. .UNINDENT .UNINDENT .sp \fB\-\-controls\fP .INDENT 0.0 .INDENT 3.5 نمایش نقاط کنترلی. .UNINDENT .UNINDENT .sp \fB\-\-intersections\fP .INDENT 0.0 .INDENT 3.5 اگر دو مسیر داده شده باشند، تقاطع‌های آن‌ها را نشان می‌دهد. اگر یک مسیر داده شده باشد، تقاطع‌های آن با خودش (self\-intersections) را نشان می‌دهد. .UNINDENT .UNINDENT .sp \fB\-\-fill\-rule=VALUE\fP .INDENT 0.0 .INDENT 3.5 قاعده پر کردن (fill rule) که برای تعیین نواحی درون مسیر استفاده می‌شود. مقادیر ممکن عبارتند از \fBwinding\fP یا \fBeven\-odd\fP\&. مقدار پیش‌فرض \fBwinding\fP است. .UNINDENT .UNINDENT .sp \fB\-\-fg\-color=COLOR\fP .INDENT 0.0 .INDENT 3.5 رنگی که برای پر کردن داخل مسیر یا خط‌کشی مسیر استفاده می‌شود. اگر مشخص نشود، از سیاه (black) استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-bg\-color=COLOR\fP .INDENT 0.0 .INDENT 3.5 رنگی که برای رندر پس‌زمینه پشت مسیر استفاده می‌شود. اگر مشخص نشود، از سفید (white) استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-point\-color=COLOR\fP .INDENT 0.0 .INDENT 3.5 رنگی که برای رندر نقاط استفاده می‌شود. اگر مشخص نشود، از قرمز (red) استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-intersection\-color=COLOR\fP .INDENT 0.0 .INDENT 3.5 رنگی که برای رندر تقاطع‌ها استفاده می‌شود. اگر مشخص نشود، از سبز (green) استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-output\-file=FILE\fP .INDENT 0.0 .INDENT 3.5 فایلی برای ذخیره تصویر PNG در آن. اگر مشخص نشود، از \(dqpath.png\(dq استفاده می‌شود. .UNINDENT .UNINDENT .sp \fB\-\-line\-width=VALUE\fP .INDENT 0.0 .INDENT 3.5 عرض خط مورد استفاده برای خط‌کشی. \fBVALUE\fP باید یک عدد مثبت باشد. عرض خط پیش‌فرض 1 است. .UNINDENT .UNINDENT .sp \fB\-\-line\-cap=VALUE\fP .INDENT 0.0 .INDENT 3.5 سبک کلاهک (cap style) در انتهای خطوط. مقادیر ممکن عبارتند از \fBbutt\fP، \fBround\fP یا \fBsquare\fP\&. برای جزئیات درباره این سبک‌ها به مشخصات SVG مراجعه کنید. سبک کلاهک پیش‌فرض \fBbutt\fP است. .UNINDENT .UNINDENT .sp \fB\-\-line\-join=VALUE\fP .INDENT 0.0 .INDENT 3.5 سبک اتصال (join style) مورد استفاده در محل اتصال خطوط. مقادیر ممکن عبارتند از \fBmiter\fP، \fBmiter\-clip\fP، \fBround\fP، \fBbevel\fP یا \fBarcs\fP\&. برای جزئیات درباره این سبک‌ها به مشخصات SVG مراجعه کنید. سبک اتصال پیش‌فرض \fBmiter\fP است. .UNINDENT .UNINDENT .sp \fB\-\-miter\-limit=VALUE\fP .INDENT 0.0 .INDENT 3.5 حد آستانه برای بریدن فارسی‌بُرها (miters) در محل اتصال خطوط. مقدار پیش‌فرض 4 است. .UNINDENT .UNINDENT .sp \fB\-\-dashes=VALUE\fP .INDENT 0.0 .INDENT 3.5 الگوی خط‌چین مورد استفاده برای این خط‌کشی (stroke). الگوی خط‌چین با فهرستی از اعداد غیرمنفی متناوب که با کاما از هم جدا شده‌اند مشخص می‌شود. هر عدد طول بخش‌های متناوب \(dqروشن\(dq و \(dqخاموش\(dq خط را تعیین می‌کند. اگر الگوی خط‌چین خالی باشد، خط‌چین غیرفعال می‌شود که حالت پیش‌فرض است. برای جزئیات درباره خط‌چین به مشخصات SVG مراجعه کنید. .UNINDENT .UNINDENT .sp \fB\-\-dash\-offset=VALUE\fP .INDENT 0.0 .INDENT 3.5 میزان جابه‌جایی (offset) در الگوی خط‌چین که خط‌چین‌گذاری باید از آنجا آغاز شود. مقدار پیش‌فرض 0 است. .UNINDENT .UNINDENT .sp \fB\-\-zoom=NUMBER\fP .INDENT 0.0 .INDENT 3.5 تنظیم سطح بزرگ‌نمایی روی عدد داده‌شده (بین 1 و 20). .UNINDENT .UNINDENT.SS معکوس‌سازی (Reversing) .sp دستور \fBreverse\fP جهت مسیر را تغییر می‌دهد. مسیر حاصل در نقطه‌ای آغاز می‌شود که مسیر اصلی به پایان می‌رسد. .SS اطلاعات (Info) .sp دستور \fBinfo\fP اطلاعات گوناگونی را درباره مسیر داده‌شده، مانند کادر محصورکننده (bounding box) آن، نمایش می‌دهد. .SH "مراجع (REFERENCES)" .INDENT 0.0 .IP \(bu 2 مشخصات مسیر SVG (SVG Path Specification)، \% .UNINDENT .\" End of generated man page.