pfstmo_fattal02(1) [debian man page]

pfstmo_fattal02(1)					      General Commands Manual						pfstmo_fattal02(1)

NAME

       pfstmo_fattal02 - Gradient domain high dynamic range compression

SYNOPSIS

       pfstmo_fattal02 [--alpha <val>] [--beta <val>] [--saturation <val>] [--noise <val>] [--verbose] [--help]

DESCRIPTION

       This command implements a tone mapping operator as described in:

       Gradient Domain High Dynamic Range Compression R. Fattal, D. Lischinski, and M. Werman In ACM Transactions on Graphics, 2002.

       With  respect to the original paper, this program provides additional parameter which limits the amplification of noise. The noise is often
       starkly amplified because of division by zero in one of the equations in the paper. Extension contributed by Przemyslaw Bazarnik.

       Results of this TMO can be improved by using a gamma correction.

OPTIONS

       --alpha <val>, -a <val>

	      Set alpha parameter. <val> defines the threshold gradient value (luminance differents of adjacent pixels) below which the  gradients
	      are amplified (detail enhancement) and above which the gradients are attenuated (global contrast reduction).
	       Suggested  range  is  1	to 0.0001. It is reasonable to change parameters by orders of magnitude, so for instance trying 0.1, 0.01,
	      0.001 etc.  (see paper for details).

       --beta <val>, -b <val>

	      Set beta parameter. <val> sets the strength of gradient (local contrast) modification.  Suggested range is 0.8 to  0.96  (see  paper
	      for details).  Value of 1 does not change contrasts, values above 1 reverse the effect: global contrast is stretched and details are
	      attenuated.  Values below 0.5 lead to very strong amplification of small contrast, so consider  using  --noise  parameter  close	to
	      'alpha' value to prevent noise.

       --saturation <val>, -s <val>

	      Amount of color saturation. Suggested range is 0.4 to 0.8. Default value: 0.6.

       --noise <val>, -n <val>

	      Reduces  gradient  amplification value for gradients close to 0 and reduces noise in the result. <val> defines gradient value (lumi-
	      nance differents of adjacent pixels) which is treated as noise. Suggested range is 0.0 to the value of alpha. Default  value  calcu-
	      lated based on alpha: 0.001*alpha.

       --verbose

	      Print additional information during program execution.

       --help

	      Print list of command line options.

EXAMPLES

       pfsin memorial.hdr | pfstmo_fattal02 -v | pfsgamma -g 2.2 | pfsout memorial.png

	      Tone map image and save it in png format.

SEE ALSO

       pfsin(1) pfsout(1) pfsview(1)

BUGS

       Please report bugs and comments on implementation to Grzegorz Krawczyk <krawczyk@mpi-sb.mpg.de>.

																pfstmo_fattal02(1)

pfstmo_mantiuk06(1)					      General Commands Manual					       pfstmo_mantiuk06(1)

NAME

       pfstmo_mantiuk06 - Tone mapping in the contrast domain

SYNOPSIS

       pfstmo_mantiuk06 [--factor <val>] [--equalize-contrast <val>] [--saturation <val>] [--verbose] [--quiet] [--help]

DESCRIPTION

       This  command  implements  two  tone  mapping  operators: contrast mapping and contrast equalization. Both operators can produce very sharp
       images (sometimes non-photorealistic) while minimizing contrast reversal (halo artifacts). More information on these operators can be found
       in:

	      Rafal Mantiuk, Karol Myszkowski, Hans-Peter Seidel.
	      A Perceptual Framework for Contrast Processing of High Dynamic Range Images
	      In: ACM Transactions on Applied Perception 3 (3), pp. 286-308, 2006.
	      http://www.mpi-inf.mpg.de/~mantiuk/contrast_domain/

       This version contains several performance improvements made by Ed Brambley.

       If you find this TMO useful in your research project, please cite the paper above.

       The result of this TMO requires gamma correction.

OPTIONS

       --equalize-contrast <val>, -e <val>
	      Use  the contrast equalization algorithm. If this option is not specified, the contrast mapping algorithm will be used. The contrast
	      equalization algorithm requires scaling parameter that controls the amount sharpenning, which can range from 0.1 (very sharp)  to  1
	      (less sharp).

	      contrast equalization results in very sharp, but also less natural images. contrast equalization may also enhance noise in low-qual-
	      ity images.

       --factor <val>, -f <val>
	      Contrast scaling factor (values 0-1) determines how much contrast magnitudes should be reduced. This  option  cannot  be	used  with
	      equalize-contrast. The lower value results in a sharper image. Default value: 0.3

       --saturation <val>, -s <val>
	      Saturation correction (values 0-1). The lower value results in stronger desaturation. Default value: 0.8

       --verbose, -v
	      Print additional information during program execution.

       --quiet, -q
	      Do not display progress report.

       --help, -h
	      Print list of commandline options.

EXAMPLES

       pfsin memorial.hdr | pfstmo_mantiuk06 -f 0.5 | pfsgamma -g 2.2  | pfsout memorial.png

	      Tone map an image using contrast mapping and save it in the PNG format.

       pfsin memorial.hdr | pfstmo_mantiuk06 -e 0.5 | pfsgamma -g 2.2  | pfsout memorial.png

	      The same as above, but use the contrast equalization algorithm.

       pfsin memorial.hdr | pfstmo_mantiuk06 -f 0.5 -s 1 | pfsview

	      For  optimal  results  you  can  output  the  result to pfsview and manually adjust the dynamic range window. Then save the image in
	      pfsview by selecting 'Save image...' from the 'Frame' menu or pressing 's'.

       pfsin bridge.jpg --linear |  pfsclamp --min 0.007 | pfstmo_mantiuk06 | pfsview

	      Enhance the low-dynamic range image 'bridge' and view the result. pfsclamp command reduces noise for low code values.

SEE ALSO

       pfsgamma(1) pfsclamp(1) pfsin(1) pfsout(1) pfsview(1)

BUGS

       Please report bugs and comments to the pfstools discussion group (http://groups.google.com/group/pfstools).

															       pfstmo_mantiuk06(1)