.TH pic2graph 1 "2026-03-15" "groff 1.24.1"
.SH "نام (NAME)"
pic2graph \- تبدیل نمودارهای PIC به تصاویر گرافیکی
.
.
.\" ====================================================================
.\" Legal Terms
.\" ====================================================================
.\"
.\" This documentation is released to the public domain.
.
.
.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr *groff_pic2graph_1_man_C \n[.cp]
.cp 0
.
.\" Define fallback for groff 1.23's MR macro if the system lacks it.
.nr do-fallback 0
.if !\n(.f           .nr do-fallback 1 \" mandoc
.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
.if \n[do-fallback]  \{\
.  de MR
.    ie \\n(.$=1 \
.      I \%\\$1
.    el \
.      IR \%\\$1 (\\$2)\\$3
.  .
.\}
.rr do-fallback
.
.
.\" ====================================================================
.SH "خلاصه دستور (SYNOPSIS)"
.\" ====================================================================
.
.SY pic2graph
.RB [ \-unsafe ]
.RB [ \-format\~\c
.IR output-format ]
.RB [ \-eqn\~\c
.IR delimiters ]
.RI [ convert-argument \~.\|.\|.]
.YS
.
.
.P
.SY pic2graph
.B \-\-help
.YS
.
.
.P
.SY pic2graph
.B \-v
.YS
.
.SY pic2graph
.B \%\-\-version
.YS
.
.
.\" ====================================================================
.SH "توضیحات (DESCRIPTION)"
.\" ====================================================================
.
.I pic2graph
یک برنامه
.MR \%pic 1
را از ورودی استاندارد می‌خواند و یک فایل تصویری،
به‌طور پیش‌فرض در قالب Portable Network Graphics (PNG)،
در خروجی استاندارد می‌نویسد.
.
این برنامه همچنین سازه‌های
.MR \%eqn 1
را ترجمه می‌کند،
بنابراین می‌توان از آن برای تولید تصاویر فرمول‌های ریاضی استفاده کرد.
.
.
.PP
کد PIC ورودی
.I نباید
درون ماکروهای
.B .PS
و
.BR .PE / .PF / .PY
که معمولاً در اسناد
.MR groff 1
آن را احاطه می‌کنند، قرار گیرد.
.
.
.\" FIXME: How old?  This text hasn't been touched since 2008 at latest.
.\" Older versions of
.\" .I \%convert
.\" will produce a black-on-white graphic; newer ones may produce a
.\" black-on-transparent graphic.
.
.PP
آرگومان‌هایی که توسط
.I pic2graph
شناسایی نشوند به برنامه ImageMagick یا GraphicsMagick با نام
.MR convert 1
ارسال می‌شوند.
.
.
با مشخص کردن این موارد، می‌توانید برای تصویر خود یک حاشیه تعیین کنید،
.\" Transparent backgrounds are the default in 2018.
.\" force the background transparent,
تراکم پیکسلی تصویر را تنظیم نمایید،
یا سایر تبدیل‌های سودمند را اعمال کنید.
.
.
.PP
تصویر خروجی با استفاده از گزینه
.B \-trim
برنامه
.I \%convert
به کوچک‌ترین کادر محاطی ممکن که دربرگیرنده تمام پیکسل‌های سیاه باشد، برش می‌خورد.
.
.
.\" ====================================================================
.SH "گزینه‌ها (OPTIONS)"
.\" ====================================================================
.
.B \-\-help
پیام راهنمای نحوه استفاده را نمایش می‌دهد،
در حالی که
.B \-v
و
.B \%\-\-version
اطلاعات نسخه را نشان می‌دهند؛
همگی پس از آن خارج می‌شوند.
.
.TP
.BI \-eqn\~ delimiters
استفاده از
.I delimiters
به‌عنوان نویسه‌های آغازین و پایانی که دستورهای
.I \%eqn
را محدود می‌کنند؛
مقدار پیش‌فرض \(lq$$\(rq است.
.
آرگومان گزینه
.I delimiters
باید یک رشته دو نویسه‌ای باشد،
اما یک رشته خالی (\(dq\(dq) نیز به‌عنوان دستوری برای غیرفعال کردن پردازش
.I \%eqn
پذیرفته می‌شود.
.
.
.TP
.BI \-format\~ output-format
تصویر را در قالب
.IR output-format ،
که باید برای
.I \%convert
شناخته‌شده باشد، می‌نویسد؛
حالت پیش‌فرض PNG است.
.
.
.TP
.B \-unsafe
اجرای
.I groff
در حالت
.IR "ناامن" " (unsafe)،"
که به دستور PIC
.B sh
امکان می‌دهد دستورهای دلخواه پوسته یونیکس را اجرا کند.
.
حالت پیش‌فرض
.I groff
ممنوع کردن این کار است.
.
.
.\" ====================================================================
.SH "محیط (ENVIRONMENT)"
.\" ====================================================================
.
.TP
.I \%GROFF_TMPDIR
.TQ
.I \%TMPDIR
.TQ
.I TMP
.TQ
.I TEMP
این متغیرهای محیطی به ترتیبی که نشان داده شده‌اند برای تعیین دایرکتوری محل ایجاد فایل‌های موقت جستجو می‌شوند.
.
اگر هیچ‌کدام مقداردهی نشده باشند، از
.I /tmp
استفاده می‌شود.
.
.
.\" ====================================================================
.SH "نویسندگان (AUTHORS)"
.\" ====================================================================
.
.I pic2graph
توسط
.MT esr@\:thyrsus\:.com
Eric S.\& Raymond
.ME ،
بر پایه روشی اثر W.\& Richard Stevens نوشته شده است.
.
.
.\" ====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.\" ====================================================================
.
W.\& Richard Stevens,
.UR http://\:www\:.kohala\:.com/\:start/\:troff/\:pic2html\:.html
.I Turning PIC into HTML
.UE
.
.
.PP
.MR eqn2graph 1 ،
.MR grap2graph 1 ،
.MR \%pic 1 ،
.MR \%eqn 1 ،
.MR groff 1 ،
.MR convert 1
.
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[*groff_pic2graph_1_man_C]
.do rr *groff_pic2graph_1_man_C
.
.
.\" Local Variables:
.\" fill-column: 72
.\" mode: nroff
.\" End:
.\" vim: set filetype=groff textwidth=72: