151769a68a5cb34e9564740c6a854fcb93018789dRomain Guy/* 251769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * Copyright (C) 2010 The Android Open Source Project 351769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * 451769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * Licensed under the Apache License, Version 2.0 (the "License"); 551769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * you may not use this file except in compliance with the License. 651769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * You may obtain a copy of the License at 751769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * 851769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * http://www.apache.org/licenses/LICENSE-2.0 951769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * 1051769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * Unless required by applicable law or agreed to in writing, software 1151769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * distributed under the License is distributed on an "AS IS" BASIS, 1251769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1351769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * See the License for the specific language governing permissions and 1451769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * limitations under the License. 1551769a68a5cb34e9564740c6a854fcb93018789dRomain Guy */ 1651769a68a5cb34e9564740c6a854fcb93018789dRomain Guy 175b3b35296e8b2c8d3f07d32bb645d5414db41a1dRomain Guy#ifndef ANDROID_HWUI_PROPERTIES_H 185b3b35296e8b2c8d3f07d32bb645d5414db41a1dRomain Guy#define ANDROID_HWUI_PROPERTIES_H 1951769a68a5cb34e9564740c6a854fcb93018789dRomain Guy 20fb8b763f762ae21923c58d64caa729b012f40e05Romain Guy#include <cutils/properties.h> 21e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy#include <stdlib.h> 222507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik#include <utils/Singleton.h> 23fb8b763f762ae21923c58d64caa729b012f40e05Romain Guy 2451769a68a5cb34e9564740c6a854fcb93018789dRomain Guy/** 2551769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * This file contains the list of system properties used to configure 2651769a68a5cb34e9564740c6a854fcb93018789dRomain Guy * the OpenGLRenderer. 2751769a68a5cb34e9564740c6a854fcb93018789dRomain Guy */ 2851769a68a5cb34e9564740c6a854fcb93018789dRomain Guy 292507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craiknamespace android { 302507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craiknamespace uirenderer { 312507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 32cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 33cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy// Compile-time properties 34cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 35cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy 36726aeba80ffc6778a9bc3e0ee957b8d644183505Romain Guy// If turned on, text is interpreted as glyphs instead of UTF-16 37726aeba80ffc6778a9bc3e0ee957b8d644183505Romain Guy#define RENDER_TEXT_AS_GLYPHS 1 38726aeba80ffc6778a9bc3e0ee957b8d644183505Romain Guy 3928d8ff6dbcc1b137131c70b72b4dbd211db7fbd9Romain Guy// Indicates whether to remove the biggest layers first, or the smaller ones 4028d8ff6dbcc1b137131c70b72b4dbd211db7fbd9Romain Guy#define LAYER_REMOVE_BIGGEST_FIRST 0 4128d8ff6dbcc1b137131c70b72b4dbd211db7fbd9Romain Guy 4228d8ff6dbcc1b137131c70b72b4dbd211db7fbd9Romain Guy// Textures used by layers must have dimensions multiples of this number 4328d8ff6dbcc1b137131c70b72b4dbd211db7fbd9Romain Guy#define LAYER_SIZE 64 4428d8ff6dbcc1b137131c70b72b4dbd211db7fbd9Romain Guy 458d4aeb7111afac0c3c7e56d4ad5d92f9cfce2ffdRomain Guy// Defines the size in bits of the stencil buffer for the framebuffer 46ada4d53d50dc869b8278573ad640dc44118d3bcfRomain Guy// Note: Only 1 bit is required for clipping but more bits are required 478d4aeb7111afac0c3c7e56d4ad5d92f9cfce2ffdRomain Guy// to properly implement overdraw debugging 487c450aaa3caac2a05fcb20a177483d0e92378426Romain Guy#define STENCIL_BUFFER_SIZE 8 49530041d3191ce817832a0108514617768e43cda6Romain Guy 50cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 51cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy// Debug properties 52cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 53cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy 54e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy/** 554ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * Debug level for app developers. The value is a numeric value defined 564ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * by the DebugLevel enum below. 57e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy */ 584ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy#define PROPERTY_DEBUG "debug.hwui.level" 59e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy 60e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy/** 61e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy * Debug levels. Debug levels are used as flags. 62e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy */ 63e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guyenum DebugLevel { 64e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy kDebugDisabled = 0, 65e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy kDebugMemory = 1, 6625dc3a7dbac2f90f5144035e9c8ed99c09cc3132Romain Guy kDebugCaches = 2, 67042f7d64b5ccd7b5b73e7e9814a84576f04fb7d4Kenny Root kDebugMoreCaches = kDebugMemory | kDebugCaches 68e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy}; 69e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy 704ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy/** 717c450aaa3caac2a05fcb20a177483d0e92378426Romain Guy * Used to enable/disable layers update debugging. The accepted values are 724ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * "true" and "false". The default value is "false". 734ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy */ 744ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy#define PROPERTY_DEBUG_LAYERS_UPDATES "debug.hwui.show_layers_updates" 754ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy 767c450aaa3caac2a05fcb20a177483d0e92378426Romain Guy/** 77627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * Used to enable/disable overdraw debugging. 78627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * 79627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * The accepted values are 80627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * "show", to show overdraw 81627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * "show_deuteranomaly", to show overdraw if you suffer from Deuteranomaly 82627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * "count", to show an overdraw counter 83627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * "false", to disable overdraw debugging 84627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * 85627c6fd91377ead85f74a365438e25610ef1e2eeRomain Guy * The default value is "false". 867c450aaa3caac2a05fcb20a177483d0e92378426Romain Guy */ 8778dd96d5af20f489f0e8b288617d57774ec284f7Romain Guy#define PROPERTY_DEBUG_OVERDRAW "debug.hwui.overdraw" 887c450aaa3caac2a05fcb20a177483d0e92378426Romain Guy 8987e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy/** 9031e08e953fe7bdb1b1cbc247156cb6a19917a2f1Romain Guy * Used to enable/disable PerfHUD ES profiling. The accepted values 9131e08e953fe7bdb1b1cbc247156cb6a19917a2f1Romain Guy * are "true" and "false". The default value is "false". 9231e08e953fe7bdb1b1cbc247156cb6a19917a2f1Romain Guy */ 9331e08e953fe7bdb1b1cbc247156cb6a19917a2f1Romain Guy#define PROPERTY_DEBUG_NV_PROFILING "debug.hwui.nv_profiling" 9431e08e953fe7bdb1b1cbc247156cb6a19917a2f1Romain Guy 9531e08e953fe7bdb1b1cbc247156cb6a19917a2f1Romain Guy/** 96fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * System property used to enable or disable hardware rendering profiling. 97fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * The default value of this property is assumed to be false. 98fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * 99fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * When profiling is enabled, the adb shell dumpsys gfxinfo command will 100fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * output extra information about the time taken to execute by the last 101fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * frames. 102fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * 103fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * Possible values: 104fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * "true", to enable profiling 105fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * "visual_bars", to enable profiling and visualize the results on screen 106fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck * "false", to disable profiling 107fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck */ 108fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck#define PROPERTY_PROFILE "debug.hwui.profile" 109fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck#define PROPERTY_PROFILE_VISUALIZE_BARS "visual_bars" 110fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck 111fe5e7b7346a54537b980796ceeca66bfdbd05561John Reck/** 1123ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * Used to enable/disable non-rectangular clipping debugging. 1133ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * 1143ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * The accepted values are: 1153ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * "highlight", drawing commands clipped by the stencil will 1163ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * be colored differently 1173ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * "region", renders the clipping region on screen whenever 1183ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * the stencil is set 1193ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * "hide", don't show the clip 1203ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * 1213ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy * The default value is "hide". 1223ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy */ 12308bca88b272f0006e1581e9c28bc6312490f634eRomain Guy#define PROPERTY_DEBUG_STENCIL_CLIP "debug.hwui.show_non_rect_clip" 1243ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy 1253ff0bfdd144bba3b023eda8c49b25fb0d0de8653Romain Guy/** 12623d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck * Turn on to draw dirty regions every other frame. 12723d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck * 12823d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck * Possible values: 12923d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck * "true", to enable dirty regions debugging 13023d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck * "false", to disable dirty regions debugging 13123d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck */ 13223d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck#define PROPERTY_DEBUG_SHOW_DIRTY_REGIONS "debug.hwui.show_dirty_regions" 13323d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck 13423d307c8d88f4a3849163b9e5b7cd11d0d4f372cJohn Reck/** 135cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy * Disables draw operation deferral if set to "true", forcing draw 136cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy * commands to be issued to OpenGL in order, and processed in sequence 137cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy * with state-manipulation canvas commands. 138cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy */ 139cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy#define PROPERTY_DISABLE_DRAW_DEFER "debug.hwui.disable_draw_defer" 140cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy 141cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/** 142cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy * Used to disable draw operation reordering when deferring draw operations 143cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy * Has no effect if PROPERTY_DISABLE_DRAW_DEFER is set to "true" 144cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy */ 145cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy#define PROPERTY_DISABLE_DRAW_REORDER "debug.hwui.disable_draw_reorder" 146cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy 147d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck/** 148d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck * Setting this property will enable or disable the dropping of frames with 149d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck * empty damage. Default is "true". 150d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck */ 151d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck#define PROPERTY_SKIP_EMPTY_DAMAGE "debug.hwui.skip_empty_damage" 152d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck 153d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck/** 154d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck * Setting this property will enable usage of EGL_KHR_swap_buffers_with_damage 155d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck * See: https://www.khronos.org/registry/egl/extensions/KHR/EGL_KHR_swap_buffers_with_damage.txt 156d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck * Default is "false" temporarily 157d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck * TODO: Change to "true", make sure to remove the log in EglManager::swapBuffers 158d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck * before changing this to default to true! 159d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck */ 160d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck#define PROPERTY_SWAP_WITH_DAMAGE "debug.hwui.swap_with_damage" 161d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck 162cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 163cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy// Runtime configuration properties 164cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 165cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy 166cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/** 16787e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * Used to enable/disable scissor optimization. The accepted values are 16887e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * "true" and "false". The default value is "false". 16987e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * 17087e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * When scissor optimization is enabled, OpenGLRenderer will attempt to 17187e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * minimize the use of scissor by selectively enabling and disabling the 17287e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * GL scissor test. 17387e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * When the optimization is disabled, OpenGLRenderer will keep the GL 17487e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * scissor test enabled and change the scissor rect as needed. 17587e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * Some GPUs (for instance the SGX 540) perform better when changing 17687e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * the scissor rect often than when enabling/disabling the scissor test 17787e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy * often. 17887e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy */ 17987e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy#define PROPERTY_DISABLE_SCISSOR_OPTIMIZATION "ro.hwui.disable_scissor_opt" 18087e2f757be9b24d369bab354e37c276e851b1fc7Romain Guy 181c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik/** 182cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy * Indicates whether PBOs can be used to back pixel buffers. 183f9f0016b1ff816eb2c7561eed482c056189005f8Romain Guy * Accepted values are "true" and "false". Default is true. 184c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik */ 185f9f0016b1ff816eb2c7561eed482c056189005f8Romain Guy#define PROPERTY_ENABLE_GPU_PIXEL_BUFFERS "ro.hwui.use_gpu_pixel_buffers" 186c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 18751769a68a5cb34e9564740c6a854fcb93018789dRomain Guy// These properties are defined in mega-bytes 18851769a68a5cb34e9564740c6a854fcb93018789dRomain Guy#define PROPERTY_TEXTURE_CACHE_SIZE "ro.hwui.texture_cache_size" 18951769a68a5cb34e9564740c6a854fcb93018789dRomain Guy#define PROPERTY_LAYER_CACHE_SIZE "ro.hwui.layer_cache_size" 1908d4aeb7111afac0c3c7e56d4ad5d92f9cfce2ffdRomain Guy#define PROPERTY_RENDER_BUFFER_CACHE_SIZE "ro.hwui.r_buffer_cache_size" 19151769a68a5cb34e9564740c6a854fcb93018789dRomain Guy#define PROPERTY_GRADIENT_CACHE_SIZE "ro.hwui.gradient_cache_size" 1927fbcc0492fca03857e3c45064f4aa040af817d55Romain Guy#define PROPERTY_PATH_CACHE_SIZE "ro.hwui.path_cache_size" 19305f3d6e5111fd08df5cd9aae2c3d28399dc0e7f5Chris Craik#define PROPERTY_VERTEX_CACHE_SIZE "ro.hwui.vertex_cache_size" 1943b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy#define PROPERTY_PATCH_CACHE_SIZE "ro.hwui.patch_cache_size" 1951e45aae5de003657e5d18f74d34998f5de5db5b7Romain Guy#define PROPERTY_DROP_SHADOW_CACHE_SIZE "ro.hwui.drop_shadow_cache_size" 196e2d345ea67e2960b37bfdc0fc8626d1bfa747404Romain Guy#define PROPERTY_FBO_CACHE_SIZE "ro.hwui.fbo_cache_size" 19751769a68a5cb34e9564740c6a854fcb93018789dRomain Guy 198eca0ca2424afc1e98912405906edfc32f7733e16Romain Guy// These properties are defined in percentage (range 0..1) 199115096f50a560e64a7f95d37686d4861042c7aebRomain Guy#define PROPERTY_TEXTURE_CACHE_FLUSH_RATE "ro.hwui.texture_cache_flushrate" 200eca0ca2424afc1e98912405906edfc32f7733e16Romain Guy 20151769a68a5cb34e9564740c6a854fcb93018789dRomain Guy// These properties are defined in pixels 202eb32a499194119b3783b86c925172df02e5d2685Chet Haase#define PROPERTY_TEXT_SMALL_CACHE_WIDTH "ro.hwui.text_small_cache_width" 203eb32a499194119b3783b86c925172df02e5d2685Chet Haase#define PROPERTY_TEXT_SMALL_CACHE_HEIGHT "ro.hwui.text_small_cache_height" 204eb32a499194119b3783b86c925172df02e5d2685Chet Haase#define PROPERTY_TEXT_LARGE_CACHE_WIDTH "ro.hwui.text_large_cache_width" 205eb32a499194119b3783b86c925172df02e5d2685Chet Haase#define PROPERTY_TEXT_LARGE_CACHE_HEIGHT "ro.hwui.text_large_cache_height" 20651769a68a5cb34e9564740c6a854fcb93018789dRomain Guy 207b1d0a4ed21168fefcb82232c8f22cb95d60acb85Romain Guy// Indicates whether gamma correction should be applied in the shaders 2086e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// or in lookup tables. Accepted values: 2096e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// 2106e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// - "lookup3", correction based on lookup tables. Gamma correction 2116e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// is different for black and white text (see thresholds below) 2126e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// 2136e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// - "lookup", correction based on a single lookup table 2146e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// 2156e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// - "shader3", correction applied by a GLSL shader. Gamma correction 2166e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// is different for black and white text (see thresholds below) 2176e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// 2186e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// - "shader", correction applied by a GLSL shader 2196e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// 2206e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// See PROPERTY_TEXT_GAMMA, PROPERTY_TEXT_BLACK_GAMMA_THRESHOLD and 2216e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// PROPERTY_TEXT_WHITE_GAMMA_THRESHOLD for more control. 222dfab50d8b97a90dca279b119ebe439f595616ffaRomain Guy#define PROPERTY_TEXT_GAMMA_METHOD "hwui.text_gamma_correction" 223dfab50d8b97a90dca279b119ebe439f595616ffaRomain Guy#define DEFAULT_TEXT_GAMMA_METHOD "lookup" 224b1d0a4ed21168fefcb82232c8f22cb95d60acb85Romain Guy 225b45c0c9774bd19a9dbe77d149abae4e124b08bf6Romain Guy// Gamma (>= 1.0, <= 10.0) 2266e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy#define PROPERTY_TEXT_GAMMA "hwui.text_gamma" 2276e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// Luminance threshold below which black gamma correction is applied. Range: [0..255] 2286e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy#define PROPERTY_TEXT_BLACK_GAMMA_THRESHOLD "hwui.text_gamma.black_threshold" 2296e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy// Lumincance threshold above which white gamma correction is applied. Range: [0..255] 2306e25e38e43f9e7f71397dfab7ed32c81c7bf7d46Romain Guy#define PROPERTY_TEXT_WHITE_GAMMA_THRESHOLD "hwui.text_gamma.white_threshold" 231b45c0c9774bd19a9dbe77d149abae4e124b08bf6Romain Guy 232cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 233cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy// Default property values 234cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 235fb8b763f762ae21923c58d64caa729b012f40e05Romain Guy 23609b7c91de73b59aa3f679b3ae3ba299f82ec9f8aRomain Guy#define DEFAULT_TEXTURE_CACHE_SIZE 24.0f 23765b345fa22b878e141b8fd8ece9c208df00fa40fRomain Guy#define DEFAULT_LAYER_CACHE_SIZE 16.0f 2388d4aeb7111afac0c3c7e56d4ad5d92f9cfce2ffdRomain Guy#define DEFAULT_RENDER_BUFFER_CACHE_SIZE 2.0f 2398d34aaff3cda45626be697f5f334a46fc053b273Chris Craik#define DEFAULT_PATH_CACHE_SIZE 4.0f 24005f3d6e5111fd08df5cd9aae2c3d28399dc0e7f5Chris Craik#define DEFAULT_VERTEX_CACHE_SIZE 1.0f 2413b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy#define DEFAULT_PATCH_CACHE_SIZE 128 // in kB 242fb8b763f762ae21923c58d64caa729b012f40e05Romain Guy#define DEFAULT_GRADIENT_CACHE_SIZE 0.5f 243fb8b763f762ae21923c58d64caa729b012f40e05Romain Guy#define DEFAULT_DROP_SHADOW_CACHE_SIZE 2.0f 244e9cd97ee88e6628897e878889d3920857e9c118aJohn Reck#define DEFAULT_FBO_CACHE_SIZE 0 245fb8b763f762ae21923c58d64caa729b012f40e05Romain Guy 246eca0ca2424afc1e98912405906edfc32f7733e16Romain Guy#define DEFAULT_TEXTURE_CACHE_FLUSH_RATE 0.6f 247eca0ca2424afc1e98912405906edfc32f7733e16Romain Guy 248b45c0c9774bd19a9dbe77d149abae4e124b08bf6Romain Guy#define DEFAULT_TEXT_GAMMA 1.4f 249b45c0c9774bd19a9dbe77d149abae4e124b08bf6Romain Guy#define DEFAULT_TEXT_BLACK_GAMMA_THRESHOLD 64 250b45c0c9774bd19a9dbe77d149abae4e124b08bf6Romain Guy#define DEFAULT_TEXT_WHITE_GAMMA_THRESHOLD 192 251b45c0c9774bd19a9dbe77d149abae4e124b08bf6Romain Guy 252cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 253cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy// Misc 254cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy/////////////////////////////////////////////////////////////////////////////// 255cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy 256cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy// Converts a number of mega-bytes into bytes 257cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy#define MB(s) s * 1024 * 1024 2583b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy// Converts a number of kilo-bytes into bytes 2593b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy#define KB(s) s * 1024 260cf51a4199835e9604aa4c8b3854306f8fbabbf33Romain Guy 2612507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craikenum class ProfileType { 2622507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik None, 2632507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik Console, 2642507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik Bars 2652507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik}; 2662507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 2672507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craikenum class OverdrawColorSet { 2682507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik Default = 0, 2692507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik Deuteranomaly 2702507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik}; 2712507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 2722507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craikenum class StencilClipDebug { 2732507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik Hide, 2742507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik ShowHighlight, 2752507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik ShowRegion 2762507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik}; 2772507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 2782507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik/** 2792507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik * Renderthread-only singleton which manages several static rendering properties. Most of these 2802507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik * are driven by system properties which are queried once at initialization, and again if init() 2812507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik * is called. 2822507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik */ 2832507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craikclass Properties { 2842507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craikpublic: 2852507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static bool load(); 2862507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 2872507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static bool drawDeferDisabled; 2882507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static bool drawReorderDisabled; 2892507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static bool debugLayersUpdates; 2902507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static bool debugOverdraw; 2912507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static bool showDirtyRegions; 292d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck // TODO: Remove after stabilization period 293d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck static bool skipEmptyFrames; 294d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck // TODO: Remove after stabilization period 295d04794a9a3f9edc8b7ca336175d66eb81a8f55faJohn Reck static bool swapBuffersWithDamage; 2962507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 2972507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static DebugLevel debugLevel; 2982507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static OverdrawColorSet overdrawColorSet; 2992507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static StencilClipDebug debugStencilClip; 3002507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 3012507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik // Override the value for a subset of properties in this class 3022507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static void overrideProperty(const char* name, const char* value); 3032507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 3042507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static float overrideLightRadius; 3052507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static float overrideLightPosY; 3062507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static float overrideLightPosZ; 3072507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static float overrideAmbientRatio; 3082507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static int overrideAmbientShadowStrength; 3092507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static int overrideSpotShadowStrength; 3102507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 3112507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static ProfileType getProfileType(); 3122507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 3132507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craikprivate: 3142507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static ProfileType sProfileType; 3152507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik static bool sDisableProfileBars; 3162507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 3172507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik}; // class Caches 3182507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik 3192507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik}; // namespace uirenderer 3202507c34d91bb0d722b6012e85cb47387b2aa6873Chris Craik}; // namespace android 321e190aa69756aecfaffabdd4c6d32cb6b3220d842Romain Guy 3225b3b35296e8b2c8d3f07d32bb645d5414db41a1dRomain Guy#endif // ANDROID_HWUI_PROPERTIES_H 323