.TH VFTOVP 1 "30 January 2026" "Web2C 2026"
.\"=====================================================================
.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)"
vftovp \- تبدیل فایل‌های قلم مجازی (vf) TeX به فهرست ویژگی‌های مجازی (vpl)
.SH "خلاصه دستور (SYNOPSIS)"
.B vftovp
.RI [ options ]
.IR vf_file [ \fB.vf\fP ]
.RI [ tfm_file [ \fB.tfm\fP ]
.RI [ vpl_file [ \fB.vpl\fP ]]]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.B vftovp
یک فایل (دودویی) قلم مجازی و فایل سنجهٔ قلم (font metric)
\*(TX
همراه آن را به یک فایل (متن ساده) فهرست ویژگی‌ها (property list) تبدیل می‌کند. بدین‌ترتیب، قلم مجازی قابل ویرایش خواهد بود و محتوای دقیق آن را می‌توان به‌صورت یادافزا (mnemonic) نمایش داد. این برنامه همچنین به‌عنوان یک ابزار اعتبارسنجی فایل vf عمل می‌کند؛ یعنی اگر هیچ پیام خطایی صادر نشود، فایل‌های ورودی درست و معتبر هستند.
.PP
در صورت نیاز، پسوند مناسب به نام فایل‌ها اضافه می‌شود.
.PP
قالب قلم مجازی
\*(TX
از ساخت نویسه‌های جدید از طریق نویسه‌های موجود در هر تعداد قلم، و همچنین استفاده از خط‌کشی‌ها (rules) در نویسه‌ها پشتیبانی می‌کند. این ویژگی، برای مثال، امکان بازکدگذاری (re-encoding) با ترکیبی از نویسه‌های قلم‌های مختلف را فراهم می‌سازد. این قلم‌های vf کاملاً با قلم‌های متغیر (variable fonts) که می‌توان با OpenType ایجاد کرد و آن‌ها نیز طبق سنت از پسوند
\fI.vf\fP
استفاده می‌کنند، بی‌ارتباط هستند.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
برای جزئیات مربوط به تجزیهٔ خط فرمان،
.BR tex (1)
را ببینید.
.TP
.BI -charcode-format= format
آرگومان
.I format
مشخص می‌کند که کدهای نویسه چگونه در فایل vpl در خروجی قرار گیرند. به‌طور پیش‌فرض (رفتار سنتی)، حروف و ارقام ASCII با استفاده از کد «C» (یعنی همان‌گونه که هستند) خارج می‌شوند و سایر نویسه‌ها در مبنای هشت (octal) در خروجی نوشته می‌شوند؛ مگر اینکه طرح کدگذاری قلم با «TeX math sy» یا «TeX math ex» آغاز شود، که در این حالت همهٔ کدهای نویسه در مبنای هشت خروجی داده می‌شوند.
.IP
اگر
.I format
برابر
.B ascii
باشد، تمام کدهای نویسه‌ای که متناظر با نویسه‌های گرافیکی (دیداری) هستند، به‌جز پرانتزهای چپ و راست، در قالب ASCII خروجی داده می‌شوند.
.IP
در نهایت، اگر
.I format
برابر
.B octal
باشد، تمام کدهای نویسه در مبنای هشت خروجی داده می‌شوند. (این گزینه همانند گزینهٔ موجود در
\fBtftopl\fP
است.)
.TP
.B -verbose
به‌طور پیش‌فرض، برنامه در سکوت اجرا می‌شود. با این گزینه، گزارش‌هایی در خروجی استاندارد (stdout) نوشته می‌شود.
.PP
گزینه‌های استاندارد
.B -help
و
.B -version
نیز پشتیبانی می‌شوند.
.\"=====================================================================
.SH "محیط (ENVIRONMENT)"
این برنامه برای جستجوی
.I vf_file
از متغیر محیطی VFFONTS و برای جستجوی
.I tfm_file
از متغیر محیطی TFMFONTS استفاده می‌کند. اگر هر یک از آن‌ها تنظیم نشده باشد، سپس متغیر TEXFONTS را بررسی می‌کند. چنانچه آن هم مقداردهی نشده باشد، از پیش‌فرض سیستم استفاده خواهد کرد. برای مشاهدهٔ جزئیات جستجو، راهنمای Kpathsea را در https://tug.org/kpathsea ببینید.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR pltotf (1),
.BR tftopl (1),
.BR vptovf (1).
.PP
شرح مختصر قلم‌های مجازی و مراجع تکمیلی:
https://tug.org/texinfohtml/dvips.html#Virtual-fonts
.br
پیام اولیهٔ Knuth برای معرفی قلم‌های مجازی:
https://mirror.ctan.org/info/virtual-fonts.knuth
.br
مبحث ابزارهای قلم در CTAN: https://ctan.org/topic/font-util
.br
صفحهٔ بسته در CTAN: https://ctan.org/pkg/vftovp
.br
بخش مربوط در راهنمای Web2c:
https://tug.org/texinfohtml/web2c.html#vftovp-invocation
.br
کد منبع حروفچینی‌شده، شامل شرح قالب فایل vf:
https://ctan.org/pkg/knuth-pdf
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
Donald E. Knuth این برنامه را بر پایهٔ بخشی از ایدهٔ David Fuchs و با شروع از کد برنامهٔ
.BR tftopl (1)
نوشت. Karl Berry آن را برای همگردانی با
.BR web2c
سازگار کرد.
.PP
فهرست گفتگوی عمومی و گزارش باگ‌ها: https://lists.tug.org/tex-k