man/man1/trad.1

.\" RCSid "$Id$"
.TH TRAD 1 1/24/96 RADIANCE
.SH NAME
trad - graphical user interface to Radiance rad(1) program
.SH SYNOPSIS
.B trad
[
.B rfile
]
.SH DESCRIPTION
.I Trad
is a graphical user interface to
.I rad(1),
which controls the operation of the basic Radiance scene compiling,
rendering and picture filtering programs.
Trad also includes links to a few utilities for displaying and
converting results, but most of what it does can be done by editing
a small text file, called the "rad input file".
Scene creation still requires the use of a text or graphical editor,
or translation from some external CAD format.
.PP
.I Trad
is based on the Tcl/Tk
.I wish(1)
"windowing shell" written by John Ousterhout.
(See below for instructions on installing this package if you do not
have it already.)\0
.PP
The
.I trad
interface divides the rendering problem into seven screens:
File, Scene, Zone, Views, Options, Action and Results.
The File screen is used to load and save rad input files
(a.k.a. project files).
The Scene screen is used to name the Radiance input files associated
with a particular project.
The Zone screen is used to assign
.I rad
variables specific to the section of the model being rendered.
The Views screen is used to define specific views to be rendered and
set the picture file names and dimensions.
The Options screen is used to adjust rendering quality and other
parameters.
The Action screen is used to initiate interactive and batch
renderings.
The Results screen is used to display, convert and print the
rendered Radiance pictures.
.PP
If
.I trad
is called with no rad input file name on the command line, it will
start with the File screen and you must enter a valid project file
before you will be allowed to continue.
If
.I rfile
is given, then
.I trad
attempts to open this file.
If no such file exists,
.I trad
assumes you are creating a new file by this name and goes to the
Scene screen so you may identify the appropriate Radiance input files.
If the file exists but not all renderings have been finished,
.I trad
goes first to the Action screen, assuming you will want to do
something.
If the file exists and all renderings have completed and are
up-to-date,
.I trad
goes to the Results screen so that you may examine the final
pictures.
.PP
.I Trad
includes an extensive help facility, which may be accessed either by
pressing the "HELP" button and searching through the category and
topic menus, or by holding the Control key and
pressing the left mouse button on the mysterious
widget (i.e. the button, entry window, or list box you are curious
about).
.SH "INSTALLING TCL/TK"
The Tcl/Tk package is available by anonymous ftp from
ftp.smli.com (204.153.12.45) in the /pub/tcl directory.
(Tcl stands for "Tool Command Language," and is pronounced
"tickle".)
.I Trad
is based on Tk release 4.0, which in turn is based on Tcl release 7.4.
Although
.I trad
uses only the
.I wish
program from this package,
.I wish
itself depends on
additional Tcl and Tk libraries, and the two toolkits must be
compiled one after the other.
.PP
To compile the Tcl/Tk package, download the files "tcl7.4.tar.Z" and
"tk4.0.tar.Z" and uncompress and untar them.
Then, follow the instructions in the README file in the tcl7.4/
directory to configure the Makefile for your system and install the
software.
(Usually, it is best to do this as root or have it done by your
system administrator if you do not have root privileges.)\0
Then, do the same in the tk4.0/ directory.
.PP
.I Trad
should run without modification once this is done correctly.
.SH AUTHOR
Greg Ward
.br
.I wish
and Tcl/Tk language by John Ousterhout
.SH "SEE ALSO"
oconv(1), pfilt(1), rad(1), rpict(1), rview(1), wish(1), ximage(1)
Revision:	1.2
Committed:	Tue Dec 9 15:59:07 2003 UTC (21 years, 10 months ago) by greg
Branch:	MAIN
Changes since 1.1:	+1 -1 lines
Log Message:	Fixed RCSid specification
#	User	Rev	Content
1	greg	1.2	.\" RCSid "$Id$"
2	greg	1.1	.TH TRAD 1 1/24/96 RADIANCE
3			.SH NAME
4			trad - graphical user interface to Radiance rad(1) program
5			.SH SYNOPSIS
6			.B trad
7			[
8			.B rfile
9			]
10			.SH DESCRIPTION
11			.I Trad
12			is a graphical user interface to
13			.I rad(1),
14			which controls the operation of the basic Radiance scene compiling,
15			rendering and picture filtering programs.
16			Trad also includes links to a few utilities for displaying and
17			converting results, but most of what it does can be done by editing
18			a small text file, called the "rad input file".
19			Scene creation still requires the use of a text or graphical editor,
20			or translation from some external CAD format.
21			.PP
22			.I Trad
23			is based on the Tcl/Tk
24			.I wish(1)
25			"windowing shell" written by John Ousterhout.
26			(See below for instructions on installing this package if you do not
27			have it already.)\0
28			.PP
29			The
30			.I trad
31			interface divides the rendering problem into seven screens:
32			File, Scene, Zone, Views, Options, Action and Results.
33			The File screen is used to load and save rad input files
34			(a.k.a. project files).
35			The Scene screen is used to name the Radiance input files associated
36			with a particular project.
37			The Zone screen is used to assign
38			.I rad
39			variables specific to the section of the model being rendered.
40			The Views screen is used to define specific views to be rendered and
41			set the picture file names and dimensions.
42			The Options screen is used to adjust rendering quality and other
43			parameters.
44			The Action screen is used to initiate interactive and batch
45			renderings.
46			The Results screen is used to display, convert and print the
47			rendered Radiance pictures.
48			.PP
49			If
50			.I trad
51			is called with no rad input file name on the command line, it will
52			start with the File screen and you must enter a valid project file
53			before you will be allowed to continue.
54			If
55			.I rfile
56			is given, then
57			.I trad
58			attempts to open this file.
59			If no such file exists,
60			.I trad
61			assumes you are creating a new file by this name and goes to the
62			Scene screen so you may identify the appropriate Radiance input files.
63			If the file exists but not all renderings have been finished,
64			.I trad
65			goes first to the Action screen, assuming you will want to do
66			something.
67			If the file exists and all renderings have completed and are
68			up-to-date,
69			.I trad
70			goes to the Results screen so that you may examine the final
71			pictures.
72			.PP
73			.I Trad
74			includes an extensive help facility, which may be accessed either by
75			pressing the "HELP" button and searching through the category and
76			topic menus, or by holding the Control key and
77			pressing the left mouse button on the mysterious
78			widget (i.e. the button, entry window, or list box you are curious
79			about).
80			.SH "INSTALLING TCL/TK"
81			The Tcl/Tk package is available by anonymous ftp from
82			ftp.smli.com (204.153.12.45) in the /pub/tcl directory.
83			(Tcl stands for "Tool Command Language," and is pronounced
84			"tickle".)
85			.I Trad
86			is based on Tk release 4.0, which in turn is based on Tcl release 7.4.
87			Although
88			.I trad
89			uses only the
90			.I wish
91			program from this package,
92			.I wish
93			itself depends on
94			additional Tcl and Tk libraries, and the two toolkits must be
95			compiled one after the other.
96			.PP
97			To compile the Tcl/Tk package, download the files "tcl7.4.tar.Z" and
98			"tk4.0.tar.Z" and uncompress and untar them.
99			Then, follow the instructions in the README file in the tcl7.4/
100			directory to configure the Makefile for your system and install the
101			software.
102			(Usually, it is best to do this as root or have it done by your
103			system administrator if you do not have root privileges.)\0
104			Then, do the same in the tk4.0/ directory.
105			.PP
106			.I Trad
107			should run without modification once this is done correctly.
108			.SH AUTHOR
109			Greg Ward
110			.br
111			.I wish
112			and Tcl/Tk language by John Ousterhout
113			.SH "SEE ALSO"
114			oconv(1), pfilt(1), rad(1), rpict(1), rview(1), wish(1), ximage(1)