1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
.TH "EXTRACTBB" "1" "30 August 2009" "20090708" "DVIPDFMx"
.PP
.SH "NAME"
extractbb, ebb \- extract bounding box information from graphics files
.PP
.SH "SYNOPSIS"
.PP
.BR extractbb " [ " -v " | " -q " ] [ " -O " ] [ " -m " | " -x " ] "
.I file ...
.PP
.SH "DESCRIPTION"
.PP
For each
.SM JPEG\c
,
.SM PNG\c
, or
.SM PDF
file given on the command line,
.B extractbb
extracts the bounding box information and writes it into a file with extension
.BR .xbb ,
together with some header information. These files can then be used by
.B dvipdfmx
or other programs. For
.SM PDF
files, the number of pages and the
.SM PDF
version number are reported as well.
The input filename extension may be in upper or lower case.
.PP
If called as
.BR ebb ,
the output is written in the ``bb'' format (and with extension
.BR .bb )
as used by
.BR dvipdfm .
.B Xbb
may be defined as a synomym for
.B extractbb
on your system.
.PP
.SH "OPTIONS"
.PD 0
.TP 10
.B -v
Be verbose.
.TP
.B -q
Be quiet.
.TP
.B -O
Write output to standard output.
.TP
.B -m
Write output in dvipdfm's ``bb'' format.
.TP
.B -x
Write output in dvipdfmx's ``xbb'' format (default).
.PD
.PP
.SH "BUGS"
.PP
There is currently no way to specify which bounding box is taken
for
.SM PDF
files. It will always be the first one from the following
list: ArtBox, TrimBox, BleedBox, MediaBox. (Often only MediaBox
is defined.) Moreover, the reported bounding box always refers
to the first page in a
.SM PDF
file.
.PP
.SH "AUTHOR"
.PP
\fBextractbb\fP was written by the DVIPDFMx project team
<dvipdfmx@ktug.or.kr>, based on the program \fBebb\fP by Mark A. Wicks.
.PP
This manual page was also written by the DVIPDFMx project team,
based on a manual page Frank K\[:u]ster <frank@kuesterei\&.ch>
wrote for the Debian GNU/Linux system\&.
It may be used, modified, and/or redistributed by others without
contacting the authors\&.
|
