7 [ |
7 [ |
8 .B \-i |
8 .B \-i |
9 ][ |
9 ][ |
10 .B "\-b boxsize" |
10 .B "\-b boxsize" |
11 ][ |
11 ][ |
12 .B "\-o output device" |
12 .B "\-o device" |
13 ] |
13 ] |
14 input |
14 input |
15 .SH "DESCRIPTION" |
15 .SH "DESCRIPTION" |
16 .I ltview |
16 .I ltview |
17 renders a Radiance luminiare or IES photometry interactively using |
17 renders a Radiance luminiare or IES photometry interactively using |
18 .I rad(1) |
18 .I rad(1). |
19 . This program is merely a shell script that calls |
|
20 .I rad(1) |
|
21 to make an octree and view the scene interactively. |
|
22 .PP |
19 .PP |
23 .I ltview |
20 .I ltview |
24 accepts exactly one Radiance object or IES photometry |
21 accepts exactly one Radiance object or IES photometry |
25 file as input. No input is taken from STDIN. The |
22 file as input. No input is taken from STDIN. The |
26 .I \-i |
23 .I \-i |
27 option tells it that the file name given is |
24 option tells it that the input file contains |
28 an IES photometry file rather then a Radiance description of a |
25 IES photometry rather then a Radiance description of a |
29 luminiare. In this case, Radiance's |
26 luminiare. In this case, Radiance's |
30 .I ies2rad(1) |
27 .I ies2rad(1) |
31 is called with its default settings to convert the IES file into a |
28 is called with its default settings to convert the IES file into a |
32 Radiance object. |
29 Radiance object. |
33 .PP |
30 .PP |
34 Unlike |
31 Unlike |
35 .I objpict(1) |
32 .I objpict(1) |
36 or |
33 or |
37 .I objview(1) |
34 .I objview(1), |
38 , no additional light sources are added to the scene, since it is |
35 no additional light sources are added to the scene, since it is |
39 assumed that the object is a luminaire. |
36 assumed that the object is a luminaire. |
40 .PP |
37 .PP |
41 .I ltview |
38 .I ltview |
42 relies on Radiance's |
39 relies on Radiance's |
43 .I rad(1) |
40 .I rad(1) |
44 command to compile an octree using |
41 command to compile an octree using |
45 .I oconv(1) |
42 .I oconv(1) |
46 and to call |
43 and to call |
47 .I rvu(1) |
44 .I rvu(1) |
48 to display an interactive preview of the luminaire. |
45 to display an interactive preview of the luminaire. |
49 The default behaviour for |
46 The luminaire, or output from |
|
47 .I ies2rad(1), |
|
48 is moved so that its center is at world origin. |
50 .I ltview |
49 .I ltview |
51 is to scale the luminaire or output from |
50 then generates an open box around the fitting that is ten times |
52 .I ies2rad(1) |
51 as big as the largest axis\-aligned dimension of the fitting. |
53 so that the largest dimension of the fitting is unity, centered at the origin. |
52 The \-y face of the box is left open so that |
54 This scaled representation of the original fitting is then placed inside a |
|
55 square box 10 units in length. The \-y face of the box is left open so that |
|
56 the camera can look inside, facing +y. |
53 the camera can look inside, facing +y. |
57 If it is desirable to keep the original luminaire in both its original size, |
54 The overall dimensions of the enclosing box may be overwritten with the |
58 and its original location, the |
55 .I "\-b boxsize" |
59 .I "\-r roomsize" |
56 option. Note that both the fitting and the box are always centred at the |
60 option may be used to fix the room size to a certain |
57 origin. |
61 .I roomsize. |
58 .PP |
62 In this case, the size and location of the fitting is not adjusted, and |
59 When |
63 it is up to the user to decide on appropriate room dimensions. Note that |
60 .I ltview |
64 when |
61 is run with the |
65 .I \-r |
|
66 and |
|
67 .I \-i |
62 .I \-i |
68 are combined, then the dimensions of the luminaire and intesity of its |
63 option, i.e. the file is an IES photometry file, |
|
64 then the dimensions of the luminaire and intesity of its |
69 output are determined by |
65 output are determined by |
70 .I ies2rad(1)'s |
66 .I ies2rad(1)'s |
71 default settings. If this is not acceptable, then it is best to run |
67 default settings. If this is not acceptable, then it is best to run |
72 .I ies2rad(1) |
68 .I ies2rad(1) |
73 manually, and to feed |
69 manually, and to feed |
74 .I ltview |
70 .I ltview |
75 the hand\-crafted fitting, rather than the IES photometry. |
71 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 .PP |
76 .PP |
77 The default |
77 The default |
78 .I rvu(1) |
78 .I rvu(1) |
79 output device is |
79 output device is |
80 .I x11 |
80 .I x11 |