man/man1/trad.1

.\" RCSid "$Id: trad.1,v 1.2 2003/12/09 15:59:07 greg Exp $"
.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), rvu(1), wish(1), ximage(1)
Revision:	1.3
Committed:	Thu Jan 1 19:31:45 2004 UTC (20 years, 4 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad4R2P2, rad5R0, rad5R1, rad3R7P2, rad3R7P1, rad4R2, rad4R1, rad4R0, rad3R6, rad3R6P1, rad3R8, rad3R9, rad4R2P1, rad5R3, HEAD
Changes since 1.2:	+2 -2 lines
Log Message:	Renamed rview, lam, calc, and neat to rvu, rlam, icalc, and neaten
#	Content
1	.\" RCSid "$Id: trad.1,v 1.2 2003/12/09 15:59:07 greg Exp $"
2	.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), rvu(1), wish(1), ximage(1)