نام (NAME)

extractbb, ebb - استخراج اطلاعات کادر احاطه‌کننده از فایل‌های گرافیکی

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

extractbb [-v|-q] [-O] [-m|-x] file...

توضیحات (DESCRIPTION)

به ازای هر فایل JPEG، PNGیا PDF داده‌شده در خط فرمان، extractbb اطلاعات کادر احاطه‌کننده (bounding box) را استخراج کرده و آن را به همراه برخی اطلاعات سربرگ در فایلی با پسوند .xbb می‌نویسد. این فایل‌ها سپس می‌توانند توسط dvipdfmx یا سایر برنامه‌ها استفاده شوند. برای فایل‌های PDF ، تعداد صفحات و شماره نسخهٔ PDF نیز گزارش می‌شود. پسوند نام فایل ورودی می‌تواند با حروف بزرگ یا کوچک باشد.

اگر به صورت ebb فراخوانی شود، خروجی در قالب «bb» (و با پسوند .bb) که توسط dvipdfm استفاده می‌شود، نوشته خواهد شد. Xbb ممکن است در سیستم شما به عنوان مترادفی برای extractbb تعریف شده باشد.

گزینه‌ها (OPTIONS)

-v

حالت پرگویی (نمایش جزئیات).

-q

حالت بی‌صدا (عدم نمایش پیام‌ها).

-O

نوشتن خروجی در خروجی استاندارد.

-m

نوشتن خروجی در قالب «bb» مربوط به dvipdfm.

-x

نوشتن خروجی در قالب «xbb» مربوط به dvipdfmx (پیش‌فرض)، که همان قالب مورد استفاده توسط pdfTeX است.

قالب‌های خروجی (OUTPUT FORMATS)

در اینجا جزئیات بیشتری دربارهٔ قالب‌های bb و xbb آمده است:

برنامهٔ اصلی ebb (از dvipdfm) اطلاعات تراکم (density) در تصاویر بیتی (bitmap) را نادیده می‌گرفت و کادرهای احاطه‌کننده را با نسبت 100px = 72bp = 1in تولید می‌کرد. متأسفانه، به‌ویژه تصاویر ثبت‌شده از صفحه نمایش (screenshots) با این رویکرد ظاهر نامناسبی پیدا می‌کنند.

بنابراین، extractbb (از dvipdfmx) در صورت وجود، از اطلاعات تراکم استفاده می‌کند. در غیر این صورت، کادر احاطه‌کننده را با 100px = 100bp تولید می‌نماید. این همان کاری است که pdfTeX انجام می‌دهد.

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

در حال حاضر هیچ روشی برای تعیین این که کدام کادر احاطه‌کننده برای فایل‌های PDF در نظر گرفته شود وجود ندارد. همواره اولین مورد از این فهرست انتخاب خواهد شد: ArtBox، TrimBox، BleedBox، MediaBox. (اغلب تنها MediaBox تعریف شده است.) علاوه بر این، کادر احاطه‌کنندهٔ گزارش‌شده همواره به صفحهٔ نخست در یک فایل PDF اشاره دارد.

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

extractbb توسط تیم پروژهٔ DVIPDFMx به نشانی <dvipdfmx@ktug.or.kr> بر اساس برنامهٔ ebb اثر Mark A. Wicks نوشته شده است.

این صفحهٔ راهنما نیز توسط تیم پروژهٔ DVIPDFMx بر پایهٔ صفحهٔ راهنمایی که Frank Küster <frank@kuesterei.ch> برای سیستم دبیان گنو/لینوکس نوشته بود، تدوین شده است. استفاده، تغییر و/یا بازتوزیع آن توسط دیگران بدون نیاز به تماس با نویسندگان مجاز است.