Debian Codegraph @

texmf-dist/doc/man/man1/extractbb.1

raw
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\&.