# HG changeset patch
# User Axel Jacobs <axel@jaloxa.eu>
# Date 1302442417 -3600
# Node ID 7e6b4b31a0b731c2fa5ae8b6ca6aec73704ef8f3
# Parent  c1cf31b48c1bfb4936a4da902a9b7e7d411f77e2
Added rlux man page

diff -r c1cf31b48c1b -r 7e6b4b31a0b7 man/man1/pdelta.1
--- a/man/man1/pdelta.1	Sat Apr 09 22:58:35 2011 +0100
+++ b/man/man1/pdelta.1	Sun Apr 10 14:33:37 2011 +0100
@@ -1,15 +1,15 @@
 .\" RCSid goes here.
-.TH "PDELTA" "1" "16/01/2011" "RADIANCE" ""
-.SH "NAME"
+.TH PDELTA 1 10/04/11 RADIANCE
+.SH NAME
 pdelta \- compute 1976 CIE Lab deltaE* between two Radiance pictures
-.SH "SYNOPSIS"
+.SH SYNOPSIS
 .B pdelta image1.hdr image2.hdr
-.SH "DESCRIPTION"
+.SH DESCRIPTION
 .I pdelta
 calculates the color difference deltaE* between two HDR images. The operation
 takes place in 1976 CIE Lab color space. The result is an HDR image which is 
 sent to STDOUT.
-.SH "EXAMPLES"
+.SH EXAMPLES
 To calculate the deltaE* Lab color difference between two HDR images
 and store the result in output.hdr
 .IP "" .2i
diff -r c1cf31b48c1b -r 7e6b4b31a0b7 man/man1/rlux.1
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/man/man1/rlux.1	Sun Apr 10 14:33:37 2011 +0100
@@ -0,0 +1,43 @@
+.\" RCSid goes here.
+.TH "RLUX" "1" "16/01/2011" "RADIANCE" ""
+.SH "NAME"
+rlux \- compute illuminance from ray origin and direction
+.SH "SYNOPSIS"
+.B rlux
+[
+.B rtrace args
+]
+.B octree
+.SH "DESCRIPTION"
+The
+.I ximage
+command can output certain information about the pixel under the cursor.
+This is configurable with the 
+.I \-o
+command line option. The default setting is \-ood, which outputs
+the ray origin and ray direction. This output can be directly passed to
+.I rtrace
+which, in combination, with the original octree that the image was rendered
+from, can compute the irradiance at this pixel for the red, green and blue channels.
+
+This is essentially what
+.I rlux
+does, but it additionally converts the RGB irradiance output from
+.I rtrace,
+which is in W/m2/sr, into the corresponding illuminance, given in lux.
+.SH "EXAMPLES"
+To calculate the RGB irradiance for a certain pixel in an HDR picture
+.IP "" .2i
+ximage nice.hdr | rtrace \-i+ \-dv \-h\- \-ab 3 scene.oct
+.PP 
+Now left\-click on a pixel and press the 't' key in ximage, or middle\-click.
+
+To do the same, but output the illuminance
+.IP "" .2i
+ximage nice.hdr | rtrace \-i+ \-dv \-h\- \-ab 3 scene.oct | rcalc \-e '$1=47.4*$1+120*$2+11.6*$3' \-u
+.PP 
+To let rlux do all the work. This is equivalent to the previous example.
+.IP "" .2i
+ximage nice.hdr | rlux \-ab 3 scene.oct
+.SH "SEE ALSO"
+ximage(1), rtrace(1), rcalc(1)