Open-source replacements for the jaggl, jaggl_dri and jagmisc native libraries
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
openrs2-natives/gl-natives/README.md

46 lines
1.8 KiB

5 years ago
# OpenRS2 GL Natives
## Known bugs
### macOS performance
OpenJDK's `nativeGetTopmostPlatformWindowUnderMouse` function is very slow on
macOS. On lower-end hardware, such as a 2011 Mac Mini, the rendering loop
completely freezes whenever the mouse moves. More information is available in
the [JetBrains Runtime issuer tracker][macos-perf].
The performance is significantly better if the [JetBrains Runtime][jbr] is used
instead of OpenJDK.
### macOS lighting quality
The lighting quality is very poor on a Mac Mini with an integrated Intel HD
Graphics 3000 card: some polygons are far too dark, and they tend to flicker
between bright and dark as the camera angle changes, instead of transitioning
smoothly.
I'm not yet sure if this is a bug specific to macOS, the Intel HD Graphics 3000
drivers or the card itself. I don't believe it is the reimplemented
bindings - the same problem happens with the original jaggl bindings and build
667 of the client. I also think it is unlikely to be the client, as the same
client code works on Windows and Linux.
5 years ago
## Copyright
Copyright (c) 2019 OpenRS2 Authors
OpenRS2 GL Natives is free software: you can redistribute it and/or modify it
under the terms of version 3.0 of the GNU Lesser General Public License as
5 years ago
published by the Free Software Foundation.
OpenRS2 GL Natives is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for
more details.
You should have received a copy of the GNU Lesser General Public License along
with OpenRS2 GL Natives. If not, see <https://www.gnu.org/licenses/>.
[macos-perf]: https://youtrack.jetbrains.com/issue/JBR-444
[jbr]: https://confluence.jetbrains.com/display/JBR/JetBrains+Runtime