diff options
Diffstat (limited to 'pamsplit.html')
-rw-r--r-- | pamsplit.html | 103 |
1 files changed, 61 insertions, 42 deletions
diff --git a/pamsplit.html b/pamsplit.html index 15972eb9..489f8f4e 100644 --- a/pamsplit.html +++ b/pamsplit.html @@ -1,22 +1,22 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> -<HTML><HEAD><TITLE>Pamsplit User Manual</TITLE></HEAD> -<BODY> -<H1>pamsplit</H1> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN"> +<html><head><title>Pamsplit User Manual</title></head> +<body> +<h1>pamsplit</h1> Updated: 11 August 2011 -<BR> -<A HREF="#index">Table Of Contents</A> +<br> +<a href="#index">Table Of Contents</a> -<H2>NAME</H2> +<h2>NAME</h2> pamsplit - split a multi-image Netpbm file into single-image files -<H2 id="synopsis">SYNOPSIS</H2> +<h2 id="synopsis">SYNOPSIS</h2> -<B>pamsplit</B> +<b>pamsplit</b> -[<I>netpbmfile</I> +[<i>netpbmfile</i> -[<I> output_file_pattern</I>]] +[<i> output_file_pattern</i>]] [<b>-padname=</b><i>n</i>] @@ -25,25 +25,25 @@ 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> +<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 name of the input file, or -<B>-</B> to indicate Standard Input. The default is Standard Input. +<p><i>netpbmfile</i> is the file name 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 +<p><i>output_file_pattern</i> tells how to name the output files. It is the file name of the output file, except that the first occurrence 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. +there is no "%d" in the pattern, <b>pamsplit</b> fails. -<P>The default output file pattern is "image%d". +<p>The default output file pattern is "image%d". -<p>The <b>-padname</b> option specifies to how many characters you +<p>The <b>-padname</b> option specifies 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 @@ -52,14 +52,10 @@ example, <kbd>pamsplit - outputfile%d.ppm -padname=3</kbd> 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 +<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>. +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. @@ -71,21 +67,44 @@ them, use <b>pampick</b>. files, use <b>pamexec</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="pamexec.html">pamexec</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> +<h2 id="options">OPTIONS</h2> + +<p>In addition to the options common to all programs based on libnetpbm +(most notably <b>-quiet</b>, see <a href="index.html#commonoptions"> +Common Options</a>), <b>pamsplit</b> recognizes the following +command line option: + +<dl compact> +<dt><b>-padname=</b><i>n</i> + +<dd>Specify the width (i.e. number of digits) of the image sequence +number field in the filenames of the output files. The image +sequence will be padded with leading zeroes to achieve the stated +width. + +<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. + +</dl> + +<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="pamexec.html">pamexec</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="#options">OPTIONS</a> +<li><a href="#seealso">SEE ALSO</a> +</ul> +</body> +</html> |