974deca5e1
git-svn-id: svn+ssh://svn.code.sf.net/p/supertuxkart/code/main/trunk@11846 178a84e3-b1eb-0310-8ba1-8eac791a3b58
236 lines
11 KiB
Plaintext
236 lines
11 KiB
Plaintext
==========================================================================
|
||
The Irrlicht Engine SDK version 1.8
|
||
==========================================================================
|
||
|
||
Welcome the Irrlicht Engine SDK.
|
||
|
||
Content of this file:
|
||
|
||
1. Directory Structure Overview
|
||
2. How To Start
|
||
3. Requirements
|
||
4. Release Notes
|
||
5. License
|
||
6. Contact
|
||
|
||
|
||
==========================================================================
|
||
1. Directory Structure Overview
|
||
==========================================================================
|
||
|
||
You will find some directories after uncompressing the archive of the
|
||
SDK. These are:
|
||
|
||
\bin The compiled library Irrlicht.DLL and some compiled demo
|
||
and example applications, just start them to see the
|
||
Irrlicht Engine in action. Windows only.
|
||
\doc Documentation of the Irrlicht Engine.
|
||
\examples Examples and tutorials showing how to use the engine with
|
||
C++.
|
||
\include Header files to include when programming with the engine.
|
||
\lib Libs to link with your programs when using the engine.
|
||
\media Graphics and sound resources for the demo applications and
|
||
examples.
|
||
\source The source code of the Irrlicht Engine. This code is
|
||
not needed to develop applications with the engine,
|
||
but it is included to enable recompilation and
|
||
debugging, if necessary.
|
||
\tools Useful tools (with sourcecode) for the engine.
|
||
|
||
|
||
|
||
==========================================================================
|
||
2. How to start
|
||
==========================================================================
|
||
|
||
To see the engine in action in Windows, just go to the \bin\Win32-VisualStudio
|
||
directory, and start some applications. There should also be an
|
||
application named Demo.exe which should show the most
|
||
interesting features of Irrlicht.
|
||
|
||
To start developing own applications and games with the engine take
|
||
a look at the 01.HelloWorld example in the \examples directory.
|
||
There is also a .html file with a tutorial which should be
|
||
easily comprehensible.
|
||
|
||
The Irrlicht Engine is a static lib under linux. A precompiled version can be
|
||
generated from the sources using the Makefile in source/Irrlicht. Unzip the
|
||
file source.zip in the /source directory. Run 'make' in the newly created
|
||
subfolder source/Irrlicht. After this you should be able to 'make' all
|
||
example applications in /examples. You can run the examples directly from the
|
||
directory they are created in.
|
||
|
||
It is also possible to use Irrlicht as shared object
|
||
(libIrrlicht.so.versionNumber). Use the proper makefile target for this by
|
||
running 'make sharedlib' in the source folder. See the Makefile for details.
|
||
|
||
For OSX you can find an XCode project file in source/Irrlicht/MacOSX. This will
|
||
build the libIrrlicht.a library necessary to create the apps.
|
||
|
||
==========================================================================
|
||
3. Requirements
|
||
==========================================================================
|
||
|
||
You can use one of the following compilers/IDEs to develop applications
|
||
with Irrlicht or recompile the engine. However, other compilers/IDEs may
|
||
work as well, we simply didn't test them.
|
||
|
||
* gcc 3.3
|
||
* gcc 3.4
|
||
* gcc 4.x
|
||
* Visual Studio.NET 2003 (7.1)
|
||
* Visual Studio 2005(8.0)-2010(10.0)
|
||
* Code::Blocks 1.0 (& gcc or visual studio toolkit)
|
||
* DevC++ 5.0 & gcc (project files included, please use Code::Blocks instead)
|
||
|
||
If you ever want to (re)compile the engine yourself (which means you don't
|
||
want to use the precompiled version) you need the following:
|
||
|
||
* Windows:
|
||
* Needed: PlatformSDK (which usually comes with all IDEs, download
|
||
it separately for MSVC Express 2005)
|
||
* Optional: DirectX SDK, for D3D9 support
|
||
* Optional: DirectX SDK prior to May 2006, for D3D8 support
|
||
|
||
* Linux:
|
||
* Needed: XServer with include files
|
||
* Optional: OpenGL headers and libraries (libGL.so) for OpenGL support
|
||
GLX +
|
||
XF86VidMode [package x11proto-xf86vidmode-dev] or XRandr
|
||
(X11 support libraries, the latter two for fullscreen mode)
|
||
|
||
* OSX:
|
||
* Needed: XCode and Cocoa framework
|
||
* Needed: OpenGL headers and libraries
|
||
|
||
==========================================================================
|
||
4. Release Notes
|
||
==========================================================================
|
||
|
||
Informations about changes in this new version of the engine can be
|
||
found in changes.txt.
|
||
|
||
Please note that the textures, 3D models and levels are copyright
|
||
by their authors and not covered by the Irrlicht engine license.
|
||
|
||
==========================================================================
|
||
5. License
|
||
==========================================================================
|
||
|
||
The license of the Irrlicht Engine is based on the zlib/libpng license.
|
||
Even though this license does not require you to mention that you are
|
||
using the Irrlicht Engine in your product, an acknowledgement
|
||
would be highly appreciated.
|
||
|
||
Please note that the Irrlicht Engine is based in part on the work of
|
||
the Independent JPEG Group, the zlib, and libpng. This means that if you use
|
||
the Irrlicht Engine in your product, you must acknowledge somewhere
|
||
in your documentation that you've used the IJG code and libpng. It would
|
||
also be nice to mention that you use the Irrlicht Engine and the zlib.
|
||
See the README files in the jpeglib and the zlib for
|
||
further informations.
|
||
|
||
|
||
The Irrlicht Engine License
|
||
===========================
|
||
|
||
Copyright (C) 2002-2012 Nikolaus Gebhardt
|
||
|
||
This software is provided 'as-is', without any express or implied
|
||
warranty. In no event will the authors be held liable for any damages
|
||
arising from the use of this software.
|
||
|
||
Permission is granted to anyone to use this software for any purpose,
|
||
including commercial applications, and to alter it and redistribute it
|
||
freely, subject to the following restrictions:
|
||
|
||
1. The origin of this software must not be misrepresented; you must not
|
||
claim that you wrote the original software. If you use this software
|
||
in a product, an acknowledgement in the product documentation would be
|
||
appreciated but is not required.
|
||
2. Altered source versions must be clearly marked as such, and must not be
|
||
misrepresented as being the original software.
|
||
3. This notice may not be removed or altered from any source distribution.
|
||
|
||
|
||
==========================================================================
|
||
6. Contact
|
||
==========================================================================
|
||
|
||
If you have problems, questions or suggestions, please visit the
|
||
official homepage of the Irrlicht Engine:
|
||
|
||
http://irrlicht.sourceforge.net
|
||
|
||
You will find forums, bugtrackers, patches, tutorials, and other stuff
|
||
which will help you out.
|
||
|
||
If want to contact the team of the engine, please send an email to
|
||
Nikolaus Gebhardt:
|
||
|
||
irrlicht@users.sourceforge.net
|
||
|
||
Please also not that parts of the engine have been written or contributed
|
||
by other people. Especially: (There are probably more people, sorry if I forgot one.
|
||
See http://irrlicht.sourceforge.net/author.html for more informations)
|
||
|
||
Christian Stehno (hybrid) Contribution Coordinator/Developer
|
||
Gareth Davidson (bitplane) Developer/ Forum admin
|
||
Thomas Alten (burningwater) Wrote the burningsvideo software rasterizer
|
||
Luke P. Hoschke (luke) Wrote the b3d loader, the new animation system, VBOs and other things
|
||
Colin MacDonald (rogerborg) All hands person
|
||
Michael Zeilfelder (cutealien) GUI and patch expert
|
||
Ahmed Hilali (blindside) The shader and advanced effects man
|
||
Dean Wadsworth (varmint) OSX port maintainer and game developer
|
||
Alvaro F. Celis (afecelis) Lots of work in the community, for example video tutorials about Irrlicht, forum admin
|
||
John Goewert (Saigumi) Wrote some tutorials for the Irrlicht Engine and doing admin stuff
|
||
Jam Takes care of moderating the forums and keeps them clean from those evil spammers.
|
||
|
||
Etienne Petitjean wrote the MacPort of the engine
|
||
Mark Jeacocke Wrote lots of helpful comments and ideas in the forums and per email.
|
||
Julio Gorg<72> Created the 'Unofficial DirectX 9.0 Driver for the Irrlicht Engine'
|
||
Andy Spurgeon Wrote the Dev-Cpp tutorial.
|
||
Andr<64> Simon Wrote the Codewarrior tutorial.
|
||
KnightToFlight Created the unoffical terrain renderer addon for the Irrlicht Engine.
|
||
Jon Pry Wrote the code to load compressed TGA files.
|
||
Matthew Couch Wrote the tokamak integration tutorial.
|
||
Max Winkel Wrote the splitscreen tutorial.
|
||
Gorgon Zola Wrote the ODE integration tutorial.
|
||
Dean P. Macri Sent in code for curved surfaces and PCX Loading.
|
||
Sirshane Made several bug fixes, sent in code for making the mouse cursor invisible in Linux.
|
||
Matthias Gall Sent in code for a spline scene node animator and reported lots of bugs.
|
||
Mario Gruber Suggested triangle fan drawing and sent in code for this.
|
||
Ariaci Spotted out a bug in the ATI driver.
|
||
Dr Andros C Bragianos Improved texture mapping in cube scene node.
|
||
Philipp Dortmann Sent in code for stencil buffer support for OpenGL.
|
||
Jerome Nichols Created the Irrlicht/Ruby interface located at irr.rubyforge.org
|
||
Vash TheStampede Sent code for missing Draw2DLine() implementations
|
||
MattyBoy XBOX support suggestions
|
||
Oliver Klems createImageFromData() method suggestion/implementation
|
||
Jox really, really a lot of bug fixes, and the LMTS file loader
|
||
Zola Quaternion method additions
|
||
Tomasz Nowakowski various bug fixes
|
||
Nicholas Bray stencil shadow bug fixes with OpenGL
|
||
REAPER mouswheel events for scrollbar
|
||
Calimero various bug fixes like vector2d operators
|
||
Haddock bugfix in the linked list
|
||
G.o.D XML parser fix
|
||
Erik Zilli Translated some of the tutorials from my stuttering english into real english. :)
|
||
Martin Piskernig Linux bugfixing and testing
|
||
Soconne Wrote the original terrain renderer were Irrlichts terrain renderer of Irrlicht is based on it.
|
||
Spintz GeoMipMap scene node, terrain renderer of Irrlicht is based on it.
|
||
Murphy McCauley OCT file loader, MIM tools
|
||
Saurav Mohapatra IrrCSM, and lots of addons, suggestions and bug reports
|
||
Zhuck Dimitry My3D Tools
|
||
Terry Welsh Allowed me to use the textures of his 'Parallax Mapping with Offset Limiting' paper for the parallax demo of Irrlicht
|
||
rt Wrote the original .png loader for Irrlicht
|
||
Salvatore Russo Wrote the original .dmf loader for Irrlicht
|
||
Vox Various bug reports and fixes
|
||
atomice Contributed code for a ms3d loader enhancement
|
||
William Finlayson OpenGL RTT, GLSL support and the reflection 2 layer material for OpenGL.
|
||
Delight Various code contributions for Irrlicht.NET (particle system, basic shader support and more)
|
||
Michael Zoech Improved GLSL support
|
||
Greg Roelofs Created the zlib and libpng
|
||
Guy Eric Schalnat, Andreas Dilger, Glenn Randers-Pehrson and others Created libpng
|
||
The Independent JPEG Group Created JPEG lib
|