man/man1/ltview.1

.\" 
.TH "LTVIEW" "1" "08/04/14" "RADIANCE" ""
.SH "NAME"
ltview \- view photometry of a light source
.SH "SYNOPSIS"
.B ltview
[
.B \-i
][
.B "\-b boxsize"
][
.B "\-o device"
]
input
.SH "DESCRIPTION"
.I ltview
renders a Radiance luminiare or IES photometry interactively using
.I rad(1).
.PP 
.I ltview
accepts exactly one Radiance object or IES photometry
file as input.  No input is taken from STDIN.  The
.I \-i
option tells it that the input file contains 
IES photometry 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 
Unlike
.I objpict(1)
or
.I objview(1),
no additional light sources are added to the scene, since it is
assumed that the object is a luminaire.
.PP 
.I ltview
relies on Radiance's
.I rad(1)
command to compile an octree using 
.I oconv(1)
and to call
.I rvu(1)
to display an interactive preview of the luminaire.
The luminaire, or output from 
.I ies2rad(1),
is moved so that its center is at world origin.
.I ltview
then generates an open box around the fitting that is ten times
as big as the largest axis\-aligned dimension of the fitting.
The \-y face of the box is left open so that 
the camera can look inside, facing +y.
The overall dimensions of the enclosing box may be overwritten with the
.I "\-b boxsize"
option.  Note that both the fitting and the box are always centred at the
origin.
.PP 
When
.I ltview
is run with the
.I \-i
option, i.e. the file is an IES photometry file,
then the dimensions of the luminaire and intesity of its 
output are determined by
.I ies2rad(1)'s
default settings.  If this is not acceptable, then it is best to run
.I ies2rad(1)
manually, and to feed
.I ltview
the hand\-crafted fitting, rather than the IES photometry.  In any case,
it is likely that the initial exposure within the 
.I rvu(1)
window window needs to be adjusted before the distribution of the fitting
can be fully appreciated.
.PP 
The default
.I rvu(1)
output device is
.I x11
on all platforms except for Windows, where it is set to
.I qt.
This may be overwritten with the
.I "\-o output"
option.

.SH "EXAMPLES"
To query available output devices
.IP "" .2i
rvu \-devices
.PP 
To visualise an IES file with the qt driver
.IP "" .2i
ltview \-o qt ABC123.ies
.PP 
To look at a typical fluorescent fitting that is modelled in millimeters
.IP "" .2i
ltview \-b 5000 XYZ_batten.rad
.SH "AUTHOR"
Axel Jacobs
.SH "SEE ALSO"
ltpict(1), ies2rad(1), oconv(1), rad(1), rvu(1)
Revision:	1.2
Committed:	Wed Apr 16 20:32:00 2014 UTC (11 years ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad4R2P2, rad5R0, rad5R1, rad4R2, rad4R2P1, rad5R3, HEAD
Changes since 1.1:	+29 -29 lines
Log Message:	Axel updates to ltview and ltpict
#	User	Rev	Content
1	greg	1.2	.\"
2	greg	1.1	.TH "LTVIEW" "1" "08/04/14" "RADIANCE" ""
3			.SH "NAME"
4			ltview \- view photometry of a light source
5			.SH "SYNOPSIS"
6			.B ltview
7			[
8			.B \-i
9			][
10			.B "\-b boxsize"
11			][
12	greg	1.2	.B "\-o device"
13	greg	1.1	]
14			input
15			.SH "DESCRIPTION"
16			.I ltview
17			renders a Radiance luminiare or IES photometry interactively using
18	greg	1.2	.I rad(1).
19	greg	1.1	.PP
20			.I ltview
21			accepts exactly one Radiance object or IES photometry
22			file as input. No input is taken from STDIN. The
23			.I \-i
24	greg	1.2	option tells it that the input file contains
25			IES photometry rather then a Radiance description of a
26	greg	1.1	luminiare. In this case, Radiance's
27			.I ies2rad(1)
28			is called with its default settings to convert the IES file into a
29			Radiance object.
30			.PP
31			Unlike
32			.I objpict(1)
33			or
34	greg	1.2	.I objview(1),
35			no additional light sources are added to the scene, since it is
36	greg	1.1	assumed that the object is a luminaire.
37			.PP
38			.I ltview
39			relies on Radiance's
40			.I rad(1)
41			command to compile an octree using
42			.I oconv(1)
43			and to call
44			.I rvu(1)
45			to display an interactive preview of the luminaire.
46	greg	1.2	The luminaire, or output from
47			.I ies2rad(1),
48			is moved so that its center is at world origin.
49	greg	1.1	.I ltview
50	greg	1.2	then generates an open box around the fitting that is ten times
51			as big as the largest axis\-aligned dimension of the fitting.
52			The \-y face of the box is left open so that
53	greg	1.1	the camera can look inside, facing +y.
54	greg	1.2	The overall dimensions of the enclosing box may be overwritten with the
55			.I "\-b boxsize"
56			option. Note that both the fitting and the box are always centred at the
57			origin.
58			.PP
59			When
60			.I ltview
61			is run with the
62	greg	1.1	.I \-i
63	greg	1.2	option, i.e. the file is an IES photometry file,
64			then the dimensions of the luminaire and intesity of its
65	greg	1.1	output are determined by
66			.I ies2rad(1)'s
67			default settings. If this is not acceptable, then it is best to run
68			.I ies2rad(1)
69			manually, and to feed
70			.I ltview
71	greg	1.2	the hand\-crafted fitting, rather than the IES photometry. In any case,
72			it is likely that the initial exposure within the
73			.I rvu(1)
74			window window needs to be adjusted before the distribution of the fitting
75			can be fully appreciated.
76	greg	1.1	.PP
77			The default
78			.I rvu(1)
79			output device is
80			.I x11
81			on all platforms except for Windows, where it is set to
82			.I qt.
83			This may be overwritten with the
84			.I "\-o output"
85			option.
86
87			.SH "EXAMPLES"
88			To query available output devices
89			.IP "" .2i
90			rvu \-devices
91			.PP
92			To visualise an IES file with the qt driver
93			.IP "" .2i
94			ltview \-o qt ABC123.ies
95			.PP
96			To look at a typical fluorescent fitting that is modelled in millimeters
97			.IP "" .2i
98	greg	1.2	ltview \-b 5000 XYZ_batten.rad
99	greg	1.1	.SH "AUTHOR"
100			Axel Jacobs
101			.SH "SEE ALSO"
102			ltpict(1), ies2rad(1), oconv(1), rad(1), rvu(1)