| 1 |
.TH "EXTRACTBB" "1" "20 April 2012" "20120420" "DVIPDFMx" |
| 2 |
.PP |
| 3 |
.SH "NAME" |
| 4 |
extractbb, ebb \- extract bounding box information from graphics files |
| 5 |
.PP |
| 6 |
.SH "SYNOPSIS" |
| 7 |
.PP |
| 8 |
.B extractbb |
| 9 |
.RB [ \-v | \-q ] |
| 10 |
.RB [ \-O ] |
| 11 |
.RB [ \-m | \-x ] |
| 12 |
.IR file \&.\&.\&. |
| 13 |
.PP |
| 14 |
.SH "DESCRIPTION" |
| 15 |
.PP |
| 16 |
For each |
| 17 |
.SM JPEG\c |
| 18 |
, |
| 19 |
.SM PNG\c |
| 20 |
, or |
| 21 |
.SM PDF |
| 22 |
file given on the command line, |
| 23 |
.B extractbb |
| 24 |
extracts the bounding box information and writes it into a file with extension |
| 25 |
.BR .xbb , |
| 26 |
together with some header information. These files can then be used by |
| 27 |
.B dvipdfmx |
| 28 |
or other programs. For |
| 29 |
.SM PDF |
| 30 |
files, the number of pages and the |
| 31 |
.SM PDF |
| 32 |
version number are reported as well. |
| 33 |
The input filename extension may be in upper or lower case. |
| 34 |
.PP |
| 35 |
If called as |
| 36 |
.BR ebb , |
| 37 |
the output is written in the ``bb'' format (and with extension |
| 38 |
.BR .bb ) |
| 39 |
as used by |
| 40 |
.BR dvipdfm . |
| 41 |
.B Xbb |
| 42 |
may be defined as a synonym for |
| 43 |
.B extractbb |
| 44 |
on your system. |
| 45 |
.PP |
| 46 |
.SH "OPTIONS" |
| 47 |
.PD 0 |
| 48 |
.TP 10 |
| 49 |
.B -v |
| 50 |
Be verbose. |
| 51 |
.TP |
| 52 |
.B -q |
| 53 |
Be quiet. |
| 54 |
.TP |
| 55 |
.B -O |
| 56 |
Write output to standard output. |
| 57 |
.TP |
| 58 |
.B -m |
| 59 |
Write output in dvipdfm's ``bb'' format. |
| 60 |
.TP |
| 61 |
.B -x |
| 62 |
Write output in dvipdfmx's ``xbb'' format (default), which is the same |
| 63 |
as that used by pdfTeX. |
| 64 |
.PD |
| 65 |
.PP |
| 66 |
.SH "OUTPUT FORMATS" |
| 67 |
.PP |
| 68 |
Here are more details about the bb and xbb formats: |
| 69 |
.PP |
| 70 |
The original ebb (from dvipdfm) ignored density information in bitmap |
| 71 |
images, and generated bounding boxes with 100px = 72bp = 1in. |
| 72 |
Unfortunately, screenshots (especially) tend to look bad with this |
| 73 |
approach. |
| 74 |
.PP |
| 75 |
So, extractbb (from dvipdfmx) uses density information if present. |
| 76 |
Otherwise, it generates bounding box with 100px = 100bp. This is what |
| 77 |
pdfTeX does. |
| 78 |
.SH "BUGS" |
| 79 |
.PP |
| 80 |
There is currently no way to specify which bounding box is taken |
| 81 |
for |
| 82 |
.SM PDF |
| 83 |
files. It will always be the first one from the following |
| 84 |
list: ArtBox, TrimBox, BleedBox, MediaBox. (Often only MediaBox |
| 85 |
is defined.) Moreover, the reported bounding box always refers |
| 86 |
to the first page in a |
| 87 |
.SM PDF |
| 88 |
file. |
| 89 |
.PP |
| 90 |
.SH "AUTHOR" |
| 91 |
.PP |
| 92 |
\fBextractbb\fP was written by the DVIPDFMx project team |
| 93 |
<[email protected]>, based on the program \fBebb\fP by Mark A. Wicks. |
| 94 |
.PP |
| 95 |
This manual page was also written by the DVIPDFMx project team, |
| 96 |
based on a manual page Frank K\[:u]ster <frank@kuesterei\&.ch> |
| 97 |
wrote for the Debian GNU/Linux system\&. |
| 98 |
It may be used, modified, and/or redistributed by others without |
| 99 |
contacting the authors\&. |