git.saurik.com Git - wxWidgets.git/blob - src/tiff/html/man/fax2tiff.1.html

1

2

3 <html>

4 <head>

 <meta name="generator" content="groff -Thtml, see www.gnu.org">

 <meta name="Content-Style" content="text/css">

7 <title>FAX2TIFF</title>

8 </head>

9 <body>

11 <h1 align=center>FAX2TIFF</h1>

 <a href="#NAME">NAME</a><br>

 <a href="#SYNOPSIS">SYNOPSIS</a><br>

 <a href="#DESCRIPTION">DESCRIPTION</a><br>

 <a href="#OPTIONS">OPTIONS</a><br>

 <a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>

 <a href="#BUGS">BUGS</a><br>

 <a href="#SEE ALSO">SEE ALSO</a><br>

20 <hr>

21 <a name="NAME"></a>

22 <h2>NAME</h2>

23

 <table width="100%" border=0 rules="none" frame="void"

        cols="2" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

27 <td width="8%"></td>

28 <td width="91%">

29 fax2tiff − create a TIFF Class F fax

30 file from raw fax data

31 </td>

32 </table>

33 <a name="SYNOPSIS"></a>

34 <h2>SYNOPSIS</h2>

35

 <table width="100%" border=0 rules="none" frame="void"

        cols="2" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

39 <td width="8%"></td>

40 <td width="91%">

 <p><b>fax2tiff</b> [ <i>options</i> ] [ <b>&minus;o</b>

42 output.tif ] input.raw

43 </td>

44 </table>

45 <a name="DESCRIPTION"></a>

46 <h2>DESCRIPTION</h2>

47

 <table width="100%" border=0 rules="none" frame="void"

        cols="2" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

51 <td width="8%"></td>

52 <td width="91%">

53 Fax2tiff creates a TIFF file

54 containing CCITT Group 3 or Group 4 encoded

55 data from one or more files containing

56 ‘‘raw’’ Group 3 or Group 4 encoded

57 data (typically obtained directly from a fax modem). By

58 default, each row of data in the resultant

59 TIFF file is 1-dimensionally encoded and

60 padded or truncated to 1728 pixels, as needed. The resultant

61 image is a set of low resolution (98 lines/inch) or medium

62 resolution (196 lines/inch) pages, each of which is a single

63 strip of data. The generated file conforms to the

64 TIFF Class F ( FAX )

65 specification for storing facsimile data. This means, in

66 particular, that each page of the data does not

67 include the trailing return to control (

68 RTC ) code; as required for transmission by

69 the CCITT Group 3 specifications. The old,

70 ‘‘classic’’, format is created if

71 the −c option is used. (The Class F format can

72 also be requested with the −f option.)

73

74 The default name of the output image is fax.tif;

75 this can be changed with the −o option. Each

76 input file is assumed to be a separate page of facsimile

77 data from the same document. The order in which input files

78 are specified on the command line is the order in which the

79 resultant pages appear in the output file.

80 </td>

81 </table>

82 <a name="OPTIONS"></a>

83 <h2>OPTIONS</h2>

84

 <table width="100%" border=0 rules="none" frame="void"

        cols="2" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

88 <td width="8%"></td>

89 <td width="91%">

90 Options that affect the interpretation of input data

91 are:

92 </td>

93 </table>

94

 <table width="100%" border=0 rules="none" frame="void"

        cols="5" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

98 <td width="10%"></td>

99 <td width="3%">

100

101 −3

102 </td>

103 <td width="5%"></td>

104 <td width="80%">

105

106 Assume input data is CCITT Group 3

107 encoded (default).

108 </td>

109 <td width="0%">

110 </td>

 <tr valign="top" align="left">

112 <td width="10%"></td>

113 <td width="3%">

114

115 −4

116 </td>

117 <td width="5%"></td>

118 <td width="80%">

119

120 Assume input data is CCITT Group 4

121 encoded.

122 </td>

123 <td width="0%">

124 </td>

 <tr valign="top" align="left">

126 <td width="10%"></td>

127 <td width="3%">

128

129 −U

130 </td>

131 <td width="5%"></td>

132 <td width="80%">

133

134 Assume input data is uncompressed (Group 3 or Group

135 4).

136 </td>

137 <td width="0%">

138 </td>

 <tr valign="top" align="left">

140 <td width="10%"></td>

141 <td width="3%">

142

143 −1

144 </td>

145 <td width="5%"></td>

146 <td width="80%">

147

148 Assume input data is encoded with the 1-dimensional

149 version of the CCITT Group 3 Huffman encoding

150 algorithm (default).

151 </td>

152 <td width="0%">

153 </td>

 <tr valign="top" align="left">

155 <td width="10%"></td>

156 <td width="3%">

157

158 −2

159 </td>

160 <td width="5%"></td>

161 <td width="80%">

162

163 Assume input data is 2-dimensional version of the

164 CCITT Group 3 Huffman encoding algorithm.

165 </td>

166 <td width="0%">

167 </td>

 <tr valign="top" align="left">

169 <td width="10%"></td>

170 <td width="3%">

171

172 −P

173 </td>

174 <td width="5%"></td>

175 <td width="80%">

176

177 Assume input data is not EOL-aligned (default).

178 This option has effect with Group 3 encoded input only.

179 </td>

180 <td width="0%">

181 </td>

 <tr valign="top" align="left">

183 <td width="10%"></td>

184 <td width="3%">

185

186 −A

187 </td>

188 <td width="5%"></td>

189 <td width="80%">

190

191 Assume input data is EOL-aligned. This option has effect

192 with Group 3 encoded input only.

193 </td>

194 <td width="0%">

195 </td>

 <tr valign="top" align="left">

197 <td width="10%"></td>

198 <td width="3%">

199

200 −M

201 </td>

202 <td width="5%"></td>

203 <td width="80%">

204

205 Treat input data as having bits filled from most

206 significant bit ( MSB ) to most least bit (

207 LSB ).

208 </td>

209 <td width="0%">

210 </td>

 <tr valign="top" align="left">

212 <td width="10%"></td>

213 <td width="3%">

214

215 −L

216 </td>

217 <td width="5%"></td>

218 <td width="80%">

219

220 Treat input data as having bits filled from least

221 significant bit ( LSB ) to most significant

222 bit ( MSB ) (default).

223 </td>

224 <td width="0%">

225 </td>

 <tr valign="top" align="left">

227 <td width="10%"></td>

228 <td width="3%">

229

230 −B

231 </td>

232 <td width="5%"></td>

233 <td width="80%">

234

235 Assume input data was encoded with black as 0 and white

236 as 1.

237 </td>

238 <td width="0%">

239 </td>

 <tr valign="top" align="left">

241 <td width="10%"></td>

242 <td width="3%">

243

244 −W

245 </td>

246 <td width="5%"></td>

247 <td width="80%">

248

249 Assume input data was encoded with black as 1 and white

250 as 0 (default).

251 </td>

252 <td width="0%">

253 </td>

 <tr valign="top" align="left">

255 <td width="10%"></td>

256 <td width="3%">

257

258 −R

259 </td>

260 <td width="5%"></td>

261 <td width="80%">

262

263 Specify the vertical resolution, in lines/inch, of the

264 input images. By default input are assumed to have a

265 vertical resolution of 196 lines/inch. If images are low

266 resolution facsimile, a value of 98 lines/inch should be

267 specified.

268 </td>

269 <td width="0%">

270 </td>

 <tr valign="top" align="left">

272 <td width="10%"></td>

273 <td width="3%">

274

275 −X

276 </td>

277 <td width="5%"></td>

278 <td width="80%">

279

280 Specify the width, in pixels, of the input images. By

281 default input are assumed to have a width of 1728

282 pixels.

283 </td>

284 <td width="0%">

285 </td>

286 </table>

287

 <table width="100%" border=0 rules="none" frame="void"

        cols="2" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

291 <td width="8%"></td>

292 <td width="91%">

293 Options that affect the output file format are:

294 </td>

295 </table>

296

 <table width="100%" border=0 rules="none" frame="void"

        cols="5" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

300 <td width="10%"></td>

301 <td width="3%">

302

303 −o

304 </td>

305 <td width="5%"></td>

306 <td width="80%">

307

308 Specify the name of the output file.

309 </td>

310 <td width="0%">

311 </td>

 <tr valign="top" align="left">

313 <td width="10%"></td>

314 <td width="3%">

315

316 −7

317 </td>

318 <td width="5%"></td>

319 <td width="80%">

320

321 Force output to be compressed with the

322 CCITT Group 3 Huffman encoding algorithm

323 (default).

324 </td>

325 <td width="0%">

326 </td>

 <tr valign="top" align="left">

328 <td width="10%"></td>

329 <td width="3%">

330

331 −8

332 </td>

333 <td width="5%"></td>

334 <td width="80%">

335

336 Force output to be compressed with the

337 CCITT Group 4 Huffman encoding.

338 </td>

339 <td width="0%">

340 </td>

 <tr valign="top" align="left">

342 <td width="10%"></td>

343 <td width="3%">

344

345 −u

346 </td>

347 <td width="5%"></td>

348 <td width="80%">

349

350 Force output to be uncompressed (Group 3 or Group

351 4).

352 </td>

353 <td width="0%">

354 </td>

 <tr valign="top" align="left">

356 <td width="10%"></td>

357 <td width="3%">

358

359 −5

360 </td>

361 <td width="5%"></td>

362 <td width="80%">

363

364 Force output to be encoded with the 1-dimensional

365 version of the CCITT Group 3 Huffman encoding

366 algorithm.

367 </td>

368 <td width="0%">

369 </td>

 <tr valign="top" align="left">

371 <td width="10%"></td>

372 <td width="3%">

373

374 −6

375 </td>

376 <td width="5%"></td>

377 <td width="80%">

378

379 Force output to be encoded with the 2-dimensional

380 version of the CCITT Group 3 Huffman encoding

381 algorithm (default).

382 </td>

383 <td width="0%">

384 </td>

 <tr valign="top" align="left">

386 <td width="10%"></td>

387 <td width="3%">

388

389 −a

390 </td>

391 <td width="5%"></td>

392 <td width="80%">

393

394 Force the last bit of each End Of Line (

395 EOL ) code to land on a byte boundary

396 (default). This ‘‘zero padding’’

397 will be reflected in the contents of the

398 Group3Options tag of the resultant

399 TIFF file. This option has effect with Group

400 3 encoded output only.

401 </td>

402 <td width="0%">

403 </td>

 <tr valign="top" align="left">

405 <td width="10%"></td>

406 <td width="3%">

407

408 −p

409 </td>

410 <td width="5%"></td>

411 <td width="80%">

412

413 Do not EOL-align output. This option has effect with

414 Group 3 encoded output only.

415 </td>

416 <td width="0%">

417 </td>

 <tr valign="top" align="left">

419 <td width="10%"></td>

420 <td width="3%">

421

422 −c

423 </td>

424 <td width="5%"></td>

425 <td width="80%">

426

 <p>Generate &quot;classic&quot; Group 3 TIFF format.</p>

428 </td>

429 <td width="0%">

430 </td>

 <tr valign="top" align="left">

432 <td width="10%"></td>

433 <td width="3%">

434

435 −f

436 </td>

437 <td width="5%"></td>

438 <td width="80%">

439

440 Generate TIFF Class F (TIFF/F) format (default).

441 </td>

442 <td width="0%">

443 </td>

 <tr valign="top" align="left">

445 <td width="10%"></td>

446 <td width="3%">

447

448 −m

449 </td>

450 <td width="5%"></td>

451 <td width="80%">

452

453 Force output data to have bits filled from most

454 significant bit ( MSB ) to most least bit (

455 LSB ).

456 </td>

457 <td width="0%">

458 </td>

 <tr valign="top" align="left">

460 <td width="10%"></td>

461 <td width="3%">

462

463 −l

464 </td>

465 <td width="5%"></td>

466 <td width="80%">

467

468 Force output data to have bits filled from least

469 significant bit ( LSB ) to most significant

470 bit ( MSB ) (default).

471 </td>

472 <td width="0%">

473 </td>

 <tr valign="top" align="left">

475 <td width="10%"></td>

476 <td width="3%">

477

478 −r

479 </td>

480 <td width="5%"></td>

481 <td width="80%">

482

483 Specify the number of rows (scanlines) in each strip of

484 data written to the output file. By default (or when value

 <b>0</b> is specified), <i>tiffcp</i> attempts to set the

486 rows/strip that no more than 8 kilobytes of data appear in a

487 strip (with except of G3/G4 compression schemes). If you

488 specify special value −1 it will results in

489 infinite number of the rows per strip. The entire image will

490 be the one strip in that case. This is default in case of

491 G3/G4 output compression schemes.

492 </td>

493 <td width="0%">

494 </td>

 <tr valign="top" align="left">

496 <td width="10%"></td>

497 <td width="3%">

498

499 −s

500 </td>

501 <td width="5%"></td>

502 <td width="80%">

503

504 Stretch the input image vertically by writing each input

505 row of data twice to the output file.

506 </td>

507 <td width="0%">

508 </td>

 <tr valign="top" align="left">

510 <td width="10%"></td>

511 <td width="3%">

512

513 −v

514 </td>

515 <td width="5%"></td>

516 <td width="80%">

517

518 Force fax2tiff to print the number of rows of

519 data it retrieved from the input file.

520 </td>

521 <td width="0%">

522 </td>

 <tr valign="top" align="left">

524 <td width="10%"></td>

525 <td width="3%">

526

527 −z

528 </td>

529 <td width="5%"></td>

530 <td width="80%">

531

532 Force output to be compressed with the LZW encoding.

533 </td>

534 <td width="0%">

535 </td>

536 </table>

537 <a name="DIAGNOSTICS"></a>

538 <h2>DIAGNOSTICS</h2>

539

 <table width="100%" border=0 rules="none" frame="void"

        cols="2" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

543 <td width="8%"></td>

544 <td width="91%">

545 The following warnings and errors come from the decoding

546 routines in the library.

547

548 Warning, %s: Premature EOL at scanline %d (x

549 %d).\n. The input data had a row that was shorter than

550 the expected width. The row is padded with white.

551

552 %s: Premature EOF at scanline %d (x %d).\n. The

553 decoder ran out of data in the middle of a scanline. The

554 resultant row is padded with white.

555

556 %s: Bad code word at row %d, x %d\n. An invalid

557 Group 3 code was encountered while decoding the input

558 file. The row number and horizontal position is given. The

559 remainder of the input row is discarded, while the

560 corresponding output row is padded with white.

561

562 %s: Bad 2D code word at scanline %d.\n. An invalid

 Group 4 or 2D Group 3 <i>code</i> was encountered while

564 decoding the input file. The row number and horizontal

565 position is given. The remainder of the input row is

566 discarded, while the corresponding output row is padded with

567 white.

568 </td>

569 </table>

570 <a name="BUGS"></a>

571 <h2>BUGS</h2>

572

 <table width="100%" border=0 rules="none" frame="void"

        cols="2" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

576 <td width="8%"></td>

577 <td width="91%">

578 Input data are assumed to have a a ‘‘top

579 left’’ orientation; it should be possible to

580 override this assumption from the command line.

581 </td>

582 </table>

583 <a name="SEE ALSO"></a>

584 <h2>SEE ALSO</h2>

585

 <table width="100%" border=0 rules="none" frame="void"

        cols="2" cellspacing="0" cellpadding="0">

 <tr valign="top" align="left">

589 <td width="8%"></td>

590 <td width="91%">

591 CCITT Recommendation T.4

592 (Standardization of Group 3 Facsimile Apparatus for Document

593 Transmission).

594

595 The Spirit of TIFF Class F, an appendix to the

596 TIFF 5.0 specification prepared by Cygnet Technologies.

597

 <p><b>tiffinfo</b>(1), <b>tiffdither</b>(1),

 <b>tiffgt</b>(1), <b>libtiff</b>(3)</p>

600

601 Libtiff library home page:

602 http://www.remotesensing.org/libtiff/

603 </td>

604 </table>

605 <hr>

606 </body>

607 </html>