From 9fccd695bcbe5410e5ce0f25394818470a74d709 Mon Sep 17 00:00:00 2001 From: giraffedata Date: Sun, 9 Aug 2020 00:53:01 +0000 Subject: miscellaneous update git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@3912 9d0c8265-081b-0410-96cb-a4ca84ce46f8 --- directory.html | 3 + index.html | 7 +-- pambrighten.html | 3 +- ppmbrighten.html | 172 +++++++------------------------------------------------ 4 files changed, 27 insertions(+), 158 deletions(-) diff --git a/directory.html b/directory.html index c7b5221c..8d924710 100644 --- a/directory.html +++ b/directory.html @@ -1134,6 +1134,9 @@ programs:

pgmslice

pnmenlarge

ppmtomap +

pcdindex +

ppmbrighten +

ppmcolors diff --git a/index.html b/index.html index d16070aa..b7591efe 100644 --- a/index.html +++ b/index.html @@ -3,7 +3,7 @@ User manual for Netpbm

Netpbm

-Updated: 31 January 2014 +Updated: 08 August 2020
@@ -12,9 +12,8 @@ Updated: 31 January 2014

Netpbm is a package of graphics programs and a programming -library.

There are over 220 separate programs in the package, -most of which have "pbm", "pgm", "ppm", -"pam", or "pnm" in their names. For example, +library.

There are over 330 separate programs in the package, most of +which have "pbm", "pgm", "ppm", "pam", or "pnm" in their names. For example, pamscale and giftopnm. diff --git a/pambrighten.html b/pambrighten.html index ed082a37..1891f19b 100644 --- a/pambrighten.html +++ b/pambrighten.html @@ -83,7 +83,7 @@ recognizes the various Netpbm image formats rather than treating them all as PPM. The output format is the same as the input format and extra channels in a PAM image (such as a transparency channel) get passed through. -

If you want to modify the Hues in the image, use pamhue. +

If you want to modify the hues in the image, use pamhue.

EXAMPLES

@@ -124,7 +124,6 @@ change the Saturation of each pixel. It may be negative. pamfunc, ppmflash, pamaltsat, -ppmbrighten, pamdepth, pnmgamma, pamhue, diff --git a/ppmbrighten.html b/ppmbrighten.html index d0ad0797..20d863d5 100644 --- a/ppmbrighten.html +++ b/ppmbrighten.html @@ -2,170 +2,38 @@ Ppmbrighten User Manual

ppmbrighten

-Updated: 12 January 2019 -
-Table Of Contents +Updated: 09 August 2020

NAME

-ppmbrighten - change a PPM image's Saturation and Value -

SYNOPSIS

+ppmbrighten - replaced by pambrighten -ppmbrighten -[-normalize] -[-saturation=[+|-saturation_percent]] -[-value=[+|-value_percent]] -ppmfile - -

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. - -

DESCRIPTION

This program is part of Netpbm. -

ppmbrighten increases or decreases the Saturation and Value -(from the HSV color space) of each pixel of a PPM image. You specify -the per centage change for each of those parameters. - -

You can also remap the colors of the pixels so their Values cover -the full range of possible Values. - -

Hue-Saturation-Value, or HSV, is one way to represent a color, like -the more well-known RGB. Hue, Saturation, and Value are numbers in -the range from 0 to 1. We always capitalize them in this document -when we mean the number from the HSV color space, especially since -"value" as a conventional English word has a much more abstract -meaning. - -

Value is a measure of how bright the color is, relative to some specified -maximum (the PPM format is also defined in terms of a specified maximum -brightness -- For the purposes of this program, they are the same). In -particular, it is the brightness of the brightest primary color component of -the color divided by the maximum brightness possible for a component. Zero -Value means black. White has full Value. - -

Hue is an indication of the secondary color with the same brightness -that most closely approximates the color. A secondary color is made -of a combination of at most two of the primary colors. - -

Saturation is a measure of how close the color is to the color -indicated by the Hue and Value. A lower number means more light of -the third primary color must be added to get the exact color. Full -Saturation means the color is a secondary color. Zero Saturation -means the color is gray (or black or white). Decreasing the -saturation of a color tends to make it washed out. - -

If it is impossible to increase the Value of a pixel by the amount you -specify (e.g. the Value is .5 and you specify +200%), ppmbrighten -increases it to full Value instead. +

Starting with Netpbm 10.86 (March 2019), ppmbrighten is +obsolete. Use pambrighten instead. -

If it is impossible to increase the Saturation of a pixel by the amount -you specify (e.g. it is already half saturated and you specify +200%), -ppmbrighten increases it to full Saturation instead. +pambrighten is mostly backward compatible with ppmbrighten. You +can use the pambrighten manual for ppmbrighten as long as you +ignore features that were added after Netpbm 10.86. -

For a simpler kind of brightening, you can use pamfunc -multiplier -simply to increase the brightness of each pixel by a specified per centage, -clipping each RGB component where the calculated brightness would exceed full -brightness. Thus, the brightest colors in the image would change chromaticity -in addition to not getting the specified brightness boost. -For decreasing brightness, pamfunc should do the same thing as -ppmbrighten. +

One way in which pambrighten is not backward compatible is that + pambrighten does not have a -normalize option. If you want + that function, use pnmnorm on the image before passing it to + pambrighten. -

ppmflash does another kind of brightening. It changes the -color of each pixel to bring it a specified per centage closer to white. -This increases the value and saturation. - -

pambrighten is the same as ppmbrighten, except that it -recognizes the various Netpbm image formats rather than treating them all as -PPM. The output format is the same as the input format and extra channels in -a PAM image (such as a transparency channel) get passed through. - -

If you want to modify the Hues in the image, use pamhue. +

Another backward incompatibility is that pambrighten produces the + same kind of output as the input, whereas ppmbrighten always + produces PPM. If you need PPM output, pass the results through + ppmtoppm. +

ppmbrighten is currently implemented as a triviel program that + invokes pambrighten, pnmnorm, and ppmtoppm. -

EXAMPLES

To double the Value of each pixel: -

-ppmbrighten -value=100
-

- -

To double the Saturation and halve the Value of each pixel: -

-ppmbrighten -saturation=+100 -value=-50
-

- -

OPTIONS

- -

In addition to the options common to all programs based on libnetpbm -(most notably -quiet, see -Common Options), ppmbrighten recognizes the following -command line options: - -

-value=value_percent - -

This option specifies the amount, as a per centage, by which you want -to change the Value of each pixel. It may be negative. - -

-saturation=value_percent - -

This option specifies the amount, as a per centage, by which you want -to change the Saturation of each pixel. It may be negative. - - -

-normalize - -

This option causes ppmbrighten to normalize contrast by linearly -remapping the Values of the pixels to cover the range 0 to 1. - -

ppmbrighten applies the brightening that you specify with -the -value option after the remapping. - -

Before Netpbm 10.14 (March 2003), your input must be from a seekable -file (not a pipe) to use -normalize. If it isn't, the program fails -with a bogus error message. - -

- -

AUTHOR

+ + -

-Permission to use, copy, modify, and distribute this software and its -documentation for any purpose and without fee is hereby granted, provided -that the above copyright notice appear in all copies and that both that -copyright notice and this permission notice appear in supporting -documentation. This software is provided "as is" without express or -implied warranty. -

SYNOPSIS -
DESCRIPTION -
EXAMPLES -
OPTIONS -
SEE ALSO -
AUTHOR -

- - -- cgit 1.4.1

Netpbm

EXAMPLES

ppmbrighten

NAME

SYNOPSIS

DESCRIPTION

DESCRIPTION

EXAMPLES

OPTIONS

SEE ALSO

AUTHOR

Table Of Contents