--- ray/doc/man/man1/rcomb.1 2023/12/18 23:04:05 1.2 +++ ray/doc/man/man1/rcomb.1 2024/02/10 19:32:32 1.6 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rcomb.1,v 1.2 2023/12/18 23:04:05 greg Exp $" +.\" RCSid "$Id: rcomb.1,v 1.6 2024/02/10 19:32:32 greg Exp $" .TH RCOMB 12/5/2023 RADIANCE .SH NAME rcomb - combine and convert matrices a row at a time @@ -94,7 +94,7 @@ will be undone, similar to the option. Radiance spectral pictures with more than 3 components are also supported. These are typically produced by -.I rtrace(1) +.I rtpict(1) or .I rfluxmtx(1). .PP @@ -144,6 +144,9 @@ option is given, the output will be written as a RGBE Note that conversion from a float or RGBE color space applies a conversion of 179 lumens/watt (for CIE or melanopic output) or 412 (for scotopic output), and the reverse happens for conversion from XYZE input to RGB or RGBE output. +Lower case versions of all these components are also supported, the only +difference is that the aforementioned efficacy factors +will be left out of the conversion. .PP If a matrix or picture file path is given to the .I \-c @@ -204,7 +207,7 @@ and the number of components is defined by the "ncomp" If given as "ci(i)", the function returns the current component being evaluated by .I rcomb. -A different component may be referenced using th second argument. +A different component may be referenced using the second argument. For example, "ci(1,2)" accesses the second component from the first input. If the input is a picture, the the constants "R", "G", and "B" @@ -219,7 +222,8 @@ For convenience and compatibility with the functions "ri(i)", "gi(i)", and "bi(i)" are predefined as "ci(i,R)", "ci(i,G)", and "ci(i,B)", respectively. Accordingly, the "ro", "go", and "bo" -variables may be used in place of "co(R)", "co(G)", and "co(B)". +variables may be used in place of "co(R)", "co(G)", and "co(B)", +but all three must be defined for this substitution to take place. Finally, the total number of input files is set in the constant "nfiles". .PP Results are sent to the standard output. @@ -327,6 +331,12 @@ is not supported in .I rcomb, and should instead be handled by .I pfilt(1). +.SH BUGS +The +.I rcomb +command currently ignores the "PRIMARIES" setting in input +headers, and does not produce any on output, even in +circumstances where it would make sense to. .SH AUTHOR Greg Ward .SH "SEE ALSO"