نام (NAME)

pic2graph - تبدیل نمودارهای PIC به تصاویر گرافیکی

خلاصه دستور (SYNOPSIS)

pic2graph [-unsafe] [-format output-format] [-eqn delimiters] [convert-argument ...]

pic2graph --help

pic2graph -v

pic2graph --version

توضیحات (DESCRIPTION)

pic2graph یک برنامه pic(1) را از ورودی استاندارد می‌خواند و یک فایل تصویری، به‌طور پیش‌فرض در قالب Portable Network Graphics (PNG)، در خروجی استاندارد می‌نویسد. این برنامه همچنین سازه‌های eqn(1) را ترجمه می‌کند، بنابراین می‌توان از آن برای تولید تصاویر فرمول‌های ریاضی استفاده کرد.

کد PIC ورودی نباید درون ماکروهای .PS و .PE/.PF/.PY که معمولاً در اسناد groff(1) آن را احاطه می‌کنند، قرار گیرد.

آرگومان‌هایی که توسط pic2graph شناسایی نشوند به برنامه ImageMagick یا GraphicsMagick با نام convert(1) ارسال می‌شوند. با مشخص کردن این موارد، می‌توانید برای تصویر خود یک حاشیه تعیین کنید، تراکم پیکسلی تصویر را تنظیم نمایید، یا سایر تبدیل‌های سودمند را اعمال کنید.

تصویر خروجی با استفاده از گزینه -trim برنامه convert به کوچک‌ترین کادر محاطی ممکن که دربرگیرنده تمام پیکسل‌های سیاه باشد، برش می‌خورد.

گزینه‌ها (OPTIONS)

--help پیام راهنمای نحوه استفاده را نمایش می‌دهد، در حالی که -v و --version اطلاعات نسخه را نشان می‌دهند؛ همگی پس از آن خارج می‌شوند.

-eqn delimiters: استفاده از delimiters به‌عنوان نویسه‌های آغازین و پایانی که دستورهای eqn را محدود می‌کنند؛ مقدار پیش‌فرض “$$” است. آرگومان گزینه delimiters باید یک رشته دو نویسه‌ای باشد، اما یک رشته خالی ("") نیز به‌عنوان دستوری برای غیرفعال کردن پردازش eqn پذیرفته می‌شود.
-format output-format: تصویر را در قالب output-format، که باید برای convert شناخته‌شده باشد، می‌نویسد؛ حالت پیش‌فرض PNG است.
-unsafe: اجرای groff در حالت ناامن (unsafe)، که به دستور PIC sh امکان می‌دهد دستورهای دلخواه پوسته یونیکس را اجرا کند. حالت پیش‌فرض groff ممنوع کردن این کار است.

محیط (ENVIRONMENT)

GROFF_TMPDIR
TMPDIR
TMP
TEMP: این متغیرهای محیطی به ترتیبی که نشان داده شده‌اند برای تعیین دایرکتوری محل ایجاد فایل‌های موقت جستجو می‌شوند. اگر هیچ‌کدام مقداردهی نشده باشند، از /tmp استفاده می‌شود.

نویسندگان (AUTHORS)

pic2graph توسط Eric S. Raymond، بر پایه روشی اثر W. Richard Stevens نوشته شده است.

همچنین ببینید (SEE ALSO)

W. Richard Stevens, Turning PIC into HTML

eqn2graph(1)، grap2graph(1)، pic(1)، eqn(1)، groff(1)، convert(1)