--- ray/doc/man/man1/rcode_ident.1 2019/07/23 17:20:20 1.2 +++ ray/doc/man/man1/rcode_ident.1 2022/08/24 19:34:07 1.7 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rcode_ident.1,v 1.2 2019/07/23 17:20:20 greg Exp $" +.\" RCSid "$Id: rcode_ident.1,v 1.7 2022/08/24 19:34:07 greg Exp $" .TH RCODE_IDENT 1 7/19/2019 RADIANCE .SH NAME rcode_ident - store identifiers in an indexed map and retrieve from same @@ -34,13 +34,11 @@ input.txt ][ .B \-tS ] -[ input.idx [output.txt] -] .SH DESCRIPTION .I Rcode_ident -Takes a list of ASCII identifiers on the input and encodes them +takes a list of ASCII identifiers on the input and encodes them as a 16-bit index to a table appended to the output. This default index size can hold up to 65 thousand unique IDs, which is suitable for most applications. @@ -50,7 +48,7 @@ option may be used to specify an 8-bit index, which sa if 256 or fewer unique identifiers appear on the input. The .I \-24 -option creates a 24-bit index can record over 16 million +option creates a 24-bit index that can record over 16 million unique identifiers. .PP Identifiers are separated by newlines by default, but any single-character @@ -63,6 +61,9 @@ and the maximum ID length is 255 characters. .PP Input is taken from the first named file, or standard input if no files are given. +(Input file is required for +.I \-r +option.) Output is sent to the second named file, or standard output if none. .PP The @@ -84,6 +85,8 @@ The second form applies the .I \-r option to read an indexed id file and produce the original identifiers for each pixel position on the output. +With this option, the ID file must be given on the +command line and cannot be read from the standard input. The .I \-h and @@ -111,10 +114,6 @@ to produce an identifier for each integer input pair s the horizontal and vertical coordinates of a particular pixel, where x is measured from 0 on the left and y from 0 at the bottom in the standard orientation. -Note that -.I \-i -implies that an indexed ID file is explicitly given on the command -line, since the pixel coordinates are read from the standard input. If the .I \-u option is also given, output will be flushed after each identifier @@ -133,4 +132,5 @@ rcode_ident -r -h -H -i -l mods.idx < /dev/null .SH AUTHOR Greg Ward .SH "SEE ALSO" -rcalc(1), rcode_depth(1), rcode_norm(1), rlam(1), rsplit(1), rtpict(1) +rcalc(1), rcode_depth(1), rcode_norm(1), rcode2bmp(1), +rlam(1), rsplit(1), rtpict(1)