gtk4-path-tool(1) دستورهای GTK gtk4-path-tool(1)

gtk4-path-tool - ابزار کاربردی GskPath

gtk4-path-tool <COMMAND> [OPTIONS...] <PATH>
gtk4-path-tool decompose [OPTIONS...] <PATH>
gtk4-path-tool show [OPTIONS...] <PATH>...
gtk4-path-tool render [OPTIONS...] <PATH>...
gtk4-path-tool reverse [OPTIONS...] <PATH>
gtk4-path-tool info [OPTIONS...] <PATH>

دستور gtk4-path-tool می‌تواند وظایف گوناگونی را روی مسیرها (paths) انجام دهد. مسیرها در ساختار دستوری SVG و به‌صورت رشته‌هایی مانند "M 100 100 C 100 200 200 200 200 100 Z" مشخص می‌شوند.

برای خواندن یک مسیر از یک فایل، از نام فایلی استفاده کنید که با یک '.' یا یک '/' آغاز می‌شود. برای خواندن مسیر از stdin، از '-' استفاده کنید.

دستور decompose مسیر را با عنصرهای ساده‌تر تقریب می‌زند. هنگامی که بدون گزینه استفاده شود، منحنی‌های مسیر با پاره‌خط‌ها تقریب زده می‌شوند.

--allow-quad

اجازه می‌دهد از منحنی‌های بزیه درجه دوم (quadratic Bézier) در مسیر تولیدشده استفاده شود.

--allow-cubic

اجازه می‌دهد از منحنی‌های بزیه درجه سوم (cubic Bézier) در مسیر تولیدشده استفاده شود.

--allow-conic

اجازه می‌دهد از منحنی‌های بزیه مخروطی (conic Bézier) در مسیر تولیدشده استفاده شود.

دستور show مسیر داده‌شده را در یک پنجره نمایش می‌دهد. فضای داخلی مسیر پر می‌شود. این پنجره امکان کنترل تعاملی محدودی را با کلیدهای میان‌بر فراهم می‌کند: کلیدهای '+'/'-' سطح بزرگ‌نمایی را تغییر می‌دهند، 'p' نمایش نقاط را روشن/خاموش می‌کند، 'c' نمایش نقاط کنترلی را تغییر وضعیت می‌دهد، 'i' نمایش تقاطع‌ها را روشن/خاموش می‌کند و 'f' قاعده پر کردن را تغییر می‌دهد.

--fill

پر کردن مسیر (این گزینه پیش‌فرض است).

--stroke

ترسیم خط دور مسیر (stroke) به‌جای پر کردن آن.

--points

نمایش نقاط روی مسیر.

--controls

نمایش نقاط کنترلی.

--intersections

اگر دو مسیر داده شده باشد، تقاطع‌های آن‌ها را نشان می‌دهد. اگر یک مسیر داده شده باشد، خودتقاطعی‌های آن را نشان می‌دهد.

--fill-rule=VALUE

قاعده پر کردنی که برای تعیین نواحی داخلی مسیر به کار می‌رود. مقدارهای ممکن winding یا even-odd هستند. مقدار پیش‌فرض winding است.

--fg-color=COLOR

رنگی که برای پر کردن فضای داخلی مسیر یا ترسیم خط دور آن استفاده می‌شود. در صورت عدم تعیین، رنگ سیاه استفاده می‌شود.

--bg-color=COLOR

رنگی که برای ترسیم پس‌زمینه در پشت مسیر استفاده می‌شود. در صورت عدم تعیین، رنگ سفید استفاده می‌شود.

--point-color=COLOR

رنگی که برای ترسیم نقاط استفاده می‌شود. در صورت عدم تعیین، رنگ قرمز استفاده می‌شود.

--intersection-color=COLOR

رنگی که برای ترسیم تقاطع‌ها استفاده می‌شود. در صورت عدم تعیین، رنگ سبز استفاده می‌شود.

--line-width=VALUE

عرض خط مورد استفاده برای stroke. مقدار VALUE باید یک عدد مثبت باشد. عرض خط پیش‌فرض ۱ است.

--line-cap=VALUE

سبک کلاهک برای استفاده در انتهای خطوط. مقدارهای ممکن butt، round یا square هستند. برای جزئیات این سبک‌ها مشخصات SVG را بررسی کنید. سبک کلاهک پیش‌فرض butt است.

--line-join=VALUE

سبک اتصال برای استفاده در محل اتصال خطوط. مقدارهای ممکن miter، miter-clip، round، bevel یا arcs هستند. برای جزئیات این سبک‌ها مشخصات SVG را بررسی کنید. سبک اتصال پیش‌فرض miter است.
--miter-limit=VALUE
حد آستانه برای بریدن فارسی‌بُرها (miters) در محل اتصال خطوط. مقدار پیش‌فرض 4 است.

--dashes=VALUE

الگوی خط‌چین مورد استفاده برای این خط‌کشی (stroke). الگوی خط‌چین با فهرستی از اعداد غیرمنفی متناوب که با کاما از هم جدا شده‌اند مشخص می‌شود. هر عدد طول بخش‌های متناوب "روشن" و "خاموش" خط را تعیین می‌کند. اگر الگوی خط‌چین خالی باشد، خط‌چین غیرفعال می‌شود که حالت پیش‌فرض است. برای جزئیات درباره خط‌چین به مشخصات SVG مراجعه کنید.

--dash-offset=VALUE

میزان جابه‌جایی (offset) در الگوی خط‌چین که خط‌چین‌گذاری باید از آنجا آغاز شود. مقدار پیش‌فرض 0 است.

--zoom=NUMBER

تنظیم سطح بزرگ‌نمایی روی عدد داده‌شده (بین 1 و 20).

دستور render مسیر داده‌شده را به عنوان یک تصویر PNG رندر می‌کند.

--fill

پر کردن مسیر (این حالت پیش‌فرض است).

--stroke

خط‌کشی دور مسیر به‌جای پر کردن آن.

--points

نمایش نقاط روی مسیر.

--controls

نمایش نقاط کنترلی.

--intersections

اگر دو مسیر داده شده باشند، تقاطع‌های آن‌ها را نشان می‌دهد. اگر یک مسیر داده شده باشد، تقاطع‌های آن با خودش (self-intersections) را نشان می‌دهد.

--fill-rule=VALUE

قاعده پر کردن (fill rule) که برای تعیین نواحی درون مسیر استفاده می‌شود. مقادیر ممکن عبارتند از winding یا even-odd. مقدار پیش‌فرض winding است.

--fg-color=COLOR

رنگی که برای پر کردن داخل مسیر یا خط‌کشی مسیر استفاده می‌شود. اگر مشخص نشود، از سیاه (black) استفاده می‌شود.

--bg-color=COLOR

رنگی که برای رندر پس‌زمینه پشت مسیر استفاده می‌شود. اگر مشخص نشود، از سفید (white) استفاده می‌شود.

--point-color=COLOR

رنگی که برای رندر نقاط استفاده می‌شود. اگر مشخص نشود، از قرمز (red) استفاده می‌شود.

--intersection-color=COLOR

رنگی که برای رندر تقاطع‌ها استفاده می‌شود. اگر مشخص نشود، از سبز (green) استفاده می‌شود.

--output-file=FILE

فایلی برای ذخیره تصویر PNG در آن. اگر مشخص نشود، از "path.png" استفاده می‌شود.

--line-width=VALUE

عرض خط مورد استفاده برای خط‌کشی. VALUE باید یک عدد مثبت باشد. عرض خط پیش‌فرض 1 است.

--line-cap=VALUE

سبک کلاهک (cap style) در انتهای خطوط. مقادیر ممکن عبارتند از butt، round یا square. برای جزئیات درباره این سبک‌ها به مشخصات SVG مراجعه کنید. سبک کلاهک پیش‌فرض butt است.

--line-join=VALUE

سبک اتصال (join style) مورد استفاده در محل اتصال خطوط. مقادیر ممکن عبارتند از miter، miter-clip، round، bevel یا arcs. برای جزئیات درباره این سبک‌ها به مشخصات SVG مراجعه کنید. سبک اتصال پیش‌فرض miter است.

--miter-limit=VALUE

حد آستانه برای بریدن فارسی‌بُرها (miters) در محل اتصال خطوط. مقدار پیش‌فرض 4 است.

--dashes=VALUE

الگوی خط‌چین مورد استفاده برای این خط‌کشی (stroke). الگوی خط‌چین با فهرستی از اعداد غیرمنفی متناوب که با کاما از هم جدا شده‌اند مشخص می‌شود. هر عدد طول بخش‌های متناوب "روشن" و "خاموش" خط را تعیین می‌کند. اگر الگوی خط‌چین خالی باشد، خط‌چین غیرفعال می‌شود که حالت پیش‌فرض است. برای جزئیات درباره خط‌چین به مشخصات SVG مراجعه کنید.

--dash-offset=VALUE

میزان جابه‌جایی (offset) در الگوی خط‌چین که خط‌چین‌گذاری باید از آنجا آغاز شود. مقدار پیش‌فرض 0 است.

--zoom=NUMBER

تنظیم سطح بزرگ‌نمایی روی عدد داده‌شده (بین 1 و 20).

دستور reverse جهت مسیر را تغییر می‌دهد. مسیر حاصل در نقطه‌ای آغاز می‌شود که مسیر اصلی به پایان می‌رسد.

دستور info اطلاعات گوناگونی را درباره مسیر داده‌شده، مانند کادر محصورکننده (bounding box) آن، نمایش می‌دهد.

•
مشخصات مسیر SVG (SVG Path Specification)، https://www.w3.org/TR/SVG2/paths.html
GTK