.TH GFTODVI 1 "25 January 2026" "Web2C 2026"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
.if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
.if n .ds TX TeX
.\"=====================================================================
.SH "نام (NAME)"
gftodvi \- ساخت برگه‌های نمونه چاپی از فایل‌های بیت‌مپ قلم عمومی (gf)
.SH "خلاصه دستور (SYNOPSIS)"
.B gftodvi
.RB [ -overflow-label-offset=\fI\,real\/\fP ]
.RB [ -verbose ]
.IR gf_file [gf]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
برنامه
.B gftodvi
یک فایل بیت‌مپ قلم عمومی
.RI ( gf )
را که معمولاً توسط
.BR mf (1)
تولید می‌شود، به یک فایل مستقل از دستگاه (DVI) تبدیل می‌کند که پس از آن می‌توان با همان نرم‌افزاری که پیش‌تر برای \*(TX نوشته شده است آن را حروف‌چینی کرد. نویسه‌ها در فایل
.I gf
به‌صورت تک‌تک در هر صفحه، همراه با برچسب‌ها، عنوان‌ها و یادداشت‌ها همان‌طور که در ضمیمه H (نمونه‌های چاپی کاغذی - Hardcopy Proofs) کتاب
.IR "The \*(MFbook"
مشخص شده است، ظاهر می‌شوند.
.PP
برنامه
.B gftodvi
علاوه بر فایل اصلی
.IR gf ،
از قلم‌های دیگری نیز استفاده می‌کند. یک قلم «gray» (خاکستری) برای حروف‌چینی پیکسل‌هایی که در واقع نویسه را تشکیل می‌دهند به کار می‌رود. (ما نمی‌خواهیم همه پیکسل‌ها صرفاً سیاه باشند، زیرا در این صورت برچسب‌ها، نقاط کلیدی و سایر اطلاعات از بین خواهند رفت.) یک قلم «title» (عنوان) برای اطلاعات بالای صفحه استفاده می‌شود. یک قلم «label» (برچسب) برای برچسب‌های روی نقاط کلیدی شکل به کار می‌رود. همچنین یک قلم «slant» (مورب) برای حروف‌چینی خطوط مورب استفاده می‌شود، که در غیر این صورت باید با خطوط افقی و عمودی شبیه‌سازی شوند. قلم‌های پیش‌فرض gray،‏ title و label به ترتیب
.IR gray ،
.IR cmr8
و
.IR cmtt10
هستند؛ هیچ قلم slant پیش‌فرضی وجود ندارد.
.PP
برای تغییر قلم‌های پیش‌فرض، می‌توانید دستورهای
.B special
را در فایل منبع \*(MF خود وارد کنید، یا می‌توانید قلم‌ها را به‌صورت تعاملی تغییر دهید. اگر نام
.I gf_file
را با یک «/» پایان دهید، یک گفتگوی تعاملی آغاز می‌شود. برای مثال:
.br
.ti +2
gftodvi cmr10.300gf/
.br
.ti +2
Special font substitution: grayfont black
.br
.ti +2
OK; any more? grayfontarea /home/art/don/
.br
.ti +2
OK; any more? slantfont /home/fonts/slantimagen6
.br
.ti +2
OK; any more? <RET>
.br
از
.I /home/art/don/black
به عنوان قلم «gray» و از
.I /home/fonts/slantimagen6
به عنوان قلم «slant» استفاده خواهد کرد (این نام نشان‌دهنده یک قلم برای خطوطی با شیب ۱/۶ در وضوح یک چاپگر Imagen است).
.PP
آرگومان
.I gf_file
در خط فرمان باید شامل وضوح تفکیک‌پذیری باشد، اما می‌توان پسوند «gf» را حذف کرد. فایل خروجی dvi نام پایه‌ای یکسان با
.IR gf_file
خواهد داشت و با جایگزین شدن پسوند
.B dvi
به‌جای
.BR gf ،
در دایرکتوری کاری فعلی قرار می‌گیرد. برای مثال، فایل ورودی
.I /some/directory/cmr10.2602gf
به
.IR cmr10.dvi
تبدیل خواهد شد.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
برای جزئیات تجزیه خط فرمان،
.BR tex (1)
را ببینید.
.PP
آرگومان داده‌شده به
.B -overflow-label-offset
فاصله از لبه سمت راست کادر احاطه‌کننده (bounding box) نویسه را که در آن معادلات سرریز (در صورت وجود) حروف‌چینی می‌شوند، تعیین می‌کند. این مقدار بر حسب پوینت‌های \*(TX داده می‌شود. مقدار پیش‌فرض کمی بیش از دو اینچ است.
.PP
به‌طور پیش‌فرض،
.B gftodvi
بدون خروجی متنی اضافی (بی‌صدا) اجرا می‌شود. با استفاده از گزینه \fB-verbose\fP، یک پیام آغازین (banner) و گزارش پیشرفت در stdout چاپ می‌شود.
.PP
گزینه‌های استاندارد
.B -help
و
.B -version
نیز پشتیبانی می‌شوند.
.\"=====================================================================
.SH "محیط (ENVIRONMENT)"
این برنامه با استفاده از متغیرهای محیطی GFFONTS،‏ GLYPHFONTS و TEXFONTS، به همین ترتیب، به دنبال
.I gf_file
می‌گردد. اگر هیچ‌کدام تنظیم نشده باشند، از مقدار پیش‌فرض سیستم استفاده می‌کند. برای جزئیات جستجو، راهنمای Kpathsea را در https://tug.org/kpathsea ببینید.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
.TP
.I {gray.tfm,slant.tfm,black.tfm,.\|.\|.}
قلم‌های پیش‌فرض.
.TP
.I {gray.mf,slant.mf,black.mf,.\|.\|.}
منابع \*(MF.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR tex (1),
.BR mf (1).
.br
Donald E.\& Knuth,
.I "The \*(MFbook"
(جلد C از
.IR "Computers & Typesetting" ).
.br
Donald E.\& Knuth و دیگران،
.IR \*(MFware .
.PP
صفحه بسته در CTAN: https://ctan.org/pkg/gftodvi
.br
بخش مربوطه در راهنمای Web2c:
https://tug.org/texinfohtml/web2c.html#gftodvi-invocation
.br
کد منبع حروف‌چینی‌شده، شامل توضیحات قالب فایل:
https://ctan.org/pkg/knuth-pdf
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
Donald E.\& Knuth این برنامه را نوشته است و همچنان از آن نگهداری می‌کند. این برنامه به عنوان بخشی از گزارش فنی
.I \*(MFware
منتشر شد. Paul Richards در ابتدا آن را به Unix پورت کرد.
.PP
فهرست گفتگوی عمومی و گزارش باگ‌ها: https://lists.tug.org/tex-k