| 1 |
.\" RCSid "$Id: ra_xyze.1,v 1.4 2007/09/04 17:36:40 greg Exp $" |
| 2 |
.TH RA_XYZE 1 5/30/96 RADIANCE |
| 3 |
.SH NAME |
| 4 |
ra_xyze - convert between RADIANCE RGBE and XYZE formats |
| 5 |
.SH SYNOPSIS |
| 6 |
.B ra_xyze |
| 7 |
[ |
| 8 |
.B \-r |
| 9 |
][ |
| 10 |
.B "\-e exposure" |
| 11 |
][ |
| 12 |
.B \-o |
| 13 |
][ |
| 14 |
.B \-c |
| 15 |
| |
| 16 |
.B \-u |
| 17 |
][ |
| 18 |
.B "\-p xr yr xg yg xb yb xw yw" |
| 19 |
] |
| 20 |
[ |
| 21 |
.B input |
| 22 |
[ |
| 23 |
.B output |
| 24 |
] |
| 25 |
] |
| 26 |
.SH DESCRIPTION |
| 27 |
.I Ra_xyze |
| 28 |
converts between RADIANCE RGBE (red,green,blue,exponent) and XYZE |
| 29 |
(CIE X,Y,Z,exponent) formats. |
| 30 |
The |
| 31 |
.I \-e |
| 32 |
option specifies an exposure compensation, which may be given as |
| 33 |
a decimal multiplier or in f-stops (powers of two). |
| 34 |
The |
| 35 |
.I \-o |
| 36 |
option may be used to specify original units, to which the exposure |
| 37 |
compensation is applied. |
| 38 |
Otherwise, the multiplier is in addition to any previous exposure adjustment. |
| 39 |
By default, |
| 40 |
.I ra_xyze |
| 41 |
produces a flat XYZE RADIANCE picture file from any type of RADIANCE |
| 42 |
input picture. |
| 43 |
To override these defaults, the |
| 44 |
.I \-c |
| 45 |
option may be used to specify run-length encoded output, |
| 46 |
or the |
| 47 |
.I \-u |
| 48 |
option may be used to specify a flat output. |
| 49 |
.PP |
| 50 |
The |
| 51 |
.I \-r |
| 52 |
option causes |
| 53 |
.I ra_xyze |
| 54 |
to produce a run-length encoded RGBE file instead, unless |
| 55 |
.I \-u |
| 56 |
is given, also, when it will produce a flat RGBE file. |
| 57 |
The |
| 58 |
.I \-p |
| 59 |
option may be used to override the standard RADIANCE RGB primary |
| 60 |
colors to tailor the image for a particular output device or |
| 61 |
representation. |
| 62 |
The eight floating-point arguments to this option are the 1931 |
| 63 |
CIE (x,y) chromaticity coordinates of the three RGB primaries |
| 64 |
plus the white point, in that order. |
| 65 |
The new primaries will be recorded in the header of the output file, |
| 66 |
so that the original information may be fully recovered later. |
| 67 |
It is not necessary that the input file by in XYZE format. |
| 68 |
Th |
| 69 |
.I \-r |
| 70 |
option may therefore be used to convert from one RGB primary |
| 71 |
representation to another using the |
| 72 |
.I \-p |
| 73 |
option. |
| 74 |
.PP |
| 75 |
If the output file is missing, the standard output is used. |
| 76 |
If the input file is missing as well, the standard input is used. |
| 77 |
.SH NOTES |
| 78 |
The CIE standard used is the 1931 2-degree observer, and the |
| 79 |
correct output representation relies on the original RADIANCE |
| 80 |
input description being defined properly in terms of the standard |
| 81 |
RADIANCE RGB primaries, whose CIE (x,y) chromaticity values are |
| 82 |
defined in the header file in src/common/color.h. |
| 83 |
In this same file is a standard for the luminous efficacy of white |
| 84 |
light (WHTEFFICACY), which is used as a conversion between lumens |
| 85 |
and watts throughout RADIANCE. |
| 86 |
This same factor is applied by |
| 87 |
.I ra_xyze |
| 88 |
when converting between the radiometric units of the RGBE format |
| 89 |
and the photometric units of the XYZE format. |
| 90 |
The purpose of this factor is to ensure that the Y component of |
| 91 |
the CIE representation is luminance in units of candelas/meter^2. |
| 92 |
.PP |
| 93 |
Most of the RADIANCE picture filters should work uniformly on either |
| 94 |
RGBE or XYZE files, so it is not necessary to convert back to RGBE |
| 95 |
format except for conversion or display, in which case the correct |
| 96 |
primaries for the chosen output device should be specified with the |
| 97 |
.I \-p |
| 98 |
option if they are known. |
| 99 |
.SH EXAMPLES |
| 100 |
To convert RGBE output from |
| 101 |
.I rpict(1) |
| 102 |
into run-length encoded XYZE format: |
| 103 |
.IP "" .2i |
| 104 |
rpict [options] scene.oct | ra_xyze \-c > scene_xyz.hdr |
| 105 |
.PP |
| 106 |
To prepare a RADIANCE picture for display on a calibrated NTSC monitor: |
| 107 |
.IP "" .2i |
| 108 |
ra_xyze \-r \-p .670 .330 .210 .710 .140 .080 .333 .333 stand.hdr ntsc.hdr |
| 109 |
.SH AUTHOR |
| 110 |
Greg Ward |
| 111 |
.SH BUGS |
| 112 |
Any color correction applied to the original image is not removed |
| 113 |
or translated by |
| 114 |
.I ra_xyze, |
| 115 |
and it may result in color shifts in the output. |
| 116 |
If color preservation is important and the correction is unwanted, |
| 117 |
it is best to remove it with |
| 118 |
.I pfilt(1) |
| 119 |
using the |
| 120 |
.I \-er, |
| 121 |
.I \-eg |
| 122 |
and |
| 123 |
.I \-eb |
| 124 |
options first. |
| 125 |
(Simply look at the header and apply the reciprocal primaries of all |
| 126 |
COLORCORR= lines multiplied together.) |
| 127 |
Better still, get the picture before color correction is applied. |
| 128 |
.SH "SEE ALSO" |
| 129 |
pfilt(1), ra_rgbe(1), rpict(1) |
