Mirrorlandia_minetest/minetest
1
0
Fork 1
mirror of https://github.com/minetest/minetest.git synced 2024-11-27 01:53:45 +01:00
Code Issues Packages Projects Releases Wiki Activity
7295b6c88c
minetest/irr
History
HybridDog 7295b6c88c
Remove unused and rarely used irrlicht color functions (#15442) 
SColor.h contains many functions which are unused and/or perform linear
operations on non-linear 8 bit sRGB color values, such as the plus operator and
`SColor::getInterpolated()`, and there is no documentation about missing gamma
correction.
Some of these functions are not called or called only once:
* `getAverage(s16 color)`: Unused
* `SColor::getLightness()`: Unused
* `SColor::getAverage()`: Claims to determine a color's average intensity but
  calculates something significantly different since SColor represents
  non-linear sRGB values.
* `SColor::getInterpolated_quadratic()`: Claims to interpolate between colors
  but uses the sRGB color space, which is neither physically nor perceptually
  linear.
* `SColorf::getInterpolated_quadratic()`: Unused
* `SColorf::setColorComponentValue()`: Unused

Removing or inlining these functions can simplify the code and documenting
gamma-incorrect operations can reduce confusion about what the functions do.

This commit does the following:
* Remove the above-mentioned unused functions
* Inline `SColor::getAverage()` into
  `CIrrDeviceLinux::TextureToMonochromeCursor()`
* Rename `SColor::getLuminance()` into `SColor::getBrightness()` since it does
  not determine a color's luminance but calculates something which differs
  significantly from physical luminance since SColor represents non-linear sRGB
  values.
* Inline `SColor::getInterpolated_quadratic()` into `GameUI::update()`,
  where it is only used for the alpha value calculation for fading
* Document gamma-incorrect behaviour in docstrings
2024-11-18 00:02:53 +01:00
..
cmake Copy irrlichtmt to <root>/irr/ 2024-03-26 21:39:02 +01:00
include Remove unused and rarely used irrlicht color functions (#15442) 2024-11-18 00:02:53 +01:00
scripts Cleanup headers in irr/include/ (#15181) 2024-10-18 10:58:32 +02:00
src Remove unused and rarely used irrlicht color functions (#15442) 2024-11-18 00:02:53 +01:00
.editorconfig Copy irrlichtmt to <root>/irr/ 2024-03-26 21:39:02 +01:00
.gitignore Copy irrlichtmt to <root>/irr/ 2024-03-26 21:39:02 +01:00
CMakeLists.txt [no sq] Move shaders & remove dead Irrlicht tests (#15006) 2024-08-19 09:17:52 +02:00
LICENSE Copy irrlichtmt to <root>/irr/ 2024-03-26 21:39:02 +01:00
README.md IrrlichtMt: Document Driver/Device compatibility 2024-11-15 12:18:48 +01:00

README.md

IrrlichtMt version 1.9

IrrlichtMt is the 3D engine of Minetest. It is based on the Irrlicht Engine 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
  • USE_SDL2 (default: platform-dependent, usually ON) - Use SDL2 instead of older native device code

However, IrrlichtMt cannot be built or installed separately.

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.

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

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.