-
Notifications
You must be signed in to change notification settings - Fork 16
Update RENDERERS.md #17
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: dev
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,35 +1,38 @@ | ||
| # Renderers <!-- TODO: Add mobileglues --> | ||
| # Renderers | ||
| Minecraft runs on OpenGL, and mobile devices generally only support OpenGL ES (GLES). And since Minecraft won't run on GLES, we have to use renderers as compatibility layers between OpenGL ES and OpenGL. | ||
| > All of the following renderers were tested using the same environment; Minecraft 1.21.1 with Optifine, 8 chunks, running on a Snapdragon 778g at 80% resolution scale, with Fast graphics and smooth lighting. | ||
| > All of the following renderers were tested using the same environment; Minecraft 1.21.4 with Optifine, 8 chunks, running on a Snapdragon 888 at 100% resolution scale, with Fast graphics and smooth lighting. | ||
|
|
||
| ## Holy GL4ES | ||
| - Optimized for performance, Holy GL4ES is the default renderer in PojavLauncher and should be used in almost all scenrarios. | ||
| - Supports OpenGL 2.1 and has shader converting capabilities, thus makes up for about 1/8 of the OpenGL 3.x standard. | ||
| - Works on all versions of vanilla Minecraft. | ||
| ### A screenshot of Holy GL4ES running Minecraft 1.21.1 | ||
|  | ||
| - Only works on Minecraft 1.21.4 and below | ||
| ### A screenshot of Holy GL4ES running Minecraft 1.21.4 | ||
|  | ||
|
|
||
| > ## ANGLE | ||
| > - Slower than Holy GL4ES(*), runs on Vulkan. Should be used only in specific cases, where a server resource pack or a mod fails to run due to missing OpenGL extensions. | ||
| > - Supports OpenGL 3.2 only. | ||
| > - Only works on Minecraft 1.17+ | ||
| > On iOS devices, ANGLE can provide faster performance than Holy GL4ES. | ||
| ## MobileGlues | ||
| - Fast. Supports shaders and mods that cannot run with GL4ES. | ||
| - Supports OpenGL 4.0. | ||
| - In video and renderer settings, there's an "Extra Renderer" option where you can change MobileGlues's configurations (eg. Enable ANGLE as ES driver for better performance) | ||
|
|
||
| ::: warning SIDE NOTE | ||
| As of Galdiolus release, ANGLE renderer has been removed/replaced with LTW, We highly recommend you to use LTW instead. This marks ANGLE as now iOS exclusive. | ||
| ::: | ||
|
|
||
| ### A screenshot of ANGLE running Minecraft 1.21.1 | ||
| .jpg) | ||
| ### A screenshot of MobileGlues running Minecraft 1.21.4 | ||
|
|
||
| ## MobileGlues + ANGLE as GLES driver | ||
|  | ||
| ## MobileGlues without ANGLE (native) | ||
|  | ||
|
|
||
| ## Zink | ||
| - Mid. It's only useful for mods that don't run due to missing OpenGL extensions and for running shaders. | ||
| - Supports OpenGL 4.5 on Adreno GPUs with Turnip, and OpenGL 3.1/3.2(*) on Mali GPUs. Adreno GPUs without Turnip | ||
| - Mid/Slow(*). It's only useful for mods that don't run due to missing OpenGL extensions and for running shaders. | ||
| - Supports OpenGL 4.5 on Adreno GPUs with Turnip, OpenGL 2.1 on some PowerVR GPUs, and OpenGL 3.1/3.2(*) on Mali GPUs. Adreno GPUs without Turnip | ||
| **will** face crashes when using Zink. | ||
| - Works on all vanilla versions of Minecraft. | ||
|
|
||
| > On the current version of PojavLauncher, Mali with Vulkan 1.1 or some Vulkan 1.3 driver (need more testers with Mali Vulkan 1.3 devices). cannot run Minecraft 1.16.5 and below with Zink due to Mali driver issue with Mesa 23.2.0-devel (MESA_GL_VERSION_OVERRIDE=<api version> (See https://wiki.angelauramc.dev/wiki/faq/android/ZINKNOTWORKING.html). will not fix this issue) | ||
| > (*) Most Mali GPUs can only run OpenGL 3.1 | ||
| > Zink can be run with Xclipse GPU and supports up to OpenGL 4.6. However, there are some graphical issues (vertex explosion). No fix for now. | ||
|
|
||
| > (*) Zink's performance is depends on your device. Though, it could be fast on some scenarios. (eg. decreasing resolution improve zink performance) | ||
|
|
||
| > (*) Most Mali GPUs can only run OpenGL 3.1. Notes that 1.17+ might crash on Mali GPU because 1.17+ does not support OpenGL 3.1- anymore. To fix, you must create a custom_env.txt and put "MESA_GL_VERSION_OVERRIDE=<x.x>" enviroment variables into custom_env.txt that you just created. (Join our discord server for further supports about this) | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. probably leave this out, I didn't know this was actual behavior. I will export this in the launcher itself in a future commit
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. you could also leave it in, no harm no foul anyway when i fix it |
||
|
|
||
| ### A screenshot of Zink running Minecraft 1.21.1 | ||
|  | ||
| ### A screenshot of Zink running Minecraft 1.21.4 | ||
|  | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We are NOT using discord CDN as an image host FOR A STATIC WEBSITE