OpenGLRenderer 配置

本文档介绍了以充分利用硬件为目标的性能调校。

OpenGLRenderer (libhwui) 属性

本文档将列出您可以用来控制 Android 的 2D 硬件加速渲染管道的所有属性。将 device.mk 中的这些属性设置为 PRODUCT_PROPERTY_OVERRIDES

适用于所有 Android 版本的属性

属性 类型 默认值 说明
ro.zygote.disable_gl_preload boolean false 用于在启动时启用/停用 Zygote 中的 EGL/GL 驱动程序预加载。当此属性设为 false 时,Zygote 将通过调用 eglGetDisplay(EGL_DEFAULT_DISPLAY) 预加载 GL 驱动程序。 目标是加载 Zygote 中的动态库代码,以便与所有其他进程共享。如果驱动程序不支持共享,则将此属性设为 true。

适用于 Android 8.0 及更低版本的属性

属性 类型 默认值 说明
ro.hwui.disable_scissor_opt boolean false

用于启用或停用剪刀优化。接受的值为 true 和 false。如果启用剪刀优化,则 OpenGLRenderer 会尝试选择性启用和停用 GL 剪刀测试,以尽可能不使用剪刀。

如果停用优化,则 OpenGLRenderer 会让 GL 剪刀测试保持启用状态,并根据需要更改剪刀矩形。当剪刀矩形的更改频率超过启用或停用剪刀测试的频率时,某些 GPU(例如 SGX 540)的性能会更好。

ro.hwui.texture_cache_size float 24 定义每个进程纹理缓存的大小(以兆字节为单位)。我们建议使用大容量的缓存,以足够容纳多个 32 位纹理的屏幕(例如,在 1280x800 显示屏上,一次全屏缓冲使用大约 4 MB 的内存,因此缓存应至少为 20 MB)。
ro.hwui.layer_cache_size float 16 定义每个进程图层缓存的大小(以兆字节为单位)。我们建议使用大容量的缓存,以足够容纳 4 个 32 位屏幕。例如,在 1280x800 显示屏上,一次全屏缓冲使用大约 4 MB 的内存,因此缓存应至少为 16 MB。
ro.hwui.gradient_cache_size 0.5 float 定义每个进程渐变缓存的大小(以兆字节为单位)。单次渐变通常占用 1-4 KB 的内存。建议使用大容量的缓存,以足够容纳至少 12 次渐变。
ro.hwui.patch_cache_size integer 128 定义每个进程中 9-patch 缓存的大小(以千字节为单位)。此缓存仅保留顶点数据,因此可以保持小容量。每个顶点由 4 个浮点数(即 16 个字节)组成。
ro.hwui.path_cache_size float 4 定义每个进程路径缓存的大小(以兆字节为单位)。我们建议使用大容量缓存,以足够容纳至少一个 32 位纹理的屏幕。例如,在 1280x800 显示屏上,一次全屏缓冲使用大约 4 MB 的内存,因此缓存应至少为 4 MB。
ro.hwui.shape_cache_size float 1 定义每个进程图形缓存的大小(以兆字节为单位)。该值由多个缓存(如圆形和圆角矩形)使用。我们建议使用大容量缓存,以足够容纳至少一个 8 位屏幕。例如,在 1280x800 显示屏上,一次全屏缓冲使用大约 1 MB 的内存,因此缓存应至少为 1 MB。
ro.hwui.drop_shadow_cache_size float 2 定义每个进程文字阴影缓存的大小(以兆字节为单位)。我们建议使用大容量缓存,以足够容纳两个 8 位纹理的屏幕。例如,在 1280x800 显示屏上,一次全屏缓冲使用大约 1 MB 的内存,因此缓存应至少为 2 MB。
ro.hwui.r_buffer_cache_size float 2 定义每个进程的渲染缓冲区缓存的大小(以兆字节为单位)。我们建议您使用大容量的缓存,以足够容纳 2 个 8 位的屏幕。例如,在 1280x800 显示屏上,一次全屏缓冲使用大约 1 MB 的内存,因此缓存应至少为 2 MB。如果设备支持 4 位或 1 位模板缓冲,则可以使用更小容量的缓存。
ro.hwui.texture_cache_flush_rate float 0.6 系统会定义内存清理之后保留的纹理缓存所占的比例。当系统需要回收所有应用的内存时,就会触发内存清理。我们建议在这种情况下释放大约 50% 的缓存。
ro.hwui.text_small_cache_width integer 1024 定义默认字体缓存的宽度(以像素为单位)。上限取决于 GPU 上传纹理的速度。 我们建议该宽度不低于 1024 像素、不超过 2048 像素。您还应该使用二次方值。
ro.hwui.text_small_cache_height integer 256 定义默认字体缓存的高度(以像素为单位)。上限取决于 GPU 上传纹理的速度。 我们建议该高度不低于 256 像素、不超过 1024 像素。
ro.hwui.text_large_cache_width integer 2048 定义大号字体缓存的宽度(以像素为单位)。此缓存用于字形过大难以适应默认字体缓存的情形。上限取决于 GPU 上传纹理的速度。我们建议该宽度不低于 2048 像素、不超过 4096 像素。您还应该使用二次方值。
ro.hwui.text_large_cache_height integer 512 定义大号字体缓存的高度(以像素为单位)。大号字体缓存用于字形过大难以适应默认字体缓存的情形。上限取决于 GPU 上传纹理的速度。 我们建议该高度不低于 512 像素、不超过 2048 像素。您还应该使用二次方值。
hwui.text_gamma_correction string lookup 选择文字伽马校正方法。有以下四种方法可供选择:
  • lookup3:基于查询表校正。伽马校正针对黑白文字的表现并不相同(请参见下方的阈值)。
  • lookup:基于单个查询表校正。
  • shader3:由 GLSL 着色器应用校正。伽马校正针对黑白文字的表现并不相同(请参见下方的阈值)。
  • shader:由 GLSL 着色器应用校正。
查询伽马校正在着色器数学受限的 GPU 上表现最出色。着色器伽马校正是节省内存的最佳选择。我们建议使用默认的 lookup 技术,该技术在质量、速度和内存使用方面提供了很好的折衷方案。
hwui.text_gamma float 1.4 定义用于文字伽马校正的伽马值。 该值可以根据设备使用的显示屏进行调整。
hwui.text_gamma.black_threshold integer 64 定义应用黑色伽马校正的亮度阈值上限。 必须在 0-255 的范围内定义该值。
hwui.text_gamma.white_threshold integer 192 定义应用白色伽马校正的亮度阈值下限。 必须在 0-255 的范围内定义该值。
hwui.use_gpu_pixel_buffers boolean true 用于在 OpenGL ES 3.0 硬件上启用或停用 PBO。渲染器会使用 PBO 来执行异步纹理上传,尤其是字体缓存。该属性应始终保持启用状态,但如果使用 PBO 导致出现损坏或性能很低的情况,则可以在设备开发期间停用该属性。因此,该属性不是只读属性。