summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/bbox.1
blob: 64696f326454f356b25f3e680ed76080c91ab7b8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "BBOX" "1" "31 August 2010" "" ""

.SH NAME
bbox \- prints out the bounding box of a rawppm or rawpbm image
.SH SYNOPSIS

\fBbbox\fR [ \fB-l\fR ] [ \fB-r\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB\fIrawpbmfile\fB\fR ]

.SH "DESCRIPTION"
.PP
\fBbbox\fR reads a rawppm or rawpbm file
and prints out the bounding box of the image (as postscript comment and
in postscript points, i.e. 1/72dpi) as well as the high resolution
bounding box. Input is read from standard input if no filename is
specified.
Example output:

.nf
	  %%BoundingBox: 12 253 829 837
	  %%HiResBoundingBox: 12.500000 253.000000 828.500000 837.00000
	  
.fi
.PP
\fBbbox\fR has only very limited memory requirements
as it reads the input line by line and thus needs to store only one picture
line in memory.
.SH "OPTIONS"
.TP
\fB-h | --help \fR
Show summary of options.
.TP
\fB-V \fR
Show version of program.
.TP
\fB-r \fR
resolution of picture in dpi
.TP
\fB-l \fR
loose bounding box (integer bounding box is expanded by 1
point, hires bounding box is expanded by 0.5 points)
.SH "SEE ALSO"
.PP
ps2eps (1)
.SH "AUTHOR"
.PP
\fBbbox\fR was written by Roland Bless. 
.SS "ACKNOWLEDGMENTS"
.PP
Special thanks goes to Michael Sharpe from UCSD who suggested a lot of improvements for 
bbox to become more precise and robust, especially for small drawings.
.PP
An earlier version of this manual page was originally written by 
Rafael Laboissiere <rafael@debian.org> for
the Debian system. Thank you Rafael! Permission is
granted to copy, distribute and/or modify this document under
the terms of the GNU Free Documentation
License, Version 1.1 or any later version published by the Free
Software Foundation; with no Invariant Sections, no Front-Cover
Texts and no Back-Cover Texts.
.SH "BUGS"
.PP
Though the code is quite small and the probability for bugs
is now small, there may be some left somewhere between the lines.
In case you find one, please send a short description with
\fBbbox\fR version number to <roland@bless.de> (please allow some time
to reply).