extractbb(1) [suse man page]

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  num-
       ber 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.  Unfor-
       tunately, 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)

pdfinfo(1)						      General Commands Manual							pdfinfo(1)

NAME

       pdfinfo - Portable Document Format (PDF) document information extractor (version 3.00)

SYNOPSIS

       pdfinfo [options] [PDF-file]

DESCRIPTION

       Pdfinfo prints the contents of the 'Info' dictionary (plus some other useful information) from a Portable Document Format (PDF) file.

       The 'Info' dictionary contains the following values:

	      title
	      subject
	      keywords
	      author
	      creator
	      producer
	      creation date
	      modification date

       In addition, the following information is printed:

	      tagged (yes/no)
	      page count
	      encrypted flag (yes/no)
	      print and copy permissions (if encrypted)
	      page size
	      file size
	      linearized (yes/no)
	      PDF version
	      metadata (only if requested)

OPTIONS

       -f number
	      Specifies  the  first  page to examine.  If multiple pages are requested using the "-f" and "-l" options, the size of each requested
	      page (and, optionally, the bounding boxes for each requested page) are printed.  Otherwise, only page one is examined.

       -l number
	      Specifies the last page to examine.

       -box   Prints the page box bounding boxes: MediaBox, CropBox, BleedBox, TrimBox, and ArtBox.

       -meta  Prints document-level metadata.  (This is the "Metadata" stream from the PDF file's Catalog object.)

       -enc encoding-name
	      Sets the encoding to use for text output. This defaults to "UTF-8".

       -listenc
	      Lits the available encodings

       -opw password
	      Specify the owner password for the PDF file.  Providing this will bypass all security restrictions.

       -upw password
	      Specify the user password for the PDF file.

       -v     Print copyright and version information.

       -h     Print usage information.	(-help and --help are equivalent.)

EXIT CODES

       The Xpdf tools use the following exit codes:

       0      No error.

       1      Error opening a PDF file.

       2      Error opening an output file.

       3      Error related to PDF permissions.

       99     Other error.

AUTHOR

       The pdfinfo software and documentation are copyright 1996-2004 Glyph & Cog, LLC.

SEE ALSO

       pdffonts(1), pdfimages(1), pdftocairo(1), pdftohtml(1), pdftoppm(1), pdftops(1), pdftotext(1)

								  22 January 2004							pdfinfo(1)