Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 171 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man1/pamdice.1 b/upstream/mageia-cauldron/man1/pamdice.1
new file mode 100644
index 00000000..e994ac43
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pamdice.1
@@ -0,0 +1,171 @@
+\
+.\" 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 "Pamdice User Manual" 0 "01 April 2007" "netpbm documentation"
+
+.SH NAME
+pamdice - slice a Netpbm image into many horizontally and/or vertically
+
+.UN example
+.SH EXAMPLE
+
+.nf
+\f(CW
+    $ pamdice myimage.ppm -outstem=myimage_part -width=10 -height=8
+    $ pamundice myimage_part_%1d_%1a.ppm -across=10 -down=8 >myimage.ppm
+
+    $ pamdice myimage.ppm -outstem=myimage_part -height=12 -voverlap=9
+\fP
+
+.fi
+
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamdice\fP
+
+\fB-outstem=\fP\fIfilenamestem\fP
+
+[\fB-width=\fP\fIwidth\fP]
+
+[\fB-height=\fP\fIheight\fP]
+
+[\fB-hoverlap=\fP\fIhoverlap\fP]
+
+[\fB-voverlap=\fP\fIvoverlap\fP]
+
+[\fB-verbose\fP]
+
+[\fIfilename\fP]
+.PP
+You can use the minimum unique abbreviation of the options.  You can use
+two hyphens instead of one.  You can separate an option name from its value
+with white space instead of an equals sign.
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpamdice\fP reads a PAM, PBM, PGM, or PPM image as input and
+splits it horizontally and/or vertically into equal size pieces and
+writes them into separate files as the same kind of image.  You can
+optionally make the pieces overlap.
+.PP
+See the \fB-outstem\fP option for information on naming of the
+output files.
+.PP
+The \fB-width\fP and \fB-height\fP options determine the size of
+the output pieces.
+.PP
+\fBpamundice\fP can rejoin the images.  For finer control, you can
+also use 
+.PP
+\fBpnmcat\fP.
+.PP
+One use for this is to make pieces that take less computer resources
+than the whole image to process.  For example, you might have an image
+so large that an image editor can't read it all into memory or processes
+it very slowly.  With \fBpamdice\fP, you can split it into smaller pieces,
+edit one at a time, and then reassemble them.
+.PP
+Another use for this is to print a large image in small printer-sized
+pieces that you can glue together.  \fBppmglobe\fP does a similar thing;
+it lets you glue the pieces together into a sphere.
+.PP
+If you want to cut pieces from an image individually, not in a regular
+grid, use \fBpamcut\fP.
+
+
+.UN options
+.SH OPTIONS
+.PP
+In addition to the options common to all programs based on libnetpbm
+(most notably \fB-quiet\fP, see 
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&), \fBpamdice\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-outstem=\fPfilenamestem
+This option determines the names of the output files.  Each output
+file is named
+\fIfilenamestem\fP\fB_\fP\fIy\fP\fB_\fP\fIx\fP\fB.\fP\fItype\fP
+where \fIfilenamestem\fP is the value of the \fB-outstem\fP option,
+\fIx\fP and y are the horizontal and vertical locations,
+respectively, in the input image of the output image, zero being the
+leftmost and top, and \fItype\fP is \fB.pbm\fP, \fB.pgm\fP,
+\fB.ppm\fP, or \fB.pam\fP, depending on the type of image.
+
+.TP
+\fB-width=\fP\fIwidth\fP
+gives the width in pixels of the output images.  The rightmost
+pieces are smaller than this if the input image is not a multiple of
+\fIwidth\fP pixels wide.
+
+.TP
+\fB-height=\fP\fIheight\fP
+gives the height in pixels of the output images.  The bottom
+pieces are smaller than this if the input image is not a multiple of
+\fIheight\fP pixels high.
+
+.TP
+\fB-hoverlap=\fP\fIhoverlap\fP
+gives the horizontal overlap in pixels between output images.
+Each image in a row will overlap the previous one by \fIhoverlap\fP
+pixels.  By default, there is no overlap.
+.sp
+This option was new in Netpbm 10.23 (July 2004).
+
+.TP
+\fB-voverlap=\fP\fIvoverlap\fP
+gives the vertical overlap in pixels between output images.
+Each row of images will overlap the previous row by \fIvoverlap\fP
+pixels.  By default, there is no overlap.
+.sp
+This option was new in Netpbm 10.23 (July 2004).
+
+.TP
+\fB-verbose\fP
+Print information about the processing to Standard Error.
+
+
+
+.UN history
+.SH HISTORY
+.PP
+\fBpamdice\fP was new in Netpbm 9.25 (March 2002).
+.PP
+Before Netpbm 10.29 (August 2005), there was a limit of 100 slices
+in each direction.
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamundice" (1)\c
+\&,
+.BR "pamcut" (1)\c
+\&,
+.BR "pnmcat" (1)\c
+\&,
+.BR "pgmslice" (1)\c
+\&,
+.BR "ppmglobe" (1)\c
+\&
+.BR "pnm" (1)\c
+\&
+.BR "pam" (1)\c
+\&
+.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/pamdice.html
+.PP
\ No newline at end of file