man/man1/ltpict.1
changeset 59 626ea3bad930
child 67 cb1224fcd2c2
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/man/man1/ltpict.1	Tue Mar 11 00:28:22 2014 +0000
@@ -0,0 +1,50 @@
+.TH "LTPICT" "1" "11/03/14" "RADIANCE" ""
+.SH "NAME"
+ltpict \- render a four\-view image of light source
+.SH "SYNOPSIS"
+.B ltpict
+[
+.B \-i
+][
+.B "\-d dimensions"
+]
+input
+.SH "DESCRIPTION"
+.I ltpict
+is a script that renders a four\-view HDR image of a Radiance luminaire
+or IES photometric file.  The
+.I \-i
+option tells it that the file name given is 
+an IES photometry file rather then a Radiance description of a 
+luminiare.  In this case, Radiance's
+.I ies2rad(1)
+is called with its default settings to convert the IES file into a 
+Radiance object.
+.PP 
+The four projections presented are the lower hemisphere
+(displayed in the upper left quadrant), the upper hemisphere
+(upper right), at the C0\-C180 plane (lower left) and at the
+C90\-C270 plane (lower right).
+.PP 
+Only one Radiance luminaire description or IES photometry file
+may be given.  No input is accepted on STDIN.
+.PP 
+The output image in HDR format is produced on STDOUT with
+the default dimensions of 1024 by 1024 pixels.  The dimensions
+may be overwritten with the 
+.I "\-d dimensions
+options which takes an integer that is divisible by two.
+.SH "EXAMPLES"
+To render a four\-view image of photometry file ABC123.ies
+and save the result to luminaire.hdr
+.IP "" .2i
+ltpict \-i ABC123.ies > luminaire.hdr
+.PP 
+To render a small four\-view HDR image of the 
+RADIANCE luminaire XYZ456.rad to STDOUT, and display it with ximage
+.IP "" .2i
+ltpict \-d 400 XYZ456.rad | ximage
+.SH "AUTHOR"
+Axel Jacobs
+.SH "SEE ALSO"
+objline(1), objview(1), objpict(1), ies2rad(1), ltview(1)