.TH "DVIPOS" "1" "30 August 2022" "dvipos 20070107 (KPATHSEA)" "ConTeXt"
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.de EX
.in +3
.nf
.ft CW
..
.de EE
.in -3
.ft R
.fi
..

.SH "نام (NAME)"
dvipos \- محاسبه موقعیت‌ها در یک فایل DVI

.SH "خلاصه دستور (SYNOPSIS)"
\fBdvipos\fP [ \fIOPTION\fP... ] \fIinfile[.dvi]\fP

.SH "توضیحات (DESCRIPTION)"
برنامه \fBdvipos\fP یک فایل DVI را برای یافتن ویژه‌دستورهای (specials) \fIpos:\fP تجزیه می‌کند. این برنامه در حال حاضر
\fIpos:pxy\fP، \fIpos:pxywhd\fP،
\fIpos:pxyplus\fP، \fIpos:begbox\fP، \fIpos:endbox\fP،
\fIpos:beglines\fP و \fIpos:endlines\fP را تشخیص می‌دهد. سپس اطلاعات حاصل از این ویژه‌دستورها را همراه با اطلاعاتی که فقط یک پس‌پردازشگر DVI می‌تواند تعیین کند، مانند مکان فعلی \fIx\fP و \fIy\fP، در خروجی قرار می‌دهد. خروجی شبیه به این است:
.EX
\\pospxywhd{text:54}{54}{10663sp}{8535sp}{21326sp}{34081sp}{0sp}
.EE
و برای گنجانده شدن در یک فایل کمکی
.BR tex (1)
یا
.BR pdftex (1)
مانند \fIdocument.tuo\fP مناسب است تا در اجرای بعدی
.BR tex (1)
یا موتور حروف‌چینی مشابه خوانده شود.

.SH "گزینه‌ها (OPTIONS)"

.TP
\fB-h, --help\fR
چاپ راهنمای استفاده.
.TP
\fB-W, --warning\fR
چاپ هشدارها.
.TP
\fB-v, --verbose\fR
چاپ خروجی با جزئیات (verbose).
.TP
\fB-d, --debug\fR
چاپ داده‌های اشکال‌زدایی
.BR dvitype (1).
.TP
\fB-s, --smashchars\fR
صفر در نظر گرفتن ارتفاع و عمق.
.TP
\fB-o, --output=\fIFILE\fR
ارسال تمام خروجی به FILE. بدون این گزینه، خروجی به خروجی استاندارد (stdout) فرستاده می‌شود.
.TP
\fB-b, --bbox[=\fP\fIFILE\fP]\fR
ارسال کادر محصورکننده (bounding box) به FILE (فایل پیش‌فرض \fIinfile.pos\fP است).
.TP
\fB-f, --framed[=\fP\fIBASE\fP]\fR
درخواست یک رونوشت از فایل DVI با نام \fIBASE.dvi\fP همراه با کادرهای محصورکننده
\fBframed\fP (فایل پیش‌فرض \fIinfile_frames.dvi\fP است). گزینه
\fB--framesize\fP را ببینید.
.TP
\fB-m, --mag=\fIINT\fR
بازنویسی بزرگ‌نمایی (magnification)
.BR tex (1)
با مقدار INT.
.TP
\fB-w, --framesize=\fIINT\fR
تنظیم اندازه خط قاب با مقدار INT (پیش‌فرض 6554 = .1pt است).
.TP
\fB-p, --pages=\fIX:Y\fR
تنظیم محدوده صفحات از X تا Y.

.SH "نحوه استفاده (USAGE)"
دستور
.B dvipos
بیشتر در پشت صحنه توسط
.BR texexec (1)
مربوط به ConTeXt بین اجراهای
.BR tex (1)
یا
.BR pdftex (1)
اجرا می‌شود تا اطلاعات گرافیک‌های موقعیتی را فراهم کرده و دریافت کند. این گرافیک‌ها توسط واسط MetaFun برای
.BR mpost (1)
ارائه می‌شوند.
\fBdvipos\fP در حالت خروجی PDF استفاده نمی‌شود (و نیازی به آن نیست)، اما برای حالت خروجی DVI مورد نیاز است.
.BR pdftex (1)
از نسخه 1.40 به بعد می‌تواند حتی در حالت DVI نیز اطلاعات موقعیت را تولید کند؛ بنابراین هنگامی که ماکروهای ConTeXt از این قابلیت بهره ببرند، نیاز به \fBdvipos\fP از بین خواهد رفت.

تا آن زمان، یک نمونه استفاده معمول از \fBdvipos\fP به صورت زیر است:
.EX
dvipos notes.dvi
.EE
اطلاعات موقعیت خروجی، توسط
.BR texexec (1)
جمع‌آوری می‌شود تا جهت استفاده در اجرای بعدی در فایل کمکی \fInotes.tuo\fP گنجانده شود.

.SH "مثال‌ها (EXAMPLES)"
.TP
استخراج موقعیت‌ها از \fIdoc.dvi\fP، با هدایت خروجی به \fIdoc.loc\fP:
\f(CWdvipos -o doc.loc doc.dvi\fP
.TP
مشابه بالا، اما ارسال اطلاعات کادر محصورکننده به \fIdoc.pos\fP نیز انجام می‌شود:
\f(CWdvipos -b -o doc.loc doc.dvi\fP
.TP
ارسال اطلاعات کادر محصورکننده به فایل \fI/tmp/debug.pos\fP به‌جای آن:
\f(CWdvipos -b=/tmp/debug.pos -o doc.loc doc.dvi\fP

.SH "همچنین ببینید (SEE ALSO)"
.BR dvips (1),
.BR dvitype (1),
.BR mpost (1),
.BR pdftex (1),
.BR tex (1),
.BR texexec (1).

برای اطلاعات بیشتر درباره گرافیک‌های موقعیتی، به مستندات MetaFun در
.URL "https://wiki.contextgarden.net/MetaFun" "ویکی ConTeXt"
مراجعه کنید.

.SH "گزارش باگ‌ها (BUGS)"
اگر فایلی را برای گزینه \fB-b\fP مشخص می‌کنید، باید گزینه و نام فایل را به‌جای فاصله (که رایج‌تر است) با \fB=\fP به یکدیگر متصل کنید:
.EX
dvipos -b=/tmp/debug.pos notes.dvi
.EE
کار می‌کند، اما
.EX
dvipos -b /tmp/debug.pos notes.dvi
.EE
کار نمی‌کند.

.SH "نویسندگان (AUTHORS)"
.B dvipos
توسط Jin-Hwan Cho <chofchof@ktug.or.kr> نوشته شده است. این نرم‌افزار، آزاد است (GPLv2 یا بالاتر). این صفحه راهنما توسط Sanjoy Mahajan <sanjoy@mit.edu> نوشته شده و در مالکیت عمومی (public domain) قرار دارد. این برنامه در حال حاضر به عنوان بخشی از TeX Live نگهداری می‌شود.