NAME

       extractbb, ebb - extract bounding box information from graphics files

SYNOPSIS

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

DESCRIPTION

       For each JPEG, PNG, or PDF file given on the command line, extractbb extracts the bounding
       box information and writes it into a file with extension .xbb, together with  some  header
       information.  These  files  can then be used by dvipdfmx or other programs. For PDF files,
       the number of pages and the PDF version number are reported as well.  The  input  filename
       extension may be in upper or lower case.

       If  called  as ebb, the output is written in the ``bb'' format (and with extension .bb) as
       used by dvipdfm.  Xbb may be defined as a synomym for extractbb on your system.

OPTIONS

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

OUTPUT FORMATS

       Here are more details about the bb and xbb formats:

       The  original  ebb  (from  dvipdfm)  ignored  density  information  in  bitmap images, and
       generated bounding boxes with 100px = 72bp = 1in.  Unfortunately, screenshots (especially)
       tend to look bad with this approach.

       So,  extractbb  (from  dvipdfmx)  uses  density  information  if  present.   Otherwise, it
       generates bounding box with 100px = 100bp.  This is what pdfTeX does.

BUGS

       There is currently no way to specify which bounding box is taken for 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 PDF file.

AUTHOR

       extractbb  was  written  by  the DVIPDFMx project team <dvipdfmx@ktug.or.kr>, based on the
       program ebb by Mark A. Wicks.

       This manual page was also written by the DVIPDFMx project team, based  on  a  manual  page
       Frank  Kü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.