source: OGRE/trunk/ogrenew/Docs/FAQ.html @ 657

Revision 657, 12.4 KB checked in by mattausch, 19 years ago (diff)

added ogre dependencies and patched ogre sources
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<HTML>
3<HEAD>
4        <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
5        <TITLE>OGRE FAQ</TITLE>
6        <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.4  (Win32)">
7        <META NAME="CREATED" CONTENT="20050219;17050904">
8        <META NAME="CHANGED" CONTENT="20050219;17184518">
9        <link rel="stylesheet" type="text/css" href="style.css">
10
11</HEAD>
12<BODY LANG="en-US" TEXT="#ccffcc" LINK="#ffff00" BGCOLOR="#003300" DIR="LTR">
13<P CLASS="header" ALIGN=CENTER>OGRE (Object-Oriented Graphics
14Rendering Engine)</P>
15<P CLASS="header" ALIGN=CENTER>Frequently Asked Questions (FAQ)</P>
16<P CLASS="mainheader" ALIGN=LEFT>Q: What platforms does OGRE build
17under?
18</P>
19<TABLE WIDTH=100% BORDER=1 BORDERCOLOR="#996600" CELLPADDING=0 CELLSPACING=0>
20        <TR>
21                <TD WIDTH=33% BGCOLOR="#999900">
22                        <P ALIGN=CENTER><FONT COLOR="#333300"><FONT SIZE=1 STYLE="font-size: 8pt"><B>Platform</B></FONT></FONT></P>
23                </TD>
24                <TD WIDTH=20% BGCOLOR="#999900">
25                        <P ALIGN=CENTER><FONT COLOR="#333300"><FONT SIZE=1 STYLE="font-size: 8pt"><B>Compiler</B></FONT></FONT></P>
26                </TD>
27                <TD BGCOLOR="#999900">
28                        <P ALIGN=CENTER><FONT COLOR="#333300"><FONT SIZE=1 STYLE="font-size: 8pt"><B>Extra
29                        Notes</B></FONT></FONT></P>
30                </TD>
31        </TR>
32        <TR>
33                <TD WIDTH=33%>
34                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
35                        <FONT COLOR="#66cc33"><FONT SIZE=1 STYLE="font-size: 8pt">Windows
36                        95/98/Me/2000/XP</FONT></FONT></P>
37                </TD>
38                <TD WIDTH=20%>
39                        <P ALIGN=CENTER STYLE="margin-bottom: 0.05cm; border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
40                        <FONT COLOR="#66cc33"><FONT SIZE=1 STYLE="font-size: 8pt">Microsoft
41                        Visual C++ 6 SP3+<BR>Microsoft Visual C++.Net 2002</FONT></FONT></P>
42                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
43                        <FONT COLOR="#66cc33"><FONT SIZE=1 STYLE="font-size: 8pt">Microsoft
44                        Visual C++.Net 2003</FONT></FONT></P>
45                </TD>
46                <TD>
47                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
48                        <FONT SIZE=1 STYLE="font-size: 8pt"><FONT COLOR="#66cc33">DirectX
49                        8.1b SDK<BR>Due to STL problems with MS compilers if you are using
50                        VC6 or VC.Net 2002 you MUST install <A HREF="http://www.stlport.org/">STLport</A></FONT></FONT></P>
51                </TD>
52        </TR>
53        <TR>
54                <TD WIDTH=33%>
55                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
56                        <FONT COLOR="#66cc33"><FONT SIZE=1 STYLE="font-size: 8pt">Linux</FONT></FONT></P>
57                </TD>
58                <TD WIDTH=20%>
59                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
60                        <FONT SIZE=1 STYLE="font-size: 8pt"><FONT COLOR="#66cc33">gcc
61                        3.x<BR>gcc 2.9x with <A HREF="http://www.stlport.org/">STLport
62                        STLport</A></FONT></FONT></P>
63                </TD>
64                <TD>
65                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
66                        <FONT SIZE=1 STYLE="font-size: 8pt"><FONT COLOR="#66cc33">gcc 3.2
67                        highly recommended. See <A HREF="README.linux">Linux README</A></FONT></FONT></P>
68                </TD>
69        </TR>
70        <TR>
71                <TD WIDTH=33%>
72                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
73                        <FONT COLOR="#66cc33"><FONT SIZE=1 STYLE="font-size: 8pt">Mac OSX </FONT></FONT>
74                        </P>
75                </TD>
76                <TD WIDTH=20%>
77                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
78                        <FONT COLOR="#66cc33"><FONT SIZE=1 STYLE="font-size: 8pt">gcc 3.x</FONT></FONT></P>
79                </TD>
80                <TD>
81                        <P ALIGN=CENTER STYLE="border-top: none; border-bottom: 1.00pt solid #666600; border-left: 1.00pt solid #666600; border-right: 1.00pt solid #666600; padding-top: 0cm; padding-bottom: 0.26cm; padding-left: 0.05cm; padding-right: 0.05cm">
82                        <FONT SIZE=1 STYLE="font-size: 8pt"><FONT COLOR="#66cc33">See the
83                        <A HREF="README_MacOSX.txt">Mac README</A></FONT></FONT></P>
84                </TD>
85        </TR>
86</TABLE>
87<P CLASS="mainheader" ALIGN=LEFT>Q: When do I need STLport and why?</P>
88<P ALIGN=LEFT>You need STLport if you're running Microsoft Visual C++
89version 6 or .NET 2002, because the STL implementation in these
90versions of VC++ is very old, pretty slow and has a number of known
91bugs. If you are using Visual C++.Net 2003 or later you do not need
92STLport.</P>
93<P ALIGN=LEFT>You also need STLport if you're using gcc 2.9x because
94the STL included with this version is not ANSI compliant enough for
95OGRE. You don't need it if you have gcc v3.x because the STL in that
96version has been updated.
97</P>
98<P CLASS="mainheader" ALIGN=LEFT>Q: How do I install STLport?</P>
99<P>Approach #1 &ndash; build it yourself:</P>
100<P STYLE="margin-left: 0.82cm">Download the latest from
101<A HREF="http://www.stlport.org/">www.stlport.org</A> and unzip it
102somewhere
103</P>
104<UL>
105        <LI><P STYLE="margin-bottom: 0cm">Open a command prompt, and change
106        to the folder STLport-x.x.x\src
107        </P>
108</UL>
109<UL>
110        <LI><P>If you're using Visual C++ 6:
111        </P>
112</UL>
113<OL>
114        <LI><P STYLE="margin-bottom: 0cm">make sure you've run VCVARS32.BAT
115        from the MSVC6 folder, <B>in the same command prompt window</B></P>
116        <LI><P>type 'nmake -f vc6.mak clean all'
117        </P>
118</OL>
119<UL>
120        <LI><P>If you're using Visual C++.Net:
121        </P>
122</UL>
123<OL>
124        <LI><P STYLE="margin-bottom: 0cm">make sure you've run VSVARS32.BAT
125        from the MSVC .NET folder, <B>in the same command prompt window</B>
126        </P>
127        <LI><P>type 'nmake -f vc7.mak clean all'
128        </P>
129</OL>
130<UL>
131        <LI><P>If you're using gcc 2.9x:
132        </P>
133</UL>
134<OL>
135        <LI><P STYLE="margin-bottom: 0cm">type './configure'
136        </P>
137        <LI><P STYLE="margin-bottom: 0cm">type 'make'
138        </P>
139        <LI><P>type 'make install'
140        </P>
141</OL>
142<P>Approach #2 &ndash; download a prebuilt installer from the OGRE
143site</P>
144<UL>
145        <LI><P STYLE="margin-bottom: 0cm">Download the prebuilt STLport
146        installer from the OGRE downloads area</P>
147        <LI><P STYLE="margin-bottom: 0cm">Run the installer</P>
148</UL>
149<P STYLE="margin-left: 0.82cm; margin-bottom: 0cm"><BR>
150</P>
151<P>Whichever approach you take, you have to update your Visual C++
152paths afterwards:</P>
153<UL>
154        <LI><P STYLE="margin-bottom: 0cm">Open Microsoft Visual C++ and
155        select Tools | Options... from the menu bar to bring up the options
156        dialog
157        </P>
158</UL>
159<UL>
160        <LI><P STYLE="margin-bottom: 0cm">Go to the include folders list: in
161        VC6 this is on the 'Directories' tab, in VC++.Net it is under
162        Projects|VC++ Directories in the tree on the left
163        </P>
164</UL>
165<UL>
166        <LI><P STYLE="margin-bottom: 0cm">Insert the directory
167        &lt;path_to_STLport-x.x.x&gt;\stlport is at the TOP of your include
168        folders list. Crucially, it MUST be above all Microsoft include
169        folders.
170        </P>
171</UL>
172<UL>
173        <LI><P STYLE="margin-bottom: 0cm">Insert the directory
174        &lt;path_to_STLport-x.x.x&gt;\lib into your library folder list.
175        </P>
176</UL>
177<UL>
178        <LI><P>Close VC++ to save the settings
179        </P>
180</UL>
181<P CLASS="mainheader">Q: Why do I have problems compiling the
182DirectX-based source files in Microsoft Visual C++ 6?
183</P>
184<P CLASS="maincontent">Microsoft is phasing out support for Visual
185C++ 6. If you are using it, the latest DirectX 9 SDK which is
186supported by Microsoft is the Summer 2004 update; any version after
187than will NOT WORK with VC6. In addition, you must download the
188'Extras' package and install that too, otherwise you will receive
189'security_cookie' link errors.</P>
190<P CLASS="maincontent"><A HREF="http://msdn.microsoft.com/directx">Microsoft's
191DirectX page</A>.
192</P>
193<P CLASS="mainheader">Q: What is the 'Dependencies' folder for?
194</P>
195<P CLASS="maincontent">Ogre depends on a number of external libraries
196such as jpeglib, libpng, zlib, and SDL. Rather than expect people to
197have these already or download them separately, and to minimise
198problems with incompatible versions of these libraries, you can
199download them from the OGRE downloads area (get the '3rd party
200libraries' download for your compiler). You only need this if you are
201using Microsoft Visual C++ because Linux distributions usually come
202with these libraries built in (just in case yours doesn't, use
203<A HREF="http://rpmfind.net/">RPMfind</A>).</P>
204<P CLASS="mainheader">Q: Why do I get a message like 'unable to open
205zlib.h' or some other header file?</P>
206<P>If you're using VC++, make sure you've downloaded the 3rd-party
207libraries distribution from the OGRE download area. This archive
208should be extracted into the 'ogrenew' folder.</P>
209<P CLASS="mainheader">Q: When I try to debug a sample or my own
210application, I get an error saying plugins.cfg is not found, why?</P>
211<P>The relative location of OGRE library files and configuration
212files are very important for successfully starting an OGRE
213application, in debug mode or otherwise. The existing samples
214provided copy their executables into 'Samples\Common\bin\Debug' or
215'Samples\Common\bin\Release', where all the other files are placed
216correctly. It is recommended that you set up your own examples to
217place their executables in the same location to avoid problems, and
218debug them from there too.
219</P>
220<P>If you do want to move the files, bear in mind the following
221dependencies:
222</P>
223<UL>
224        <LI><P STYLE="margin-bottom: 0cm">The OgreMain and OgrePlatform
225        libraries must be in the same folder as the executable, or on the
226        path
227        </P>
228        <LI><P STYLE="margin-bottom: 0cm">The plugins.cfg file must be in
229        the same folder as the executable
230        </P>
231        <LI><P>The plugin libraries listed in plugins.cfg must be located in
232        the folder specified in the 'PluginFolder' setting in plugins.cfg
233        </P>
234</UL>
235<P CLASS="mainheader">Q: I have problems loading some resource files
236(textures, meshes, material definitions etc)</P>
237<P>Check the following:</P>
238<OL>
239        <LI><P STYLE="margin-bottom: 0cm">Make sure the case of the
240        filenames is correct. Some operating systems are case-sensitive in
241        their file operations, and all of OGRE's internal lookups for
242        reusing resources is case-sensitive so assume that case IS
243        important.
244        </P>
245        <LI><P STYLE="margin-bottom: 0cm">Make sure the location of the
246        resource is on the resource path. You can add resource paths by
247        calling Root::addResourceLocation and supplying either a folder or a
248        ZIP compressed archive to search in
249        </P>
250        <LI><P>If you're trying to use a material or particle system
251        scripted from a .material or .particle file, ensure that you call
252        ResourceGroupManager::initialiseAllResourceGroups
253        </P>
254</OL>
255<P CLASS="mainheader">Q: What is the minimum set of resource files I
256need to run my own OGRE application?</P>
257<P>If you wish to use the OGRE debug panel or the profiler, you need
258to have the OgreCore.zip package on your resource path.</P>
259<P CLASS="mainheader">Q: After I did a CVS update, no matter what
260demo/app I try to run, I get thrown in the debugger because of what
261appears to be memory over-runs/allocation problems.</P>
262<P>This is because there have been major changes in the core OGRE
263library, changes that affect all the other linked plug-ins/apps. The
264solution is simple (though a bit slow): a full rebuild of all the
265OGRE sources.
266</P>
267<P CLASS="mainheader">Q: Why do I get errors about 'LPDIRECTINPUT8' :
268missing storage-class or type specifiers?</P>
269<P>This is caused by either not having the DirectX SDK, or having the
270include folder for it lower down on your include list than an oder
271version of the Windows platform SDK or the Visual C++ include
272folders. Make sure your DirectX SDK includes are above VC / Platform
273SDK but still below STLport.</P>
274<P><BR><BR>
275</P>
276</BODY>
277</HTML>
Note: See TracBrowser for help on using the repository browser.