--- ray/doc/man/man1/rcode_ident.1 2019/07/20 02:07:23 1.1 +++ ray/doc/man/man1/rcode_ident.1 2021/04/28 19:15:09 1.5 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rcode_ident.1,v 1.1 2019/07/20 02:07:23 greg Exp $" +.\" RCSid "$Id: rcode_ident.1,v 1.5 2021/04/28 19:15:09 greg Exp $" .TH RCODE_IDENT 1 7/19/2019 RADIANCE .SH NAME rcode_ident - store identifiers in an indexed map and retrieve from same @@ -28,6 +28,10 @@ input.txt ][ .B \-H ][ +.B \-l +][ +.B \-n +][ .B \-tS ] [ @@ -36,7 +40,7 @@ input.idx ] .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. @@ -46,7 +50,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 @@ -89,6 +93,15 @@ string, respectively. The .I \-tS option specifies an alternate ID separator instead of the default newline. +The +.I \-l +option tells +.I rcode_ident +to list identifiers following the header information (if present). +The +.I \-n +option prints identifier table indexes rather than the strings themselves. +Indexing starts from 0 for the first table entry. .PP When decoding, the .I \-i @@ -113,7 +126,12 @@ rtrace -ffa < rays.flt -x 512 -y 400 -om octree | rcod To query specific modifiers using ximage with the 't' command: .IP "" .2i ximage -op render.hdr | rcode_ident -i -r mods.idx +.PP +To only print out the list of unique identifiers: +.IP "" .2i +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)