1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created by texi2html 1.64 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
-->
<HTML>
<HEAD>
<TITLE>Crystal Space: NeXT Running Programs</TITLE>
<META NAME="description" CONTENT="Crystal Space: NeXT Running Programs">
<META NAME="keywords" CONTENT="Crystal Space: NeXT Running Programs">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="texi2html 1.64">
</HEAD>
<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<A NAME="SEC104"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_35.html#SEC103"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_37.html#SEC105"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_29.html#SEC91"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_30.html#SEC98"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_37.html#SEC105"> >> </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_toc.html#SEC_Contents">Contents</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_285.html#SEC711">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<HR SIZE=1>
<H4> 2.4.4.6 Using Crystal Space </H4>
<!--docid::SEC104::-->
<P>
Before attempting to run any of the Crystal Space sample applications, ensure
that the files `<TT>standard.zip</TT>' and `<TT>stdtex.zip</TT>' reside in
`<TT>CS/data</TT>'. These files contain resources and textures which are used by
several of the example programs and map files.
</P><P>
You need to have one or more <EM>map</EM> files in order to run WalkTest. These
are the files which contain the maps and rooms which you can explore with
WalkTest. The most commonly used example map file is `<TT>flarge</TT>'.
</P><P>
<STRONG>Note</STRONG>: It is not currently possible to launch the Crystal Space
demonstration applications by double-clicking on them via the Finder on
MacOS/X, the Viewer in MacOS/X Server 1.0, or from the the Workspace Manager's
File Viewer on OpenStep and NextStep. This problem is a result of a limitation
of the Finder, Viewer, and Workspace Manager applications. When the Crystal
Space demonstration applications are launched, they expect to find the
configuration files `<TT>scf.cfg</TT>' and `<TT>vfs.cfg</TT>' in the <EM>current
directory</EM>---which is generally the same directory in which the Crystal Space
applications reside. Unfortunately, neither Finder, Viewer, nor Workspace
Manager provide the necessary information for Crystal Space to locate these
administrative files. This problem will be corrected in the future once a
suitable work-around has been devised. <EM>Therefore, at this time, all
Crystal Space applications <STRONG>must</STRONG> be launched from the command-line.</EM>
</P><P>
Before running the demonstration programs for the first time, you should create
a file named `<TT>user.cfg</TT>' in the `<TT>CS/data/config</TT>' directory. You can
use this file to increase the ambient light level used for map files since the
default level is typically too dim on the Apple/NeXT displays. To correct
this problem, edit `<TT>user.cfg</TT>' and add a line to it similar to the
following:
</P><P>
<TABLE><tr><td> </td><td class=example><pre>Glboal.Engine.Lighting.Ambient.White = 70
</pre></td></tr></table></P><P>
Some potentially good choices for this setting are summarized below. If these
values do not work well for you, experiment with others until you find one
which is suitable.
</P><P>
<BLOCKQUOTE>
<TABLE>
<TR><TD><EM>Platform</EM> </TD><TD> <EM>Setting</EM></TD>
</TR>
<TR><TD>MacOS/X </TD><TD> <CODE>Glboal.Engine.Lighting.Ambient.White=70</CODE></TD>
</TR>
<TR><TD>MacOS/X Server 1.0 </TD><TD> <CODE>Glboal.Engine.Lighting.Ambient.White=70</CODE></TD>
</TR>
<TR><TD>OpenStep </TD><TD> <CODE>Glboal.Engine.Lighting.Ambient.White=50</CODE></TD>
</TR>
<TR><TD>NextStep </TD><TD> <CODE>Glboal.Engine.Lighting.Ambient.White=50</CODE></TD>
</TR></TABLE>
</BLOCKQUOTE>
<P>
<STRONG>Important</STRONG>: The first time you explore a map after changing the ambient
white value, you should run WalkTest with the `<SAMP>--relight</SAMP>' option. This
causes Crystal Space to recalculate the lighting information in the map in
order to take advantage of the new ambient light value.
</P><P>
Note, however, that this process may be time consuming, particularly for
certain sizable maps, so be patient. In other cases, Crystal Space may
determine, on its own, that lighting needs to be recalculated. This is a
normal occurrence and should not cause alarm.
</P><P>
As a general rule, you may find it useful to specify the `<SAMP>--relight</SAMP>'
option with newly downloaded maps, or at any other time that the lighting in a
map seems to be somehow incorrect.
</P><P>
To run WalkTest with a particular map (for instance, `<TT>flarge</TT>') for the
very first time, type:
</P><P>
<TABLE><tr><td> </td><td class=example><pre>walktest --relight flarge
</pre></td></tr></table></P><P>
Subsequent uses of the map file do not require `<SAMP>-relight</SAMP>', in which case
you can type:
</P><P>
<TABLE><tr><td> </td><td class=example><pre>walktest flarge
</pre></td></tr></table></P><P>
Once invoked, you will be able to explore the map file (`<TT>flarge</TT>') by using
the navigation controls (see section <A HREF="cs_56.html#SEC137">4.2.1 Keyboard Interface</A>). To explore a different
map, substitute its name in place of `<SAMP>flarge</SAMP>'.
</P><P>
Other interesting applications, such as Blocks or csDemo, can be run by typing
the application's name at the command line:
</P><P>
<TABLE><tr><td> </td><td class=example><pre>blocks
csdemo
</pre></td></tr></table></P><P>
Finally, it is possible to use the Apple/NeXT defaults system to inform
Crystal Space applications about the location of the Crystal Space resources.
The `<SAMP>CrystalSpaceRoot</SAMP>' setting can be configured with an absolute path
which points at the root of the Crystal Space resource hierarchy within the
filesystem. It is most useful to configure this setting in the <EM>global</EM>
defaults domain. For example, on MacOS/X, MacOS/X Server 1.0 (Rhapsody), or
OpenStep, you could invoke this command from the command-line:
</P><P>
<TABLE><tr><td> </td><td class=example><pre>defaults write NSGlobalDomain CrystalSpaceRoot "/usr/local/CS"
</pre></td></tr></table></P><P>
On NextStep, you would invoke this command:
</P><P>
<TABLE><tr><td> </td><td class=example><pre>dwrite Global CrystalSpaceRoot "/usr/local/CS"
</pre></td></tr></table></P><P>
It is also possible to instruct Crystal Space applications to ignore the value
of `<SAMP>CrystalSpaceRoot</SAMP>' by assigning the `<SAMP>CrystalSpaceRootIgnore</SAMP>'
option a value of `<SAMP>Yes</SAMP>'. This is most useful when you would like to have
a particular application ignore the value of `<SAMP>CrystalSpaceRoot</SAMP>' set in the
global domain. For example:
</P><P>
<TABLE><tr><td> </td><td class=example><pre>defaults write walktest CrystalSpaceRootIgnore "Yes"
</pre></td></tr></table></P><P>
<A NAME="OS2"></A>
<HR SIZE=1>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_35.html#SEC103"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_37.html#SEC105"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_29.html#SEC91"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_30.html#SEC98"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_37.html#SEC105"> >> </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_toc.html#SEC_Contents">Contents</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_285.html#SEC711">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<BR>
<FONT SIZE="-1">
This document was generated
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
</BODY>
</HTML>
|
