From fc22b3d6507c6745911b9dfcc68f1e665ae13dbc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:43:11 +0200 Subject: Adding upstream version 4.22.0. Signed-off-by: Daniel Baumann --- upstream/opensuse-leap-15-6/man1/pamfix.1 | 145 ++++++++++++++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 upstream/opensuse-leap-15-6/man1/pamfix.1 (limited to 'upstream/opensuse-leap-15-6/man1/pamfix.1') diff --git a/upstream/opensuse-leap-15-6/man1/pamfix.1 b/upstream/opensuse-leap-15-6/man1/pamfix.1 new file mode 100644 index 00000000..6207ffff --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/pamfix.1 @@ -0,0 +1,145 @@ +\ +.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. +.\" Do not hand-hack it! If you have bug fixes or improvements, please find +.\" the corresponding HTML page on the Netpbm website, generate a patch +.\" against that, and send it to the Netpbm maintainer. +.TH "Pamfix User Manual" 0 "06 March 2014" "netpbm documentation" + +.SH NAME + +pamfix - repair a Netpbm image with various corruptions + +.UN synopsis +.SH SYNOPSIS + +\fBpamfix\fP + +[\fB-truncate\fP] +[\fB-changemaxval\fP] +[\fB-clip\fP] +[\fB-verbose\fP] + +[\fInetpbmfile\fP] +.PP +Minimum unique abbreviation of option is acceptable. You may use double +hyphens instead of single hyphen to denote options. You may use white +space in place of the equals sign to separate an option name from its value. + + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpamfix\fP reads a stream that is mostly a Netpbm image but may have +certain types of corruptions and produces a valid Netpbm image that preserves +much of the information in the original. + +In particular, Netpbm salvages streams that are truncated and that contain +illegally large sample values. +.PP +\fBpamfix\fP looks at only on the first image in a multi-image stream. + + +.UN truncatedstream +.SS Truncated stream +.PP +This is a stream that is missing the last part. Netpbm corrects this +by creating an output image that simply has fewer rows. +.PP +You select this kind of repair with a \fB-truncate\fP option. +.PP +The header of a Netpbm image implies how large the image must +be (how many bytes the file must contain). If the file is actually +smaller than that, a Netpbm program that tries to read the image +fails, with an error message telling you that it couldn't read the +whole file. The data in the file is arranged in row order, from +top to bottom, and the most common reason for the file being smaller +than its header says it should be is because the bottommost rows are +simply missing. So \fBpamfix\fP assumes that is the case +and generates a new image with just the rows that are readable. +(technically, that means the output's header indicates a smaller +number of rows and omits any partial last row). +.PP +The most common way for a Netpbm file to be small is that something +interrupted the program that generated it before it was finished writing +the file. For example, the program ran out of its own input or +encountered a bug or ran out of space in which to write the output. +.PP +Another problem \fBpamfix\fP deals with is where the file isn't +actually too small, but because of a system error, a byte in the middle of +it cannot be read (think of a disk storage failure). \fBpamfix\fP +reads the input sequentially until it can't read any further, for any +reason. So it treats such an image as a truncated one, ignoring all +data after the unreadable byte. +.PP +But be aware that an image file is sometimes too small because of a +bug in the program that generated it, and in that case it is not +simply a matter of the bottom of the image missing, so +\fBpamfix\fP simply creates a valid Netpbm image containing a +garbage picture. +.PP +If you want to test an image file to see if it is corrupted by being +too small, use \fBpamfile --allimages\fP . It fails with an error +message if the file is too small. +.PP +If you want to cut the bottom off a valid Netpbm image, use +\fBpamcut\fP. + + +.UN excessivesample +.SS Excessive Sample Value +.PP +This is a stream that contains a purported sample value that is higher than +the maxval of the image. +.PP +The header of a Netpbm image tells the maxval of the image, which is a +value that gives meaning to all the sample values in the raster. The +sample values represent a fraction of the maxval, so a sample value that is +greater than the maxval makes no sense. +.PP +A regular Netpbm program fails if you give it input that contains a value +larger than the maxval where a sample value belongs. +.PP +\fBpamfix\fP has three ways of salvaging such a stream: + + +.IP \(bu +Clip to the maxval. Request this with \fB-clip\fP. +.IP \(bu +Raise the maxval, thus lowering the fraction represented by every sample +in the image. Request this with \fB-changemaxval\fP. +.IP \(bu +Truncate the image at the first invalid sample value. Request this with +\fB-truncate\fP and neither \fB-clip\fP nor \fB-changemaxval\fP. + +.PP +You cannot specify both \fB-clip\fP and \fB-changemaxval\fP. + + +.UN seealso +.SH SEE ALSO +.BR "pnm" (5)\c +\&, +.BR "pam" (5)\c +\&, +.BR "pamcut" (1)\c +\&, +.BR "pamfile" (1)\c +\&, + +.UN history +.SH HISTORY +.PP +\fBpamfix\fP was new in Netpbm 10.66 (March 2014). But it grew out of +\fBpamfixtrunc\fP, which was new in Netpbm 10.38 (March 2007) and did only +the truncated image repair (and for invalid sample values would simply pass +them through to its output, generating an invalid Netpbm image). +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/pamfix.html +.PP \ No newline at end of file -- cgit v1.2.3