man/man1/bsdfview.1

.\" RCSid "$Id: bsdfview.1,v 1.4 2017/08/17 21:32:29 greg Exp $"
.TH BSDFVIEW 1 8/11/2017 RADIANCE
.SH NAME
bsdfview - view a BSDF representation
.SH SYNOPSIS
.B bsdfview
[
.B "\-q {Hi|Med|Lo}"
][
.B \-t
|
rad options
]
input ..
.br
.SH DESCRIPTION
.I Bsdfview
renders a BSDF description interactively.
This is a script that creates a
.I rad(1)
input file (RIF),
which builds an octree via
.I bsdf2rad(1),
then renders the scene interactively or calls the
.I trad(1)
graphical user interface if the
.I \-t
option is given.
.PP
The input is either a single XML file, such as might be produced by
.I genBSDF(1),
.I bsdf2klems(1),
or
.I bsdf2ttree(1),
or up to four scattering interpolation representation (SIR) files, as
might be produced by
pabopto2bsdf(1).
.PP
A
.I rad
input file will be produced, whose name matches the root of
the first input file but with any leading path removed (i.e., in
the current directory).
This RIF may be reused for subsequent viewing and rendering via
.I rad
without incurring the cost of another call to
.I bsdf2rad.
.PP
The quality preference may be set via the
.I \-q
option.
The number of processors to use may be specified with the 
.I \-n
option.
.PP
The program creates a number of views accessible via the
.I rvu(1)
"L" command:
.TP 10n
.BR def
The default view, showing the back and front BRDFs.
.TP
.BR fr
A view of the front reflection hemisphere.
.TP
.BR br
A view of the back reflection hemisphere.
.TP
.BR ft
A fisheye view of the front transmission hemisphere (from underneath).
.TP
.BR bt
A fisheye view of the back transmission hemisphere.
.TP
.BR pr
A parallel view of both reflection hemispheres from directly overhead.
.TP
.BR pt
A parallel view of both transmission hemispheres from directly underneath.
.PP
Additionally, all the standard views that
.I rvu
defines will be available (e.g., "xZ", "zl", etc.).
.PP
Since a
.I rad
input file is created by the script, it may be used
in subsequent runs as long as the temporary files remain.
These are typically kept until the next reboot of the operating
system, so re-running
.I bsdfview
with the same arguments will not require re-running
.I bsdf2rad
or
.I oconv.
Thus, start-up will be much quicker, unless the temporary files have
been removed.
In this case, the script may exit with an error indicating that the
.I rad
input file needs to be removed.
.PP
This input file may also be re-used directly from the command line using
.I rad
or
.I trad(1).
This may be useful for generating RADIANCE pictures corresponding
to the above standard views.
If no interactive run is desired, start
.I bsdfview
with the
.I "-v 0"
option.
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
bsdf2klems(1), bsdf2rad(1), bsdf2ttree(1), genBSDF(1),
objview(1), oconv(1), pabopto2bsdf(1), rad(1), rvu(1), trad(1)
Revision:	1.5
Committed:	Wed Oct 18 19:30:48 2017 UTC (7 years, 7 months ago) by greg
Branch:	MAIN
Changes since 1.4:	+6 -1 lines
Log Message:	Added note about "-v 0" and made start-up with "-t" option more reliable.
#	User	Rev	Content
1	greg	1.5	.\" RCSid "$Id: bsdfview.1,v 1.4 2017/08/17 21:32:29 greg Exp $"
2	greg	1.1	.TH BSDFVIEW 1 8/11/2017 RADIANCE
3			.SH NAME
4			bsdfview - view a BSDF representation
5			.SH SYNOPSIS
6			.B bsdfview
7			[
8			.B "\-q {Hi\|Med\|Lo}"
9			][
10	greg	1.4	.B \-t
11			\|
12	greg	1.1	rad options
13			]
14			input ..
15			.br
16			.SH DESCRIPTION
17			.I Bsdfview
18			renders a BSDF description interactively.
19	greg	1.3	This is a script that creates a
20	greg	1.1	.I rad(1)
21	greg	1.3	input file (RIF),
22			which builds an octree via
23	greg	1.2	.I bsdf2rad(1),
24	greg	1.4	then renders the scene interactively or calls the
25			.I trad(1)
26			graphical user interface if the
27			.I \-t
28			option is given.
29	greg	1.1	.PP
30			The input is either a single XML file, such as might be produced by
31			.I genBSDF(1),
32			.I bsdf2klems(1),
33			or
34			.I bsdf2ttree(1),
35	greg	1.2	or up to four scattering interpolation representation (SIR) files, as
36	greg	1.1	might be produced by
37			pabopto2bsdf(1).
38			.PP
39	greg	1.3	A
40			.I rad
41			input file will be produced, whose name matches the root of
42	greg	1.1	the first input file but with any leading path removed (i.e., in
43			the current directory).
44			This RIF may be reused for subsequent viewing and rendering via
45			.I rad
46			without incurring the cost of another call to
47			.I bsdf2rad.
48			.PP
49			The quality preference may be set via the
50			.I \-q
51			option.
52			The number of processors to use may be specified with the
53			.I \-n
54			option.
55			.PP
56			The program creates a number of views accessible via the
57			.I rvu(1)
58			"L" command:
59			.TP 10n
60			.BR def
61			The default view, showing the back and front BRDFs.
62			.TP
63			.BR fr
64			A view of the front reflection hemisphere.
65			.TP
66			.BR br
67			A view of the back reflection hemisphere.
68			.TP
69			.BR ft
70			A fisheye view of the front transmission hemisphere (from underneath).
71			.TP
72			.BR bt
73			A fisheye view of the back transmission hemisphere.
74			.TP
75			.BR pr
76			A parallel view of both reflection hemispheres from directly overhead.
77			.TP
78			.BR pt
79			A parallel view of both transmission hemispheres from directly underneath.
80			.PP
81			Additionally, all the standard views that
82			.I rvu
83			defines will be available (e.g., "xZ", "zl", etc.).
84	greg	1.3	.PP
85			Since a
86			.I rad
87			input file is created by the script, it may be used
88			in subsequent runs as long as the temporary files remain.
89			These are typically kept until the next reboot of the operating
90			system, so re-running
91			.I bsdfview
92			with the same arguments will not require re-running
93			.I bsdf2rad
94			or
95			.I oconv.
96			Thus, start-up will be much quicker, unless the temporary files have
97			been removed.
98			In this case, the script may exit with an error indicating that the
99			.I rad
100			input file needs to be removed.
101	greg	1.4	.PP
102			This input file may also be re-used directly from the command line using
103			.I rad
104			or
105	greg	1.3	.I trad(1).
106			This may be useful for generating RADIANCE pictures corresponding
107			to the above standard views.
108	greg	1.5	If no interactive run is desired, start
109			.I bsdfview
110			with the
111			.I "-v 0"
112			option.
113	greg	1.1	.SH AUTHOR
114			Greg Ward
115			.SH "SEE ALSO"
116			bsdf2klems(1), bsdf2rad(1), bsdf2ttree(1), genBSDF(1),
117	greg	1.3	objview(1), oconv(1), pabopto2bsdf(1), rad(1), rvu(1), trad(1)