Debian Codegraph @

texmf-dist/doc/man/man1/dosepsbin.1

raw
1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.13
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sh \" Subsection heading
6 .br
7 .if t .Sp
8 .ne 5
9 .PP
10 \fB\\$1\fR
11 .PP
12 ..
13 .de Sp \" Vertical space (when we can't use .PP)
14 .if t .sp .5v
15 .if n .sp
16 ..
17 .de Vb \" Begin verbatim text
18 .ft CW
19 .nf
20 .ne \\$1
21 ..
22 .de Ve \" End verbatim text
23 .ft R
24 .fi
25 ..
26 .\" Set up some character translations and predefined strings. \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote. | will give a
29 .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30 .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
32 .tr \(*W-|\(bv\*(Tr
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34 .ie n \{\
35 . ds -- \(*W-
36 . ds PI pi
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
39 . ds L" ""
40 . ds R" ""
41 . ds C` ""
42 . ds C' ""
43 'br\}
44 .el\{\
45 . ds -- \|\(em\|
46 . ds PI \(*p
47 . ds L" ``
48 . ds R" ''
49 'br\}
50 .\"
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53 .\" entries marked with X<> in POD. Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
55 .if \nF \{\
56 . de IX
57 . tm Index:\\$1\t\\n%\t"\\$2"
58 ..
59 . nr % 0
60 . rr F
61 .\}
62 .\"
63 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
65 .hy 0
66 .if n .na
67 .\"
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69 .\" Fear. Run. Save yourself. No user-serviceable parts.
70 . \" fudge factors for nroff and troff
71 .if n \{\
72 . ds #H 0
73 . ds #V .8m
74 . ds #F .3m
75 . ds #[ \f1
76 . ds #] \fP
77 .\}
78 .if t \{\
79 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80 . ds #V .6m
81 . ds #F 0
82 . ds #[ \&
83 . ds #] \&
84 .\}
85 . \" simple accents for nroff and troff
86 .if n \{\
87 . ds ' \&
88 . ds ` \&
89 . ds ^ \&
90 . ds , \&
91 . ds ~ ~
92 . ds /
93 .\}
94 .if t \{\
95 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
101 .\}
102 . \" troff and (daisy-wheel) nroff accents
103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110 .ds ae a\h'-(\w'a'u*4/10)'e
111 .ds Ae A\h'-(\w'A'u*4/10)'E
112 . \" corrections for vroff
113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115 . \" for low resolution devices (crt and lpr)
116 .if \n(.H>23 .if \n(.V>19 \
117 \{\
118 . ds : e
119 . ds 8 ss
120 . ds o a
121 . ds d- d\h'-1'\(ga
122 . ds D- D\h'-1'\(hy
123 . ds th \o'bp'
124 . ds Th \o'LP'
125 . ds ae ae
126 . ds Ae AE
127 .\}
128 .rm #[ #] #H #V #F C
129 .\" ========================================================================
130 .\"
131 .IX Title "DOSEPSBIN 1"
132 .TH DOSEPSBIN 1 "2012-03-22 v1.2" "perl v5.8.1" "User Contributed Perl Documentation"
133 .SH "NAME"
134 dosepsbin \-\- Extract PS/WMF/TIFF sections from DOS EPS binary files
135 .SH "VERSION"
136 .IX Header "VERSION"
137 2012\-03\-22 v1.2
138 .SH "SYNOPSIS"
139 .IX Header "SYNOPSIS"
140 The progam \fBdosepsbin\fR analyses an \s-1EPS\s0 file that is not
141 a plain \s-1ASCII\s0 PostScript file but given as \s-1DOS\s0 \s-1EPS\s0 binary file.
142 .PP
143 .Vb 1
144 \& dosepsbin [options] <input file>
145 .Ve
146 .PP
147 First it analyzes the \fIinput file\fR, validates its header
148 and summarizes the available sections. Depending on the
149 given options, the sections are then written to files.
150 .PP
151 Options:
152 .PP
153 .Vb 9
154 \& --eps-file <file> Write PS section to <file>.
155 \& --wmf-file <file> Write WMF section to <file>.
156 \& --tiff-file <file> Write TIFF section to <file>.
157 \& --inputfile <file> The name of the input file.
158 \& --verbose Verbose output.
159 \& --quiet Only errors and warnings are printed.
160 \& --help Brief help message.
161 \& --man Full documentation.
162 \& --version Print version identification.
163 .Ve
164 .PP
165 The files for output must be different from the input file.
166 .SH "DESCRIPTION"
167 .IX Header "DESCRIPTION"
168 .Sh "\s-1DOS\s0 \s-1EPS\s0 Binary File Format"
169 .IX Subsection "DOS EPS Binary File Format"
170 A Encapsulated PostScript (\s-1EPS\s0) file can also given in a special
171 binary format to support the inclusion of a thumbnail. The file
172 format starts with a binary header that contains the positions of
173 the possible sections:
174 .IP "* Postscript (\s-1PS\s0)" 4
175 .IX Item "Postscript (PS)"
176 .PD 0
177 .IP "* Windows Metafile Format (\s-1WMF\s0)" 4
178 .IX Item "Windows Metafile Format (WMF)"
179 .IP "* Tag Image File Format (\s-1TIFF\s0)" 4
180 .IX Item "Tag Image File Format (TIFF)"
181 .PD
182 .PP
183 The \s-1PS\s0 section must be present and either the \s-1WMF\s0 file or the \s-1TIFF\s0
184 file should be given.
185 .SH "OPTIONS"
186 .IX Header "OPTIONS"
187 .IP "\fB\-\fR\fB\-eps\-file\fR=<\fIfile\fR>" 4
188 .IX Item "--eps-file=<file>"
189 The \s-1PS\s0 section is written to <\fIfile\fR>. The output file must
190 be different from the input file.
191 .IP "\fB\-\fR\fB\-wmf\-file\fR=<\fIfile\fR>" 4
192 .IX Item "--wmf-file=<file>"
193 The \s-1WMF\s0 section is written to <\fIfile\fR> if present. The output
194 file must be different from the input file.
195 .IP "\fB\-\fR\fB\-tiff\-file\fR=<\fIfile\fR>" 4
196 .IX Item "--tiff-file=<file>"
197 The \s-1TIFF\s0 section is written to <\fIfile\fR> if present. The output
198 file must be different from the input file.
199 .IP "\fB\-\fR\fB\-inputfile\fR=<\fIfile\fR>" 4
200 .IX Item "--inputfile=<file>"
201 The input file can also be given directly on the command line.
202 If the file does not exist, then the file with extension `.eps'
203 is tried.
204 .IP "\fB\-\fR\fB\-verbose\fR" 4
205 .IX Item "--verbose"
206 Verbose messages.
207 .IP "\fB\-\fR\fB\-quiet\fR" 4
208 .IX Item "--quiet"
209 No messages are printed except for errors and warnings.
210 .IP "\fB\-\fR\fB\-help\fR" 4
211 .IX Item "--help"
212 Display help screen.
213 .IP "\fB\-\fR\fB\-man\fR" 4
214 .IX Item "--man"
215 Prints manual page.
216 .IP "\fB\-\fR\fB\-version\fR" 4
217 .IX Item "--version"
218 Print version identification and exit.
219 .SH "EXAMPLES"
220 .IX Header "EXAMPLES"
221 The following command extracts the \s-1PS\s0 section from file \fItest.eps\fR
222 and stores the result in file \fItest\-ps.eps\fR:
223 .PP
224 .Vb 1
225 \& dosepsbin --eps-file test-ps.eps test.eps
226 .Ve
227 .SH "AUTHOR"
228 .IX Header "AUTHOR"
229 Heiko Oberdiek, email: heiko.oberdiek at googlemail.com
230 .SH "COPYRIGHT AND LICENSE"
231 .IX Header "COPYRIGHT AND LICENSE"
232 Copyright 2011\-2012 by Heiko Oberdiek.
233 .PP
234 This library is free software; you may redistribute it and/or
235 modify it under the same terms as Perl itself
236 (Perl Artistic License/GNU General Public License, version 2).
237 .SH "SEE ALSO"
238 .IX Header "SEE ALSO"
239 The \s-1DOS\s0 \s-1EPS\s0 binary file format is described
240 in section \*(L"5.2 Windows Metafile or \s-1TIFF\s0\*(R":
241 .PP
242 .Vb 5
243 \& Adobe Developer Support,
244 \& Encapsulated PostScript File Format Specification,
245 \& Version 3.0,
246 \& 1992-05-01,
247 \& http://partners.adobe.com/public/developer/en/ps/5002.EPSF_Spec.pdf
248 .Ve
249 .SH "HISTORY"
250 .IX Header "HISTORY"
251 .IP "\fB2011/11/10 v1.0\fR" 2
252 .IX Item "2011/11/10 v1.0"
253 .RS 2
254 .PD 0
255 .IP "* First version." 2
256 .IX Item "First version."
257 .RE
258 .RS 2
259 .RE
260 .IP "\fB2011/12/05 v1.1\fR" 2
261 .IX Item "2011/12/05 v1.1"
262 .RS 2
263 .IP "* Typo fixed in help text (thanks Peter Breitenlohner)." 2
264 .IX Item "Typo fixed in help text (thanks Peter Breitenlohner)."
265 .RE
266 .RS 2
267 .RE
268 .IP "\fB2012/03/22 v1.2\fR" 2
269 .IX Item "2012/03/22 v1.2"
270 .RS 2
271 .IP "* Fix in validation test for offset of \s-1PS\s0 section." 2
272 .IX Item "Fix in validation test for offset of PS section."
273 .RE
274 .RS 2
275 .RE