1EXTRACTBB(1)                       DVIPDFMx                       EXTRACTBB(1)
2
3
4

NAME

6       extractbb, ebb - extract bounding box information from graphics files
7

SYNOPSIS

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

DESCRIPTION

12       For  each  JPEG,  PNG, or PDF file given on the command line, extractbb
13       extracts the bounding box information and writes it into  a  file  with
14       extension  .xbb, together with some header information. These files can
15       then be used by dvipdfmx or other programs. For PDF files,  the  number
16       of  pages  and  the PDF version number are reported as well.  The input
17       filename extension may be in upper or lower case.
18
19       If called as ebb, the output is written in the ``bb'' format (and  with
20       extension .bb) as used by dvipdfm.  Xbb may be defined as a synomym for
21       extractbb on your system.
22

OPTIONS

24       -v        Be verbose.
25       -q        Be quiet.
26       -O        Write output to standard output.
27       -m        Write output in dvipdfm's ``bb'' format.
28       -x        Write output in dvipdfmx's ``xbb'' format (default), which is
29                 the same as that used by pdfTeX.
30

OUTPUT FORMATS

32       Here are more details about the bb and xbb formats:
33
34       The  original  ebb (from dvipdfm) ignored density information in bitmap
35       images, and generated bounding boxes with 100px = 72bp = 1in.  Unfortu‐
36       nately, screenshots (especially) tend to look bad with this approach.
37
38       So,  extractbb  (from  dvipdfmx)  uses  density information if present.
39       Otherwise, it generates bounding box with 100px = 100bp.  This is  what
40       pdfTeX does.
41

BUGS

43       There  is  currently  no way to specify which bounding box is taken for
44       PDF files. It will always be the first one  from  the  following  list:
45       ArtBox,  TrimBox, BleedBox, MediaBox. (Often only MediaBox is defined.)
46       Moreover, the reported bounding box always refers to the first page  in
47       a PDF file.
48

AUTHOR

50       extractbb    was    written    by    the    DVIPDFMx    project    team
51       <dvipdfmx@ktug.or.kr>, based on the program ebb by Mark A. Wicks.
52
53       This manual page was also written by the DVIPDFMx project  team,  based
54       on a manual page Frank Küster <frank@kuesterei.ch> wrote for the Debian
55       GNU/Linux system.  It may be used, modified,  and/or  redistributed  by
56       others without contacting the authors.
57
58
59
6020120420                         20 April 2012                    EXTRACTBB(1)