pfsgamma(1)

pfsgamma1

Apply gamma correction to color or gray-scale images

Usage

pfsgamma [{--gamma <gamma> | --inverse-gamma <inv-gamma>}] [--mul <multiplier>]

Overview

Use this command to gamma correct a stream of pfs images. Gamma correction is equivalent to raising value of R, G and B (or Y for gray-scale images) channels to 1/gamma power. More information on gamma correction can be found at:

http://www.poynton.com/notes/colour_and_gamma/GammaFAQ.html

This command can work on color images, in which case XYZ channels are transformed to RGB space, then they are gamma corrected before they are converted back to XYZ. For gray-scale images (only Y channel and XZ missing) gamma correction is applied only to Y channel.

Data can be multiplied by an optional multiplier before gamma correction.

Note: gamma correction will set the 'LUMINANCE' tag to 'DISPLAY' thus cancelling any sRGB correction when saving to LDR files (like PPM, TIFF). This will also cause a warning message when saving to HDR files, because the intensities after gamma correction are not linearly related to luminance any more.

Options

--gamma <gamma>, -g <gamma>

Perform gamma correction (input^(1/gamma)). This can be used to convert images from relative luminance or radiance to pixel values. Default value: 1.0

--inverse-gamma <inv-gamma>, -i <inv-gamma>

Perform inverse gamma correction (input^(gamma)). This can be used to convert images from pixel values to relative radiance or luminance.

--mul <mul>, -m <mul>

Multiply data by this value before gamma correction. Default value: 1

Examples

pfsin memorial.hdr | pfsgamma -g 1.8 -m 10 | pfsout memorial_gc.ppm

Multiply memorial image by 10, gamma correct it and save to memorial_gc.ppm.

Releases

8 releases since Debian 5.0 (Lenny); the text changed 1 time.

  1. 5.0
  2. 6.0–13

--inverse-gamma since Debian 6.0 (Squeeze); -i since Debian 6.0 (Squeeze).

Bugs

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

From pfstools 2.2.0-9 in Debian 13 (Trixie). Parsed by carta from the page's man source.