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
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
|
<!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: MSVC7</TITLE>
<META NAME="description" CONTENT="Crystal Space: MSVC7">
<META NAME="keywords" CONTENT="Crystal Space: MSVC7">
<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="SEC76"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_27.html#SEC57"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_29.html#SEC91"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_20.html#SEC30"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_25.html#SEC35"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_29.html#SEC91"> >> </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.2.3 Microsoft Visual C++ 7 </H4>
<!--docid::SEC76::-->
<P>
In order to successfully compile the Crystal Space 3D Software Development
Kit (SDK), you will need a copy of <EM>Microsoft Developer Studio .NET</EM>
or the stand alone version of <EM>Microsoft Visual C++ 7</EM>.
</P><P>
<A NAME="SEC77"></A>
<H4> Getting Extra Help </H4>
<!--docid::SEC77::-->
<P>
If you need help with Crystal Space and Visual C++ or just Crystal Space in
general. You can subscribe and then post a message to the Crystal Space
mailing list. To subscribe see the following site and fill in the form:
</P><P>
<A HREF="http://lists.sourceforge.net/lists/listinfo/crystal-main">http://lists.sourceforge.net/lists/listinfo/crystal-main</A>
</P><P>
Alternatively you can email the Win32 port maintainer directly at the following:
</P><P>
<A HREF="mailto:philipwyett@dsl.pipex.com">philipwyett@dsl.pipex.com</A>.
</P><P>
<A NAME="SEC78"></A>
<H4> Required/Optional External Libraries and Software </H4>
<!--docid::SEC78::-->
<P>
All the following libraries and Software Development Kits (SDK) unless
stated are not required. However, if you choose not to install them, at
compile time you must follow the documented instructions of how to unload these
projects from the Crystal Space build process.
</P><P>
<A NAME="SEC79"></A>
<H4> msvc7_libs - Required </H4>
<!--docid::SEC79::-->
<P>
Before you attempt to compile Crystal Space, you must download
and install `<TT>msvc7_libs</TT>'. msvc7_libs is a package containing all
third party header, pre-built library and dll files used by Crystal
Space, i.e. `<TT>zlib.dll</TT>', `<TT>libjpeg.dll</TT>', `<TT>png.dll</TT>' and
`<TT>xmlparse.dll</TT>' etc. The latest version of the msvc7_libs package
`<TT>msvc7_libs_0.94.zip</TT>' can be downloaded from:
</P><P>
<A HREF="ftp://ftp.sunsite.dk/projects/crystal/support/win32/msvc7/msvc7_libs_0.94.zip">ftp://ftp.sunsite.dk/projects/crystal/support/win32/msvc7/msvc7_libs_0.94.zip</A>
</P><P>
<A HREF="ftp://62.188.48.183/crystal_space/support/win32/msvc7/msvc7_libs_0.94.zip">ftp://62.188.48.183/crystal_space/support/win32/msvc7/msvc7_libs_0.94.zip</A>
</P><P>
Once you have downloaded the msvc_libs package, extract it too your `<TT>CS\</TT>'
root directory.
</P><P>
<A NAME="SEC80"></A>
<H4> DirectX - Required </H4>
<!--docid::SEC80::-->
<P>
In order to compile Crystal Space at its minimum i.e. the software render,
requires you must have at least some form of the DirectX Software Development
Kit (SDK) on your system.
</P><P>
Visual C++ 7 comes with the minimum DirectX SDK 8.1 pre-release files
in-order to build Crystal Space. However, I advize you download the final
8.1 version to guarentee complete compliance.
</P><P>
To enable you to build Crystal Space to it optimum D3D support, you must
download the latest DirectX Software Development Kit (SDK), which can be
obtained from:
</P><P>
<A HREF="http://www.msdn.microsoft.com/directx">http://www.msdn.microsoft.com/directx</A>
</P><P>
<A NAME="SEC81"></A>
<H4> Simple Direct Media Layer </H4>
<!--docid::SEC81::-->
<P>
Crystal Space contains support for a Simple Direct Media Layer 2D canvas which
can be used as an alternative to the default Direct Draw canvas for use with
the Crystal Space software 3D renderer. To compile the SDL2D canvas you must
have the supported 1.2.3 development runtime for your version of MSVC be
it 5 or 6. Please remeber to add the `<TT>include</TT>' and `<TT>lib</TT>' directories
to the global MSVC options, so MSVC can see them.
</P><P>
<A HREF="http://www.libsdl.org">http://www.libsdl.org</A>
</P><P>
Also remember to copy the `<TT>sdl.dll</TT>' into the `<TT>CS\</TT>' root directory
or at it to your systems path before using the SDL2D canvas.
</P><P>
For instructon on using a specific canvas including
the SDL2D canvas <A HREF="cs_46.html#SEC120">3.1 Common Command Line Options</A>
</P><P>
<A NAME="SEC82"></A>
<H4> Python </H4>
<!--docid::SEC82::-->
<P>
Crystal Space contains support for Python scripting and thus has projects
within it requires that Python be installed on your system. If you wish to
compile with Python support you must install Python 2.2 or later, which can be
obtained from:
</P><P>
<A HREF="http://www.python.org">http://www.python.org</A>
</P><P>
<A NAME="SEC83"></A>
<H4> BisonFlex - Required </H4>
<!--docid::SEC83::-->
<P>
The Alternate Window System (AWS) plugin will build correctly under MSVC.
However, if you wish to make modifications to it's structure and or lexer, it will
require you re-generate <EM>sllex.cpp, slparse.cpp, slparse.cpp.h and slparse.h</EM>.
If you need todo this will require you have Bison and Flex on your system. The
suggested and supported version can be obtained via the link below.
</P><P>
For Visual C++ 6:
</P><P>
<A HREF="http://www.philipwyett.dsl.pipex.com/crystal_space/msvc/downloads/bfwizard-1.6.zip">http://www.philipwyett.dsl.pipex.com/crystal_space/msvc/downloads/bfwizard-1.6.zip</A>
</P><P>
Install this package to a location of your choice on your system. During the install
process, it will detect MSVC and install itself in the appropraiate directories and
the executables in the system path. Being that BisonFlex was released for MSVC 6. You
will have to ignore the auto-detection and point to the correct locations. When prompted
for the <EM>common</EM> directory, direct it to the <EM>X:\msvc_install_dir\Common7</EM> dir.
Proceed to the next prompt where you will be asked the location of VC7, so point it
to the <EM>X:\msvc_install_dir\Vc7</EM>. Now just continue with the install.
</P><P>
<A NAME="SEC84"></A>
<H4> Setting up and building the AWS plugin </H4>
<!--docid::SEC84::-->
<P>
To re-generate the files mentioned above. Open a <EM>MS-DOS Prompt/Command Prompt</EM> and
navigate to the <EM>CS\</EM> root directory. Next, just enter the command lines listed
below.
</P><P>
<CODE>flex -L -Splugins/aws/flex.skl -t plugins/aws/skinlang.flx > plugins/aws/sllex.cpp</CODE>
</P><P>
<CODE>bison --no-lines -d -p aws -o plugins/aws/slparse.cpp plugins/aws/skinlang.bsn</CODE>
</P><P>
Now just follow the <EM>Compiling Crystal Space</EM> instructions to again re-build AWS
with your modifications included.
</P><P>
<A NAME="SEC85"></A>
<H4> Creative EAX 2.0 </H4>
<!--docid::SEC85::-->
<P>
In order to build the CS EAX 2.0 enviromental audio plugin (<EM>plgsndrdreax</EM>), requires
you have the EAX 2.0 SDK on your system. The SDK can be obtained from the following website.
</P><P>
<A HREF="http://developer.creative.com/LEFTMENU/DC_LM_Downloads.asp">http://developer.creative.com/LEFTMENU/DC_LM_Downloads.asp</A>
</P><P>
After installtion you will need to point MSVC to the SDK's include and lib paths.
</P><P>
<A NAME="SEC86"></A>
<H4> Compiling Crystal Space </H4>
<!--docid::SEC86::-->
<P>
To compile Crystal Space, you'll have to perform the following steps. If
anything doesn't work, see the Win32 FAQ, <A HREF="cs_28.html#MSVC7 FAQ">MSVC7 FAQ</A>.
</P><P>
<OL>
<LI>
Load `<TT>CS\mk\visualc\csall.dsw</TT>'.
<P>
<LI>
You will now be prompted to convert all older <EM>MSVC 6</EM> project files to the new
<EM>MSVC 7</EM> format. Click on <EM>Yes To All</EM>.
<P>
<LI>
From the file menu selct <EM>Build->Build Solution</EM>.
<P>
<LI>
After a while the compilation should finish. The signal for a
successful build will be come in the form of the something similar to the
following:
<P>
<TABLE><tr><td> </td><td class=example><pre>Build: 1 succeeded, 0 failed, 0 skipped
</pre></td></tr></table></OL>
<P>
<A NAME="SEC87"></A>
<H4> Running the Demonstration Applications </H4>
<!--docid::SEC87::-->
<P>
The first app you should try is Walktest. This program shows many of the
features of the 3D engine. You can run it by starting it from the windows
explorer. It should be at `<TT>.../cs/walktest.exe</TT>'. Don't start it from
other locations or from within Visual Studio. It won't find the required files
if you do.
</P><P>
If you want to run a debug session, you first have to set the working
directory. First select the project you wish to debug and setting it as the
startup project. Next open <EM>Project->Properties->Debugging</EM> and enter
the base `<TT>CS\</TT>' directory as the working directory for debug sessions
(for example, `<TT>C:\CS\</TT>'). Be sure to to this for <EM>Debug</EM> and
<EM>Release</EM> builds.
</P><P>
You can now continue with the next platform-independent step. The remaining
Windows-specific sections are only important when you want to compile your own
application using Crystal Space.
</P><P>
<A NAME="SEC88"></A>
<H4> Structure of the Workspace </H4>
<!--docid::SEC88::-->
<P>
<EM>Note</EM>: If you find bugs in the MSVC project or workspace files
coming with Crystal Space, don't send fixes for these files to the developers.
These files are generated automatically, so your fixes would be useless.
Better, send a description of the bug to the mailing list.
</P><P>
The Crystal Space workspace is divided into several projects. They all exist
as separate project files (`<TT>*.dsp</TT>'). All of them are being bound together
by a workspace `<TT>csall.dsw</TT>'. This workspace will also ensure correct
linking between the various projects.
</P><P>
The workspace uses a prefix system for naming the projects and grouping them.
There are currently four prefixes in use. The prefix `<TT>grp</TT>' is used to
group the projects into the three main categories: <EM>libraries</EM>,
<EM>plug-ins</EM>, and <EM>applications</EM>. There is also a special group
`<SAMP>grpall</SAMP>' that contains the three major groups `<SAMP>grplibs</SAMP>',
`<SAMP>grpapps</SAMP>', and `<SAMP>grpplugins</SAMP>'.
</P><P>
The <EM>Libraries</EM> are C++ libraries that you can link into your own
programs. Some of these libraries are part of the core of Crystal Space. You
can find more information about this in <A HREF="cs_128.html#SEC290">6. Libraries</A>. Their output are
`<TT>.lib</TT>' files.
</P><P>
The <EM>Plugins</EM> are also programming libraries, but they use a special
mechanism called SCF as their interface to your program. This separates
their interface from the internals of the library and thus allows dynamic
linking. In fact, some of the <EM>Libraries</EM> also use SCF. The rule
for the MSVC workspace is simple: The <EM>Plugins</EM> are projects that
build a dynamic library (`<TT>.dll</TT>'). You can find more information in the
section of this manual dealing with plug-in modules. See section <A HREF="cs_159.html#SEC338">7. Plug-In Modules and Drivers</A>.
</P><P>
The <EM>Applications</EM> are programs using some of these libraries, so they
produce `<TT>.exe</TT>' files.
</P><P>
<A NAME="SEC89"></A>
<H4> Compiling Your Own Program Using Crystal Space </H4>
<!--docid::SEC89::-->
<P>
<EM>TODO</EM> Point this to the HOWTO for creating apps under MSVC7.
</P><P>
<A NAME="SEC90"></A>
<H4> Frequently Asked Questions (FAQ) </H4>
<!--docid::SEC90::-->
<A NAME="MSVC7 FAQ"></A>
<P>
<EM>TODO</EM>
</P><P>
<BLOCKQUOTE>
Q. <EM>I have a problem that you haven't solved here!</EM>
<P>
A. Try sending a note to the Crystal Space mailing list and asking your
question there. See section <A HREF="cs_8.html#SEC10">1.7 Mailing Lists</A>. Be sure to include any pertinent
information, such as the operating system you are using, the compiler, which
version of Crystal Space, and any special configuration information.
</BLOCKQUOTE>
<P>
<A NAME="MinGW"></A>
<HR SIZE=1>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_27.html#SEC57"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_29.html#SEC91"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_20.html#SEC30"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_25.html#SEC35"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_29.html#SEC91"> >> </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>
|
