On Fri, Jan 14, 2005 at 06:59:28PM +0100, Daniel J. Priem wrote:
> Matthias can you please close this bug?
> Justification: user error. i think :)
>
>
>
> For Robert:
> No. Read the help / docu :)
Hi Daniel!
Sorry, but I read the docu, and it states:
SFFTOBMP(1)
NAME
sfftobmp -- structured fax file (sff) converter
SYNOPSIS
sfftobmp [] [_FILE] [TFILE]
DESCRIPTION
This manual page documents briefly the sfftobmp command.
This manual page was written for the Debian distribution because the
original program does not have a manual page. Most of the text is a
copy of the file /usr/share/doc/sfftobmp/readme.
sfftobmp is a program that converts SFF files in Modified Huffman (MH)
coding to Windows BMP (monochrome, uncompressed), PBM (Portable Bitmap,
RAWBITS P4-Header), JPEG or TIFF files.
SFF files containing more than one page will be split into one output
file per page, except for TIFF output which will be one multipaged
file.
OPTIONS
-h -help
Show summary of options.
-v -version
Show version of program.
-b -bmp
OUTFILE is one monochrome BMP file for each fax page.
-p -pbm
OUTFILE is one Portable Bitmap file for each fax page.
-j[NUM] -jpg=[NUM]
OUTFILE is one JPEG file for each fax page. NUM is optional
and specifies the jpeg quality in percent (1..99)
-T -tifs
OUTFILE is one single-page TIFF file for each fax page.
-t -tif
OUTFILE is one multi-paged TIFF file containing all pages.
-x -ext
Append type extension to output filename (e.g. '.bmp', etc.).
-o -orgres
Do not double lines in output image for low-res faxes.
Output naming
Please give the name of the outfile without extension. If the sff-file
contains multiple pages for each of them a separate file will be cre-
ated, named:
<outfile>001
<outfile>002
<outfile>xxx
If you want sfftobmp to add a extension to the filename, add the "-x"
option to the commandline. The filename(s) will then be
<outfile>xxx.bmp or
<outfile>xxx.pbm and so on...
TIFF is capable to contain more pages within one file, therefore only
one multipaged TIFF file will be created in this case. If you want to
have one TIFF file for each fax page, use "-T" instead of "-t".
For JPEG output you can optionally set the JPEG quality used by adding
a two-digit number between 1 and 99 to the option.
OUTPUT on STDOUT
Output on stdout is available for multipaged TIFF output only (option
"-t"). Use "-" as output filename in this case:
sfftobmp -t infile.sff - > out.tif
same:
sfftobmp -t infile.sff - > out.tif
NOTE: Reading from stdin is not supported.
Resolution Handling
SffToBmp keeps resolution information intact. This means, if you con-
vert a fax with 203x98 dpi this resolution information is written in
the output file if it is supported by the output format. This is JPEG,
TIFF and BMP.
However, as many bitmap viewer applications are not considering this
information while displaying the bitmap, SffToBmp defaults to double
scanlines if a low-res fax (i.e. 203x98 dpi) is converted.
In case your image viewer does actually treat resolution information
correctly (your image will look stretched vertically in this case), you
can suppress this scanline-doubling by specifying the "-o" option.
TODO
Check docbook refman to find out how to markup the rest of
/usr/share/doc/readme.
AUTHOR
This manual page was written by Achim Bohnet [EMAIL PROTECTED] for the
Debian system (but may be used by others). 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.
--- man page end ---
sfftobmp instead gives the following:
[EMAIL PROTECTED]:~$ sfftobmp -h
Usage: sfftobmp [options] INFILE1 [INFILE2 ..] [-o OUTSPEC]
That means the man page is totally out of date as the meaning of the
"-o" switch has changed. Please correct that.
I stumbled across this documentation bug when trying to install
capisuite. It uses sfftobmp to generate a PDF attachment for incoming
faxes. Unfortunately it still relies on the old behaviour, but I think I
have to file another bug against capisuite then...
Greetings
--
Robert Sander Senior Manager Information Systems
Epigenomics AG Kleine Praesidentenstr. 1 10178 Berlin, Germany
phone:+49-30-24345-330 fax:+49-30-24345-555
http://www.epigenomics.com [EMAIL PROTECTED]
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
