Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
EXTRACTBB(1)			   DVIPDFMx			  EXTRACTBB(1)

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.  Unfortu-
       nately, 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 Kuster <frank@kuesterei.ch> wrote	for the	Debian
       GNU/Linux system.  It may be used, modified,  and/or  redistributed  by
       others without contacting the authors.

20120420			 20 April 2012			  EXTRACTBB(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=extractbb&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help