نام (NAME)

dvipos - محاسبه موقعیت‌ها در یک فایل DVI

خلاصه دستور (SYNOPSIS)

dvipos [ OPTION... ] infile[.dvi]

توضیحات (DESCRIPTION)

برنامه dvipos یک فایل DVI را برای یافتن ویژه‌دستورهای (specials) pos: تجزیه می‌کند. این برنامه در حال حاضر pos:pxy، pos:pxywhd، pos:pxyplus، pos:begbox، pos:endbox، pos:beglines و pos:endlines را تشخیص می‌دهد. سپس اطلاعات حاصل از این ویژه‌دستورها را همراه با اطلاعاتی که فقط یک پس‌پردازشگر DVI می‌تواند تعیین کند، مانند مکان فعلی x و y، در خروجی قرار می‌دهد. خروجی شبیه به این است:

\pospxywhd{text:54}{54}{10663sp}{8535sp}{21326sp}{34081sp}{0sp}

و برای گنجانده شدن در یک فایل کمکی tex(1) یا pdftex(1) مانند document.tuo مناسب است تا در اجرای بعدی tex(1) یا موتور حروف‌چینی مشابه خوانده شود.

گزینه‌ها (OPTIONS)

-h, --help

چاپ راهنمای استفاده.

-W, --warning

چاپ هشدارها.

-v, --verbose

چاپ خروجی با جزئیات (verbose).

-d, --debug

چاپ داده‌های اشکال‌زدایی dvitype(1).

-s, --smashchars

صفر در نظر گرفتن ارتفاع و عمق.

-o, --output=FILE

ارسال تمام خروجی به FILE. بدون این گزینه، خروجی به خروجی استاندارد (stdout) فرستاده می‌شود.

-b, --bbox[=FILE]

ارسال کادر محصورکننده (bounding box) به FILE (فایل پیش‌فرض infile.pos است).

-f, --framed[=BASE]

درخواست یک رونوشت از فایل DVI با نام BASE.dvi همراه با کادرهای محصورکننده framed (فایل پیش‌فرض infile_frames.dvi است). گزینه --framesize را ببینید.

-m, --mag=INT

بازنویسی بزرگ‌نمایی (magnification) tex(1) با مقدار INT.

-w, --framesize=INT

تنظیم اندازه خط قاب با مقدار INT (پیش‌فرض 6554 = .1pt است).

-p, --pages=X:Y

تنظیم محدوده صفحات از X تا Y.

نحوه استفاده (USAGE)

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

تا آن زمان، یک نمونه استفاده معمول از dvipos به صورت زیر است:

dvipos notes.dvi

مثال‌ها (EXAMPLES)

استخراج موقعیت‌ها از doc.dvi، با هدایت خروجی به doc.loc:

dvipos -o doc.loc doc.dvi

مشابه بالا، اما ارسال اطلاعات کادر محصورکننده به doc.pos نیز انجام می‌شود:

dvipos -b -o doc.loc doc.dvi

ارسال اطلاعات کادر محصورکننده به فایل /tmp/debug.pos به‌جای آن:

dvipos -b=/tmp/debug.pos -o doc.loc doc.dvi

همچنین ببینید (SEE ALSO)

dvips(1), dvitype(1), mpost(1), pdftex(1), tex(1), texexec(1).

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

گزارش باگ‌ها (BUGS)

اگر فایلی را برای گزینه -b مشخص می‌کنید، باید گزینه و نام فایل را به‌جای فاصله (که رایج‌تر است) با = به یکدیگر متصل کنید:

dvipos -b=/tmp/debug.pos notes.dvi

کار می‌کند، اما

dvipos -b /tmp/debug.pos notes.dvi

کار نمی‌کند.

نویسندگان (AUTHORS)

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