--- ray/doc/man/man1/getinfo.1 2003/03/11 19:20:21 1.1 +++ ray/doc/man/man1/getinfo.1 2014/07/28 17:25:03 1.6 @@ -1,4 +1,4 @@ -.\" RCSid "$Id" +.\" RCSid "$Id: getinfo.1,v 1.6 2014/07/28 17:25:03 greg Exp $" .TH GETINFO 1 1/15/99 RADIANCE .SH NAME getinfo - get header information from a RADIANCE file @@ -12,6 +12,10 @@ getinfo - get header information from a RADIANCE file .br .B getinfo - +.br +.B getinfo +.B -c +.B "command .." .SH DESCRIPTION .I Getinfo reads the header of each RADIANCE @@ -32,19 +36,32 @@ For an octree, prints the bounding cube (xmin ymin zmin size). For a picture, .I "getinfo \-d" -prints the y and x resolution (-Y yres +X xres). +prints the y and x resolution (\-Y yres +X xres). If no .I file is given, the standard input is read. .PP -The second form of getinfo with a hyphen simply removes the header +The second form of +.I getinfo +with a hyphen simply removes the header and copies the body of the file from the standard input to the standard output. +.PP +The third form of +.I "getinfo \-c" +is followed by a command and its arguments, which is executed +on the data segment of the standard input. +The header is passed along, with the addition of the command +at the end. +This is roughly equivalent to the following sequence, but does not +require the input to be in a file: +.IP "" .2i +( getinfo < input ; getinfo - < input | command .. ) .SH EXAMPLE -To print the header information from scene1.oct and scene2.pic: +To print the header information from scene1.oct and scene2.hdr: .IP "" .2i -getinfo scene1.oct scene2.pic +getinfo scene1.oct scene2.hdr .SH AUTHOR Greg Ward .SH "SEE ALSO" -oconv(1), pfilt(1), rhinfo(1), rpict(1), rview(1) +oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rvu(1)