From f42adfd25798b5e894d60779508f5293e232c15e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 5 Sep 2009 00:14:55 +0000 Subject: updated extractbb (aka ebb, for us) man page from Matthias Franz, mail to karl 30 Aug 2009 21:55:23 git-svn-id: svn://tug.org/texlive/trunk@15115 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf/doc/man/man1/extractbb.1 | 83 +++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 Master/texmf/doc/man/man1/extractbb.1 (limited to 'Master/texmf/doc/man/man1/extractbb.1') diff --git a/Master/texmf/doc/man/man1/extractbb.1 b/Master/texmf/doc/man/man1/extractbb.1 new file mode 100644 index 00000000000..0562fdf17b2 --- /dev/null +++ b/Master/texmf/doc/man/man1/extractbb.1 @@ -0,0 +1,83 @@ +.TH "EXTRACTBB" "1" "30 August 2009" "20090708" "DVIPDFMx" +.PP +.SH "NAME" +extractbb, ebb \- extract bounding box information from graphics files +.PP +.SH "SYNOPSIS" +.PP +.BR extractbb " [ " -v " | " -q " ] [ " -O " ] [ " -m " | " -x " ] " +.I file ... +.PP +.SH "DESCRIPTION" +.PP +For each +.SM JPEG\c +, +.SM PNG\c +, or +.SM PDF +file given on the command line, +.B extractbb +extracts the bounding box information and writes it into a file with extension +.BR .xbb , +together with some header information. These files can then be used by +.B dvipdfmx +or other programs. For +.SM PDF +files, the number of pages and the +.SM PDF +version number are reported as well. +The input filename extension may be in upper or lower case. +.PP +If called as +.BR ebb , +the output is written in the ``bb'' format (and with extension +.BR .bb ) +as used by +.BR dvipdfm . +.B Xbb +may be defined as a synomym for +.B extractbb +on your system. +.PP +.SH "OPTIONS" +.PD 0 +.TP 10 +.B -v +Be verbose. +.TP +.B -q +Be quiet. +.TP +.B -O +Write output to standard output. +.TP +.B -m +Write output in dvipdfm's ``bb'' format. +.TP +.B -x +Write output in dvipdfmx's ``xbb'' format (default). +.PD +.PP +.SH "BUGS" +.PP +There is currently no way to specify which bounding box is taken +for +.SM 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 +.SM PDF +file. +.PP +.SH "AUTHOR" +.PP +\fBextractbb\fP was written by the DVIPDFMx project team +, based on the program \fBebb\fP by Mark A. Wicks. +.PP +This manual page was also written by the DVIPDFMx project team, +based on a manual page Frank K\[:u]ster +wrote for the Debian GNU/Linux system\&. +It may be used, modified, and/or redistributed by others without +contacting the authors\&. -- cgit v1.2.3