diff options
author | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2018-04-05 01:39:27 +0000 |
---|---|---|
committer | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2018-04-05 01:39:27 +0000 |
commit | ed5262b357dc73a2539e940023b167a15619e48c (patch) | |
tree | b934ce863ad150ce3bd2247b7f64b486e31a5515 | |
parent | 08a792751573eb86bcf39c7a4ffed2f14972128c (diff) | |
download | netpbm-mirror-ed5262b357dc73a2539e940023b167a15619e48c.tar.gz netpbm-mirror-ed5262b357dc73a2539e940023b167a15619e48c.tar.xz netpbm-mirror-ed5262b357dc73a2539e940023b167a15619e48c.zip |
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@3193 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r-- | directory.html | 3 | ||||
-rw-r--r-- | pamcomp.html | 4 | ||||
-rw-r--r-- | pamlevels.html | 124 | ||||
-rw-r--r-- | pbmtext.html | 14 | ||||
-rw-r--r-- | pnmnorm.html | 3 |
5 files changed, 144 insertions, 4 deletions
diff --git a/directory.html b/directory.html index 6b2bf6e8..b201efee 100644 --- a/directory.html +++ b/directory.html @@ -780,6 +780,9 @@ a color map containing all possible colors of given maxval <DT><B><a href=pnmnorm.html>pnmnorm</a> </B> <DD>normalize contrast (adjust levels) +<DT><B><a href=pamlevels.html>pamlevels</a> </B> +<DD>adjust levels of color components + <DT><B><a href=pamrecolor.html>pamrecolor</a> </B> <DD>alter colors without affecting luminance diff --git a/pamcomp.html b/pamcomp.html index 913eb5d9..be950f4d 100644 --- a/pamcomp.html +++ b/pamcomp.html @@ -258,8 +258,8 @@ underlying image. <dt><b>-linear</b> -<dd>This option indicates that the inputs are not true Netpbm images -but rather a non-gamma-adjusted variation. This is relevant only when +<dd>This option indicates that the inputs are not true Netpbm images but +rather a light-intesity-proportional variation. This is relevant only when you mix pixels, using the <b>-opacity</b> option or a transparency mask (the <b>-alpha</b> option). diff --git a/pamlevels.html b/pamlevels.html new file mode 100644 index 00000000..8d6f0a6e --- /dev/null +++ b/pamlevels.html @@ -0,0 +1,124 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML><HEAD><TITLE>Pamlevels User Manual</TITLE> +</HEAD><BODY> +<H1>pamlevels</H1> +Updated: 31 March 2018 +<BR> +<A HREF="#index">Table Of Contents</A> + +<H2>NAME</H2> + +pamlevels - effect a "levels" transformation + +<H2 id="synopsis">SYNOPSIS</H2> + +<B>pamlevels</B> +[<b>-direct</b>] +<b>-from1</b> <I>from1</I> +<b>-to1</b> <I>to1</I> +<b>-from2</b> <I>from2</I> +<b>-to2</b> <I>to2</I> +[<b>-from3</b> <I>from3</I> +<b>-to3</b> <I>to3</I>] +[<b>-linear</b>] +[<I>pamfile</I>] + +<H2 id="description">DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>pamlevels</b> reads a Netpbm image from <i>pamfile</i> or standard +input, applies a "levels" transformation, and sends the result to +standard output. It finds a unique transformation that maps color +<i>from1</i> to <i>to1</i>, color <i>from2</i> to <i>to2</i>, +and—if <b>-from3</b> and <b>-to3</b> are supplied—color +<i>from3</i> to <i>to3</i>. Transformations based on two mappings are linear +in light intensity and those based on three mappings quadratic. The +color-mapping options may be shortened to <b>-f1</b>...<b>-f3</b> and +<b>-t1</b>...<b>-t3</b>. + +<p>Color values have the following format: +<i>color</i>[:<i>scale</i>], where <i>color</i> is +a <a href="libppm.html#colorname"> Netpbm color specification</a> +and <i>scale</i> an optional coefficient that is applied to each component +of <i>color</i>. + +<p>The transformation preserves +<A HREF="http://www.c-f-systems.com/ColorIntegrity.html">color integrity</A>. + +<p>When the transformation is linear (i.e. uses two mappings) and preseves zero +(i.e. maps black to black), it corresponds to multiplication of light +intensity by a constant. + +<H2 id="examples">EXAMPLES</H2> +In the examples below, <code>\</code> denotes a line continuation: + +<p>To brighten an image by setting a darker white point— +<pre>pamlevels -f1 black -t1 black \ +-f2 white:0.9 -t2 white in.ppm > out.ppm</pre> + +<p>To adjust the white point— +<pre> +pamlevels -f1 black -t1 black\ +-f2 rgbi:0.9/0.83/0.80 -t2 white in.ppm > out.ppm</pre> + +<p>To set a lighter black point— +<pre>pamlevels -f1 white:0.06 -t1 black +-f2 white -t2 white in.ppm > out.ppm</pre> + +<p>To increase brightness by compression— +<pre>pamlevels \ +-f1 black -t1 black -f2 white -t2 white \ +-f3 white:0.5 -t3 white:0.6 in.ppm > out.ppm</pre> +The latter tranformation similar to gamma-correction. + +<h2 id="options">OPTIONS</h2> + +<dl> +<dt><b>-from1</b> +<dt><b>-to1</b> +<dt><b>-from2</b> +<dt><b>-to2</b> +<dt><b>-from3</b> +<dt><b>-to3</b> +<dd> +These options define the mappings of input colors to output colors that anchor +the transformation function. See <a href="#description">DESCRIPTION</a>. + +<dt><b>-linear</b> +<dd>This option tells <b>pamlevels</b> to work with the intensity-linear +variation on PPM where the samples are proportional to light intensity, rather +than brightness (gamma-adjusted) as in true PPM. The input must be of this +form and the <b>pamlevels</b> makes the output of this form. + +</dl> + +<H2 id="seealso">SEE ALSO</H2> + +<B><A HREF="pnmnorm.html">pnmnorm</A></B>, +<B><A HREF="pamrecolor.html">pamrecolor</A></B>, +<B><A HREF="pnmgamma.html">pnmgamma</A></B>, +<B><A HREF="pam.html">pnm</A></B> + +<H2 id="author">AUTHOR</H2> + +<p>This program was first submitted by Anton Shepelev +(<A HREF="mailto:anton.txt@gmail.com">anton.txt@gmail.com</A>). + +<H2 id="history">HISTORY</H2> + +<p><b>pamlevels</b> was new in Netpbm 10.83 (June 2018). + +<HR> +<H2 id="index">Table Of Contents</H2> +<UL> +<LI><A HREF="#synopsis">SYNOPSIS</A> +<LI><A HREF="#description">DESCRIPTION</A> +<LI><A HREF="#examples">EXAMPLES</A> +<LI><A HREF="#options">OPTIONS</A> +<LI><A HREF="#seealso">SEE ALSO</A> +<LI><A HREF="#author">AUTHOR</A> +<LI><A HREF="#history">HISTORY</A> +</UL> +</BODY> +</HTML> diff --git a/pbmtext.html b/pbmtext.html index 57c1dfb7..6242239c 100644 --- a/pbmtext.html +++ b/pbmtext.html @@ -2,7 +2,7 @@ <HTML><HEAD><TITLE>Pbmtext User Manual</TITLE></HEAD> <BODY> <H1>pbmtext</H1> -Updated: 25 March 2018 +Updated: 04 April 2018 <BR> <A HREF="#index">Table Of Contents</A> @@ -330,6 +330,17 @@ the user to supply a BDF file covering the necessary glyphs with the <p><b>pbmtext</b> does not inspect the encoding of the font file. +<h2 id="limitations">LIMITATIONS</h2> + +<P>If the text is from Standard Input, no line may be longer than 4999 +characters. If one is, the program aborts with an appropriate error message. + +<P>If the text is from Standard Input and contains a null character, the +results are abnormal. Lines may be truncated, and a single line may be +considered multiple lines. Normal text does not contain null characters, so +this isn't a big problem. + + <h2 id="tips">TIPS</h2> <p>If you get garbled output, check the input text encoding and font file @@ -424,6 +435,7 @@ Copyright (C) 1993 by Jef Poskanzer and George Phillips <LI><A HREF="#usage">USAGE</A> <LI><A HREF="#fonts">FONTS</A> <LI><A HREF="#multibyte">MULTI-BYTE INPUT</A> +<LI><A HREF="#limitations">LIMITATIONS</A> <LI><A HREF="#tips">TIPS</A> <LI><A HREF="#seealso">SEE ALSO</A> <LI><A HREF="#author">AUTHOR</A> diff --git a/pnmnorm.html b/pnmnorm.html index b01b3f17..e929bbdb 100644 --- a/pnmnorm.html +++ b/pnmnorm.html @@ -286,11 +286,12 @@ intense RGB component (all intensities gamma-adjusted). <H2 id="seealso">SEE ALSO</H2> <B><A HREF="pnmhisteq.html">pnmhisteq</A></B>, +<B><A HREF="pamlevele.html">pamlevels</A></B>, <B><A HREF="ppmhist.html">ppmhist</A></B>, <B><A HREF="pgmhist.html">pgmhist</A></B>, -<B><A HREF="pnmgamma.html">pnmgamma</A></B>, <B><A HREF="ppmbrighten.html">ppmbrighten</A></B>, <B><A HREF="ppmdim.html">ppmdim</A></B>, +<B><A HREF="pnmgamma.html">pnmgamma</A></B>, <B><A HREF="pnm.html">pnm</A></B> <HR> |