man/man1/ltpict.1
author Axel Jacobs <axel@jaloxa.eu>
Wed, 16 Apr 2014 21:47:42 +0100
changeset 81 2708809b30b6
parent 67 cb1224fcd2c2
permissions -rw-r--r--
ltpict, ltview: Up status to 4 (in HEAD)
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
67
cb1224fcd2c2 updated man pages for ltpict, ltview
Axel Jacobs <axel@jaloxa.eu>
parents: 59
diff changeset
     1
.TH "LTPICT" "1" "08/04/14" "RADIANCE" ""
59
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     2
.SH "NAME"
67
cb1224fcd2c2 updated man pages for ltpict, ltview
Axel Jacobs <axel@jaloxa.eu>
parents: 59
diff changeset
     3
ltpict \- render a four\-view image of a light source
59
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     4
.SH "SYNOPSIS"
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     5
.B ltpict
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     6
[
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     7
.B \-i
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     8
][
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     9
.B "\-d dimensions"
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    10
]
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    11
input
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    12
.SH "DESCRIPTION"
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    13
.I ltpict
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    14
is a script that renders a four\-view HDR image of a Radiance luminaire
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    15
or IES photometric file.  The
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    16
.I \-i
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    17
option tells it that the file name given is 
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    18
an IES photometry file rather then a Radiance description of a 
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    19
luminiare.  In this case, Radiance's
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    20
.I ies2rad(1)
67
cb1224fcd2c2 updated man pages for ltpict, ltview
Axel Jacobs <axel@jaloxa.eu>
parents: 59
diff changeset
    21
is called with its default settings to convert the IES file to a 
59
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    22
Radiance object.
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    23
.PP 
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    24
The four projections presented are the lower hemisphere
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    25
(displayed in the upper left quadrant), the upper hemisphere
67
cb1224fcd2c2 updated man pages for ltpict, ltview
Axel Jacobs <axel@jaloxa.eu>
parents: 59
diff changeset
    26
(upper right), the C0\-C180 plane (lower left) and the
59
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    27
C90\-C270 plane (lower right).
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    28
.PP 
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    29
Only one Radiance luminaire description or IES photometry file
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    30
may be given.  No input is accepted on STDIN.
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    31
.PP 
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    32
The output image in HDR format is produced on STDOUT with
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    33
the default dimensions of 1024 by 1024 pixels.  The dimensions
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    34
may be overwritten with the 
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    35
.I "\-d dimensions
67
cb1224fcd2c2 updated man pages for ltpict, ltview
Axel Jacobs <axel@jaloxa.eu>
parents: 59
diff changeset
    36
option which takes an integer that is divisible by two.
59
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    37
.SH "EXAMPLES"
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    38
To render a four\-view image of photometry file ABC123.ies
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    39
and save the result to luminaire.hdr
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    40
.IP "" .2i
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    41
ltpict \-i ABC123.ies > luminaire.hdr
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    42
.PP 
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    43
To render a small four\-view HDR image of the 
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    44
RADIANCE luminaire XYZ456.rad to STDOUT, and display it with ximage
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    45
.IP "" .2i
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    46
ltpict \-d 400 XYZ456.rad | ximage
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    47
.SH "AUTHOR"
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    48
Axel Jacobs
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    49
.SH "SEE ALSO"
626ea3bad930 man pages for ltpict and ltview
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    50
objline(1), objview(1), objpict(1), ies2rad(1), ltview(1)