diff options
author | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2006-12-25 03:06:05 +0000 |
---|---|---|
committer | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2006-12-25 03:06:05 +0000 |
commit | 1017cbebe5d5edd859e0fddad0a8600f509f4821 (patch) | |
tree | 78bdf336648566f7a7d55f42837357dea3dd674c /pamsplit.html | |
parent | 16f2ac126651015a376eba864a3a35f738b0b25a (diff) | |
download | netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.gz netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.xz netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.zip |
Place user guide into Subversion repository
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@181 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'pamsplit.html')
-rw-r--r-- | pamsplit.html | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/pamsplit.html b/pamsplit.html new file mode 100644 index 00000000..ab5dff9b --- /dev/null +++ b/pamsplit.html @@ -0,0 +1,86 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML><HEAD><TITLE>Pamsplit User Manual</TITLE></HEAD> +<BODY> +<H1>pamsplit</H1> +Updated: 23 October 2005 +<BR> +<A HREF="#index">Table Of Contents</A> + +<H2>NAME</H2> + +pamsplit - split a multi-image PNM/PAM file into single-image files + +<H2 id="synopsis">SYNOPSIS</H2> + +<B>pamsplit</B> + +[<I>netpbmfile</I> + +[<I> output_file_pattern</I>]] + +[<b>-padname=</b><i>n</i>] + +<p>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. + + +<H2 id="description">DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>pamsplit</b> reads a PNM or PAM stream as input. It copies each image +in the input into a separate file, in the same format. + +<P><I>netpbmfile</I> is the file specification of the input file, or +<B>-</B> to indicate Standard Input. The default is Standard Input. + +<P><I>output_file_pattern</I> tells how to name the output files. It +is the file specification of the output file, except that the first +occurence of "%d" in it is replaced by the image sequence +number in unpadded ASCII decimal, with the sequence starting at 0. If +there is no "%d" in the pattern, <B>pamsplit</B> fails. + +<P>The default output file pattern is "image%d". + +<p>The <b>-padname</b> option specifies to how many characters you +want the image sequence number in the output file name padded with +zeroes. <b>pamsplit</b> adds leading zeroes to the image sequence +number to get up to at least that number of characters. This is just +the number of characters in the sequence number part of the name. For +example, <b>pamsplit - outputfile%d.ppm -padname=3</b> would yield +output filenames <b>outputfile000.ppm</b>, <b>outputfile001.ppm</b>, +etc. + +<p>The default is no padding (equivalent to <b>-padname=0</b>. +<P>The <b>-padname</b> option was new in Netpbm 10.23 (July 2004). +Before that, there was never any padding. + + +<P>Note that to do the reverse operation (combining multiple +single-image Netpbm files into a multi-image one), there is no special +Netpbm program. Just use <B>cat</B>. + +<p>If you just want to find out basic information about the images in a +stream, you can use <b>pamfile</b> on the stream. + +<p>To extract images from a stream and generate a single stream containing +them, use <b>pampick</b>. + +<H2 id="seealso">SEE ALSO</H2> + +<B><A HREF="pamfile.html">pamfile</A></B>, +<B><A HREF="pampick.html">pampick</A></B>, +<B><A HREF="pnm.html">pnm</A></B>, +<B><A HREF="pam.html">pam</A></B>, +<B>cat</b> man page + +<HR> +<H2 id="index">Table Of Contents</H2> +<UL> +<LI><A HREF="#synopsis">SYNOPSIS</A> +<LI><A HREF="#description">DESCRIPTION</A> +<LI><A HREF="#seealso">SEE ALSO</A> +</UL> +</BODY> +</HTML> |