## SYNOPSIS

**pfscolortransform**(--

**xyzrgb**matrix-file | --

**rgbxyz**matrix-file) [--

**transpose]**

## DESCRIPTION

Use this command to calibrate colours using a calibration matrix supplied in a text file. The command is intended for linearized (not gamma corrected) color spaces. The matrix should be 3x3 and it should transform from CIE XYZ to ITU rec. 709 RGB (sRGB primaries but linear, no gamma) or from the same RGB to CIE XYZ (see options below). The text file should contain three rows with numbers separated by a comma, for example:

- 0.0292,0.0126,0.0009
- 0.0052,0.0340,-0.0049
- 0.0055,-0.0059,0.0409

If the --**xyzrgb** is supplied, the pixel values are color-transformed as follows:

- [RGB]' = M * [XYZ]

where ' is matrix transposition, * is matrix multiplication, RGB is a vector of RGB values
and XYZ is the vector of CIE XYZ trichromatic values. If the --**rgbxyz** is supplied,
the pixel values are color-transformed as follows:

- [XYZ]' = M * [RGB]

## OPTIONS

- --
**xyzrgb**matrix-file, -**x**matrix-file - User provided matrix is a conversion matrix to convert from XYZ to RGB color space.
- --
**rgbxyz**matrix-file, -**r**matrix-file - User provided matrix is a conversion matrix to convert from RGB to XYZ color space.
- --
**transpose, -t** **Take transpose of provided matrix file.**

## EXAMPLES

- pfsin memorial.hdr | pfscolortransform -x matrix.txt | pfsout memorial_gc.ppm
- Color calibrate memorial image with matrix in matrix.txt file and save to memorial_gc.ppm.

## BUGS

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