2024-03-21 20:13:15 +01:00
|
|
|
IrrlichtMt version 1.9
|
|
|
|
|
======================
|
|
|
|
|
|
|
|
|
|
IrrlichtMt is the 3D engine of [Minetest](https://github.com/minetest).
|
|
|
|
|
It is based on the [Irrlicht Engine](https://irrlicht.sourceforge.io/) but is now developed independently.
|
|
|
|
|
It is intentionally not compatible to upstream and is planned to be eventually absorbed into Minetest.
|
|
|
|
|
|
|
|
|
|
Build
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
The build system is CMake.
|
|
|
|
|
|
|
|
|
|
The following libraries are required to be installed:
|
|
|
|
|
* zlib, libPNG, libJPEG
|
|
|
|
|
* OpenGL
|
|
|
|
|
* or on mobile: OpenGL ES (can be optionally enabled on desktop too)
|
|
|
|
|
* on Unix: X11
|
|
|
|
|
* SDL2 (see below)
|
|
|
|
|
|
|
|
|
|
Aside from standard search options (`ZLIB_INCLUDE_DIR`, `ZLIB_LIBRARY`, ...) the following options are available:
|
|
|
|
|
* `ENABLE_OPENGL` - Enable OpenGL driver
|
|
|
|
|
* `ENABLE_OPENGL3` (default: `OFF`) - Enable OpenGL 3+ driver
|
|
|
|
|
* `ENABLE_GLES2` - Enable OpenGL ES 2+ driver
|
2024-11-10 20:22:02 +01:00
|
|
|
* `USE_SDL2` (default: platform-dependent, usually `ON`) - Use SDL2 instead of older native device code
|
2024-03-21 20:13:15 +01:00
|
|
|
|
2024-04-06 12:53:24 +02:00
|
|
|
However, IrrlichtMt cannot be built or installed separately.
|
2024-08-16 11:53:31 +02:00
|
|
|
|
2024-03-21 20:13:15 +01:00
|
|
|
Platforms
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
We aim to support these platforms:
|
|
|
|
|
* Windows via MinGW
|
|
|
|
|
* Linux (GL or GLES)
|
|
|
|
|
* macOS
|
|
|
|
|
* Android
|
|
|
|
|
|
|
|
|
|
This doesn't mean other platforms don't work or won't be supported, if you find something that doesn't work contributions are welcome.
|
|
|
|
|
|
2024-11-03 08:20:51 +01:00
|
|
|
Compatibility matrix
|
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
|
|
Driver (rows) vs Device (columns)
|
|
|
|
|
|
|
|
|
|
| | SDL [1] | Linux [2] | OSX [3] | Win32 [4] |
|
|
|
|
|
|---------------------------|----------|----------------|------------------|-----------------|
|
|
|
|
|
| OpenGL 1.2 (to 2.1) | Works | Works (GLX) | Works (NSOpenGL) | Works (WGL) |
|
|
|
|
|
| OpenGL 3.2+ | Works | Testing (GLX) | Not implemented | Testing (WGL) |
|
|
|
|
|
| OpenGL ES 2.x | Works | Untested (EGL) | Not implemented | Untested (EGL) |
|
|
|
|
|
| WebGL 1 | Untested | Untested (EGL) | Not implemented | Not implemented |
|
|
|
|
|
| Null (no graphics output) | Works | Works | Works | Works |
|
|
|
|
|
|
|
|
|
|
Notes:
|
|
|
|
|
|
|
|
|
|
* [1] `CIrrDeviceSDL`: supports Android, Linux, macOS, Windows
|
|
|
|
|
* [2] `CIrrDeviceLinux`: supports Linux
|
|
|
|
|
* [3] `CIrrDeviceOSX`: supports macOS
|
|
|
|
|
* [4] `CIrrDeviceWin32`: supports Windows
|
|
|
|
|
|
|
|
|
|
|
2024-03-21 20:13:15 +01:00
|
|
|
License
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
The license of the Irrlicht Engine is based on the zlib/libpng license and applies to this fork, too.
|
|
|
|
|
|
|
|
|
|
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.
|
