192 lines
8.0 KiB
Plaintext
192 lines
8.0 KiB
Plaintext
==========================================================================
|
||
The irrKlang SDK version 1.6
|
||
==========================================================================
|
||
|
||
Welcome the irrKlang SDK.
|
||
|
||
Content of this file:
|
||
|
||
1. Directory structure overview
|
||
2. How to start
|
||
3. Release Notes
|
||
4. .NET version dependencies
|
||
5. License
|
||
6. Contact
|
||
|
||
|
||
|
||
==========================================================================
|
||
1. Directory structure overview
|
||
==========================================================================
|
||
|
||
You will find some directories after decompressing the archive in which
|
||
came the SDK. These are:
|
||
|
||
\bin The compiled library irrKlang.DLL and some compiled demo
|
||
and example applications, just start them to see
|
||
irrKlang in action.
|
||
\doc Documentation of the Irrlicht Engine.
|
||
\examples Examples and tutorials showing how to use the native engine
|
||
engine using C++.
|
||
\example.net Examples written for the .NET version of irrKlang, in C# and
|
||
VisualBasic.NET
|
||
\include Header files to include when using the engine.
|
||
\lib Lib to link with your programs when using the engine.
|
||
\media Sound data for the demo applications and
|
||
examples.
|
||
\plugins Source and documentation of the irrKlang plugins.
|
||
|
||
|
||
==========================================================================
|
||
2. How to start
|
||
==========================================================================
|
||
|
||
To see the engine in action in Windows, just go to the \bin\Win32
|
||
directories, and start some applications.
|
||
|
||
To start developing own applications and games with the engine take
|
||
a look at the 01.HelloWorld example in the \examples directory.
|
||
|
||
Windows Users:
|
||
There are Visual Studio as well as CodeBlocks projects for the examples.
|
||
|
||
Linux users:
|
||
Just go into the /examples directory and run 'make' for every
|
||
example you want to try out. You can run the examples directly from the
|
||
directory they are created in. Some examples may print some special
|
||
hints after a successful make and might help you starting them up
|
||
by typing in 'make run'.
|
||
|
||
Mac users:
|
||
There is a XCode project for each example available in
|
||
the corresponding example directory. To run the precompiled example
|
||
applications from bin\macos-gcc, doubleclick the run_0x_xxxxx.command
|
||
files from the finder (this will change the working directory to
|
||
bin\macos-gcc) or start them directly from a terminal.
|
||
|
||
==========================================================================
|
||
3. Release Notes
|
||
==========================================================================
|
||
|
||
Informations about changes in this new version of the engine can be
|
||
found in changes.txt.
|
||
|
||
Please note that the included sound files are copyright
|
||
by their authors and not included in the irrKlang engine license.
|
||
|
||
|
||
==========================================================================
|
||
4. .NET version dependencies
|
||
==========================================================================
|
||
|
||
There are four versions of irrKlang.NET available. They have the same
|
||
functionality and can be used from the same .NET projects.
|
||
The difference are only their dependencies and target platforms:
|
||
|
||
irrKlang.NET2.0 in bin\dotnet-2.0:
|
||
Compiled for .NET common language runtime version 2.0, depends on
|
||
the modudles MSVCR80.DLL and MSVCM80.DLL. (32 bit)
|
||
One method to redistribute these is using the visual studio 2005
|
||
redistributeable (vcredist_x86)
|
||
|
||
irrKlang.NET4 in bin\dotnet-4:
|
||
Compiled for .NET common language runtime version 4.5, depends on
|
||
VCRUNTIME140.dll. (32 bit)
|
||
One method to redistribute this is using the visual studio 2017
|
||
redistributeable (vcredist_x86)
|
||
|
||
irrKlang.NET4 in bin\dotnet-4-64: (only in the 64 bit irrKlang SDK)
|
||
64 bit version, Compiled for .NET common language runtime version 4.5,
|
||
depends on VCRUNTIME140.dll. (64 bit)
|
||
One method to redistribute this is using the visual studio 2017
|
||
redistributeable (vcredist 64 bit)
|
||
|
||
==========================================================================
|
||
5. License
|
||
==========================================================================
|
||
|
||
irrKlang's source codes, documentation and binaries contained within the
|
||
distributed archive are copyright <20> Nikolaus Gebhardt / Ambiera 2001-2018.
|
||
|
||
The contents of the irrKlang distribution archive may not be redistributed,
|
||
reproduced, modified, transmitted, broadcast, published or adapted in any
|
||
way, shape or form, without the prior written consent of the owner,
|
||
Nikolaus Gebhardt.
|
||
|
||
The irrKlang.dll, irrKlang.so and libirrklang.dylib files may be
|
||
redistributed without the authors prior permission in non-commercial
|
||
products, and must remain unmodified except for compressing the file.
|
||
|
||
For the included plugins which can be found in the \plugins
|
||
directory, different licenses may be applied, as specified in the
|
||
actual plugin directory.
|
||
|
||
|
||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||
''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
||
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
|
||
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
||
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
||
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
||
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
||
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
||
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
||
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||
|
||
--------------------------------------------------------------------------------
|
||
irrKlang may include Xiph.org Foundation code (Ogg Vorbis and FLAC).
|
||
It's license is the following:
|
||
|
||
Copyright (c) 2002, Xiph.org Foundation
|
||
|
||
Redistribution and use in source and binary forms, with or without
|
||
modification, are permitted provided that the following conditions
|
||
are met:
|
||
|
||
- Redistributions of source code must retain the above copyright
|
||
notice, this list of conditions and the following disclaimer.
|
||
|
||
- Redistributions in binary form must reproduce the above copyright
|
||
notice, this list of conditions and the following disclaimer in the
|
||
documentation and/or other materials provided with the distribution.
|
||
|
||
- Neither the name of the Xiph.org Foundation nor the names of its
|
||
contributors may be used to endorse or promote products derived from
|
||
this software without specific prior written permission.
|
||
|
||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
||
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION
|
||
OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
||
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
||
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
||
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
||
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||
|
||
--------------------------------------------------------------------------------
|
||
irrKlang may include code from the
|
||
Dynamic Universal Music Bibliotheque, Version 0.9.3
|
||
|
||
Copyright (C) 2001-2005 Ben Davis, Robert J Ohannessian and Julien Cugniere
|
||
|
||
==========================================================================
|
||
6. Contact
|
||
==========================================================================
|
||
|
||
If you have problems, questions or suggestions, please visit the
|
||
official homepage of the irrKlang Engine:
|
||
|
||
http://www.ambiera.com/irrklang
|
||
|
||
You will find forums, bugtrackers, patches, tutorials, and other stuff
|
||
which will help you out.
|
||
|
||
If want to contact the author of the engine, please send an email to
|
||
Nikolaus Gebhardt:
|
||
|
||
office@ambiera.com
|