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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1//EN" "/usr/share/xml/docbook/schema/dtd/4.1/docbookx.dtd" [
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "<firstname>Roland</firstname>">
<!ENTITY dhsurname "<surname>Bless</surname>">
<!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>January 22, 2004</date>">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1). -->
<!ENTITY dhsection "<manvolnum>1</manvolnum>">
<!ENTITY dhemail "<email>roland@bless.de</email>">
<!ENTITY dhusername "Roland Bless">
<!ENTITY dhucpackage "<refentrytitle>bbox</refentrytitle>">
<!ENTITY dhpackage "bbox">
<!ENTITY dhmainpackage "PS2EPS">
<!ENTITY ps2epsver "1.68">
<!ENTITY bbox "<command>bbox</command>">
<!ENTITY gs "ghostscript">
<!ENTITY debian "<productname>Debian</productname>">
<!ENTITY gnu "<acronym>GNU</acronym>">
<!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
]>
<refentry>
<refentryinfo>
<address>
&dhemail;
</address>
<author>
&dhfirstname;
&dhsurname;
</author>
<copyright>
<year>2003</year>
<holder>&dhusername;</holder>
</copyright>
&dhdate;
</refentryinfo>
<refmeta>
&dhucpackage;
&dhsection;
<refmiscinfo class="source">&dhmainpackage;</refmiscinfo>
<refmiscinfo class="version">&ps2epsver;</refmiscinfo>
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>
prints out the bounding box of a rawppm or rawpbm image
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
&bbox;
<arg><option>-l</option></arg>
<arg><option>-r</option></arg>
<arg><option>-h</option></arg>
<arg><option>-V</option></arg>
<arg><replaceable>rawpbmfile</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para>&bbox; 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:
<screen>
%%BoundingBox: 12 253 829 837
%%HiResBoundingBox: 12.500000 253.000000 828.500000 837.00000
</screen>
</para>
<para>&bbox; 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.
</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term><option>-h | --help</option>
</term>
<listitem>
<para>Show summary of options.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-V</option>
</term>
<listitem>
<para>Show version of program.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-r</option>
</term>
<listitem>
<para>resolution of picture in dpi</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-l</option>
</term>
<listitem>
<para>loose bounding box (integer bounding box is expanded by 1
point, hires bounding box is expanded by 0.5 points)</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>ps2eps (1)</para>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>&bbox; was written by &dhusername;. </para>
<refsect2>
<title>ACKNOWLEDGMENTS</title>
<para>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.</para>
<para>An earlier version of this manual page was originally written by
Rafael Laboissiere <email>rafael@debian.org</email> 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.</para>
</refsect2>
</refsect1>
<refsect1 id="BUGS">
<title id="BUGS.title">BUGS</title>
<para>
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
&bbox; version number to &dhemail; (please allow some time
to reply).
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
|
