GFTODVI(1) General Commands Manual GFTODVI(1)

gftodvi - ساخت برگه‌های نمونه چاپی از فایل‌های بیت‌مپ قلم عمومی (gf)

gftodvi [-overflow-label-offset=real] [-verbose] gf_file[gf]

برنامه gftodvi یک فایل بیت‌مپ قلم عمومی (gf) را که معمولاً توسط mf(1) تولید می‌شود، به یک فایل مستقل از دستگاه (DVI) تبدیل می‌کند که پس از آن می‌توان با همان نرم‌افزاری که پیش‌تر برای TeX نوشته شده است آن را حروف‌چینی کرد. نویسه‌ها در فایل gf به‌صورت تک‌تک در هر صفحه، همراه با برچسب‌ها، عنوان‌ها و یادداشت‌ها همان‌طور که در ضمیمه H (نمونه‌های چاپی کاغذی - Hardcopy Proofs) کتاب The Metafontbook مشخص شده است، ظاهر می‌شوند.

برنامه gftodvi علاوه بر فایل اصلی gf، از قلم‌های دیگری نیز استفاده می‌کند. یک قلم «gray» (خاکستری) برای حروف‌چینی پیکسل‌هایی که در واقع نویسه را تشکیل می‌دهند به کار می‌رود. (ما نمی‌خواهیم همه پیکسل‌ها صرفاً سیاه باشند، زیرا در این صورت برچسب‌ها، نقاط کلیدی و سایر اطلاعات از بین خواهند رفت.) یک قلم «title» (عنوان) برای اطلاعات بالای صفحه استفاده می‌شود. یک قلم «label» (برچسب) برای برچسب‌های روی نقاط کلیدی شکل به کار می‌رود. همچنین یک قلم «slant» (مورب) برای حروف‌چینی خطوط مورب استفاده می‌شود، که در غیر این صورت باید با خطوط افقی و عمودی شبیه‌سازی شوند. قلم‌های پیش‌فرض gray،‏ title و label به ترتیب gray، cmr8 و cmtt10 هستند؛ هیچ قلم slant پیش‌فرضی وجود ندارد.

برای تغییر قلم‌های پیش‌فرض، می‌توانید دستورهای special را در فایل منبع Metafont خود وارد کنید، یا می‌توانید قلم‌ها را به‌صورت تعاملی تغییر دهید. اگر نام gf_file را با یک «/» پایان دهید، یک گفتگوی تعاملی آغاز می‌شود. برای مثال:
gftodvi cmr10.300gf/
Special font substitution: grayfont black
OK; any more? grayfontarea /home/art/don/
OK; any more? slantfont /home/fonts/slantimagen6
OK; any more? <RET>
از /home/art/don/black به عنوان قلم «gray» و از /home/fonts/slantimagen6 به عنوان قلم «slant» استفاده خواهد کرد (این نام نشان‌دهنده یک قلم برای خطوطی با شیب ۱/۶ در وضوح یک چاپگر Imagen است).

آرگومان gf_file در خط فرمان باید شامل وضوح تفکیک‌پذیری باشد، اما می‌توان پسوند «gf» را حذف کرد. فایل خروجی dvi نام پایه‌ای یکسان با gf_file خواهد داشت و با جایگزین شدن پسوند dvi به‌جای gf، در دایرکتوری کاری فعلی قرار می‌گیرد. برای مثال، فایل ورودی /some/directory/cmr10.2602gf به cmr10.dvi تبدیل خواهد شد.

برای جزئیات تجزیه خط فرمان، tex(1) را ببینید.

آرگومان داده‌شده به -overflow-label-offset فاصله از لبه سمت راست کادر احاطه‌کننده (bounding box) نویسه را که در آن معادلات سرریز (در صورت وجود) حروف‌چینی می‌شوند، تعیین می‌کند. این مقدار بر حسب پوینت‌های TeX داده می‌شود. مقدار پیش‌فرض کمی بیش از دو اینچ است.

به‌طور پیش‌فرض، gftodvi بدون خروجی متنی اضافی (بی‌صدا) اجرا می‌شود. با استفاده از گزینه -verbose، یک پیام آغازین (banner) و گزارش پیشرفت در stdout چاپ می‌شود.

گزینه‌های استاندارد -help و -version نیز پشتیبانی می‌شوند.

این برنامه با استفاده از متغیرهای محیطی GFFONTS،‏ GLYPHFONTS و TEXFONTS، به همین ترتیب، به دنبال gf_file می‌گردد. اگر هیچ‌کدام تنظیم نشده باشند، از مقدار پیش‌فرض سیستم استفاده می‌کند. برای جزئیات جستجو، راهنمای Kpathsea را در https://tug.org/kpathsea ببینید.

{gray.tfm,slant.tfm,black.tfm,...}
قلم‌های پیش‌فرض.
{gray.mf,slant.mf,black.mf,...}
منابع Metafont.

tex(1), mf(1).
Donald E. Knuth, The Metafontbook (جلد C از Computers & Typesetting).
Donald E. Knuth و دیگران، Metafontware.

صفحه بسته در CTAN: https://ctan.org/pkg/gftodvi
بخش مربوطه در راهنمای Web2c: https://tug.org/texinfohtml/web2c.html#gftodvi-invocation
کد منبع حروف‌چینی‌شده، شامل توضیحات قالب فایل: https://ctan.org/pkg/knuth-pdf

Donald E. Knuth این برنامه را نوشته است و همچنان از آن نگهداری می‌کند. این برنامه به عنوان بخشی از گزارش فنی Metafontware منتشر شد. Paul Richards در ابتدا آن را به Unix پورت کرد.

فهرست گفتگوی عمومی و گزارش باگ‌ها: https://lists.tug.org/tex-k

25 January 2026 Web2C 2026