ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/Development/ray/doc/man/man1/rcode_ident.1
(Generate patch)

Comparing ray/doc/man/man1/rcode_ident.1 (file contents):
Revision 1.1 by greg, Sat Jul 20 02:07:23 2019 UTC vs.
Revision 1.7 by greg, Wed Aug 24 19:34:07 2022 UTC

# Line 28 | Line 28 | input.txt
28   ][
29   .B \-H
30   ][
31 + .B \-l
32 + ][
33 + .B \-n
34 + ][
35   .B \-tS
36   ]
33 – [
37   input.idx
38   [output.txt]
36 – ]
39   .SH DESCRIPTION
40   .I Rcode_ident
41 < Takes a list of ASCII identifiers on the input and encodes them
41 > takes a list of ASCII identifiers on the input and encodes them
42   as a 16-bit index to a table appended to the output.
43   This default index size can hold up to 65 thousand unique IDs,
44   which is suitable for most applications.
# Line 46 | Line 48 | option may be used to specify an 8-bit index, which sa
48   if 256 or fewer unique identifiers appear on the input.
49   The
50   .I \-24
51 < option creates a 24-bit index can record over 16 million
51 > option creates a 24-bit index that can record over 16 million
52   unique identifiers.
53   .PP
54   Identifiers are separated by newlines by default, but any single-character
# Line 59 | Line 61 | and the maximum ID length is 255 characters.
61   .PP
62   Input is taken from the first named file, or standard input if no
63   files are given.
64 + (Input file is required for
65 + .I \-r
66 + option.)
67   Output is sent to the second named file, or standard output if none.
68   .PP
69   The
# Line 80 | Line 85 | The second form applies the
85   .I \-r
86   option to read an indexed id file and produce the original
87   identifiers for each pixel position on the output.
88 + With this option, the ID file must be given on the
89 + command line and cannot be read from the standard input.
90   The
91   .I \-h
92   and
# Line 89 | Line 96 | string, respectively.
96   The
97   .I \-tS
98   option specifies an alternate ID separator instead of the default newline.
99 + The
100 + .I \-l
101 + option tells
102 + .I rcode_ident
103 + to list identifiers following the header information (if present).
104 + The
105 + .I \-n
106 + option prints identifier table indexes rather than the strings themselves.
107 + Indexing starts from 0 for the first table entry.
108   .PP
109   When decoding, the
110   .I \-i
# Line 98 | Line 114 | to produce an identifier for each integer input pair s
114   the horizontal and vertical coordinates of a particular pixel,
115   where x is measured from 0 on the left and y from 0 at the bottom
116   in the standard orientation.
101 – Note that
102 – .I \-i
103 – implies that an indexed ID file is explicitly given on the command
104 – line, since the pixel coordinates are read from the standard input.
117   If the
118   .I \-u
119   option is also given, output will be flushed after each identifier
# Line 113 | Line 125 | rtrace -ffa < rays.flt -x 512 -y 400 -om octree | rcod
125   To query specific modifiers using ximage with the 't' command:
126   .IP "" .2i
127   ximage -op render.hdr | rcode_ident -i -r mods.idx
128 + .PP
129 + To only print out the list of unique identifiers:
130 + .IP "" .2i
131 + rcode_ident -r -h -H -i -l mods.idx < /dev/null
132   .SH AUTHOR
133   Greg Ward
134   .SH "SEE ALSO"
135 < rcalc(1), rcode_depth(1), rcode_norm(1), rlam(1), rsplit(1), rtpict(1)
135 > rcalc(1), rcode_depth(1), rcode_norm(1), rcode2bmp(1),
136 > rlam(1), rsplit(1), rtpict(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines (old)
> Changed lines (new)