--- ray/doc/man/man1/rxfluxmtx.1 2025/10/23 23:34:59 1.1 +++ ray/doc/man/man1/rxfluxmtx.1 2025/10/24 16:52:14 1.2 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rxfluxmtx.1,v 1.1 2025/10/23 23:34:59 greg Exp $" +.\" RCSid "$Id: rxfluxmtx.1,v 1.2 2025/10/24 16:52:14 greg Exp $" .TH RXFLUXMTX 1 10/23/2025 RADIANCE .SH NAME rxfluxmtx - compute flux transfer matrix(es) for RADIANCE scene @@ -140,18 +140,27 @@ Orient the "up" direction for the hemisphere using the vector. .TP .BI o =output_spec -Send the matrix data for this receiver to the indicated file or command. -Single or double quotes may be used to contain strings with spaces. +Send the matrix data for this receiver to the indicated file specification. +Single or double quotes may be used to contain strings with spaces, and +the usual "%s" and "%d" formats incorporate the modifier name and/or +bin number, as with +.I rcontrib. Command (piped) output is not supported. -The file format will be determined by the command-line +.PP +If no output_spec directive is given, it must be specified by a +.I \-o +setting on the command-line, since output to stdout is not supported. +The input and output file formats are controlled by the .I \-fio -option, which may use a single letter for identical input and output formats. -The input file specification matters only in pass-through mode, for which +option, which may use a single letter for identical i/o formats. +The input format matters only in pass-through mode, for which ASCII input is supported. ASCII output is unsupported, since it interferes with efficient recovery in the .I \-r mode. +The default setting is +.I \-faf. .PP In normal execution, only a single sender surface is sampled, but it may be comprised of any number of subsurfaces, as in a triangle mesh or similar. @@ -190,9 +199,9 @@ on a light pipe: .IP "" .2i rxfluxmtx int_aperture.rad ext_aperture.rad lpipe.rad > lpipe.mtx .PP -To generate a set of DC view component pictures with 9 samples/pixel: +To generate a set of DC view component pictures with 9 jittered samples/pixel: .IP "" .2i -rxfluxmtx -vf v1.vf -x 512 -y 512 -c 9 -fc reinhart_M4.rad -i scene1.oct +rxfluxmtx -vf v1.vf -x 512 -y 512 -c 9 -pj .8 -fc reinhart_M4.rad -i scene1.oct .PP To compute a workplane irradiance matrix for each window in a space: .IP "" .2i