--- ray/doc/man/man1/ra_xyze.1 2003/12/09 15:59:06 1.2 +++ ray/doc/man/man1/ra_xyze.1 2010/12/16 21:34:41 1.6 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: ra_xyze.1,v 1.2 2003/12/09 15:59:06 greg Exp $" +.\" RCSid "$Id: ra_xyze.1,v 1.6 2010/12/16 21:34:41 greg Exp $" .TH RA_XYZE 1 5/30/96 RADIANCE .SH NAME ra_xyze - convert between RADIANCE RGBE and XYZE formats @@ -9,6 +9,8 @@ ra_xyze - convert between RADIANCE RGBE and XYZE forma ][ .B "\-e exposure" ][ +.B \-o +][ .B \-c | .B \-u @@ -29,6 +31,11 @@ The .I \-e option specifies an exposure compensation, which may be given as a decimal multiplier or in f-stops (powers of two). +The +.I \-o +option may be used to specify original units, to which the exposure +compensation is applied. +Otherwise, the multiplier is in addition to any previous exposure adjustment. By default, .I ra_xyze produces a flat XYZE RADIANCE picture file from any type of RADIANCE @@ -44,7 +51,9 @@ The .I \-r option causes .I ra_xyze -to produce a run-length encoded RGBE file instead. +to produce a run-length encoded RGBE file instead, unless +.I \-u +is given, also, when it will produce a flat RGBE file. The .I \-p option may be used to override the standard RADIANCE RGB primary @@ -55,7 +64,7 @@ CIE (x,y) chromaticity coordinates of the three RGB pr plus the white point, in that order. The new primaries will be recorded in the header of the output file, so that the original information may be fully recovered later. -It is not necessary that the input file by in XYZE format. +It is not necessary that the input file be in XYZE format. Th .I \-r option may therefore be used to convert from one RGB primary @@ -92,11 +101,11 @@ To convert RGBE output from .I rpict(1) into run-length encoded XYZE format: .IP "" .2i -rpict [options] scene.oct | ra_xyze -c > scene_xyz.pic +rpict [options] scene.oct | ra_xyze \-c > scene_xyz.hdr .PP To prepare a RADIANCE picture for display on a calibrated NTSC monitor: .IP "" .2i -ra_xyze -r -p .670 .330 .210 .710 .140 .080 .333 .333 stand.pic ntsc.pic +ra_xyze \-r \-p .670 .330 .210 .710 .140 .080 .333 .333 stand.hdr ntsc.hdr .SH AUTHOR Greg Ward .SH BUGS @@ -117,4 +126,4 @@ options first. COLORCORR= lines multiplied together.) Better still, get the picture before color correction is applied. .SH "SEE ALSO" -pfilt(1), ra_rgbe(1), rpict(1) +pfilt(1), pvalue(1), ra_rgbe(1), rpict(1)