--- ray/doc/man/man1/getinfo.1 2007/09/04 17:36:40 1.4 +++ ray/doc/man/man1/getinfo.1 2016/08/30 06:10:12 1.7 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: getinfo.1,v 1.4 2007/09/04 17:36:40 greg Exp $" +.\" RCSid "$Id: getinfo.1,v 1.7 2016/08/30 06:10:12 greg Exp $" .TH GETINFO 1 1/15/99 RADIANCE .SH NAME getinfo - get header information from a RADIANCE file @@ -12,6 +12,14 @@ getinfo - get header information from a RADIANCE file .br .B getinfo - +.br +.B getinfo +.B -a +.B "info_line1 .." +.br +.B getinfo +.B -c +.B "command .." .SH DESCRIPTION .I Getinfo reads the header of each RADIANCE @@ -37,14 +45,34 @@ 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 \-a" +adds one or more header lines to the standard input. +These lines are given as arguments to +.I getinfo, +and must be quoted if they contain spaces. +.PP +The fourth 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), rvu(1) +oconv(1), pfilt(1), rcalc(1), rhinfo(1), rpict(1), rvu(1)