libs/hwui/Caches.cpp - platform/frameworks/base - Gitiles

 /*
  * Copyright (C) 2010 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */

 #define LOG_TAG "OpenGLRenderer"

 #include <utils/Log.h>
 #include <utils/String8.h>

 #include "Caches.h"
 #include "DisplayListRenderer.h"
 #include "Properties.h"
 #include "LayerRenderer.h"

 namespace android {

 #ifdef USE_OPENGL_RENDERER
 using namespace uirenderer;
 ANDROID_SINGLETON_STATIC_INSTANCE(Caches);
 #endif

 namespace uirenderer {

 ///////////////////////////////////////////////////////////////////////////////
 // Macros
 ///////////////////////////////////////////////////////////////////////////////

 #if DEBUG_CACHE_FLUSH
     #define FLUSH_LOGD(...) ALOGD(__VA_ARGS__)
 #else
     #define FLUSH_LOGD(...)
 #endif

 ///////////////////////////////////////////////////////////////////////////////
 // Constructors/destructor
 ///////////////////////////////////////////////////////////////////////////////

 Caches::Caches(): Singleton<Caches>(),
         mExtensions(Extensions::getInstance()), mInitialized(false) {
     init();
     initFont();
     initConstraints();
     initProperties();
     initStaticProperties();
     initExtensions();

     mDebugLevel = readDebugLevel();
     ALOGD("Enabling debug mode %d", mDebugLevel);
 }

 bool Caches::init() {
     if (mInitialized) return false;

     glGenBuffers(1, &meshBuffer);
     glBindBuffer(GL_ARRAY_BUFFER, meshBuffer);
     glBufferData(GL_ARRAY_BUFFER, sizeof(gMeshVertices), gMeshVertices, GL_STATIC_DRAW);

     mCurrentBuffer = meshBuffer;
     mCurrentIndicesBuffer = 0;
     mCurrentPositionPointer = this;
     mCurrentPositionStride = 0;
     mCurrentTexCoordsPointer = this;
     mCurrentPixelBuffer = 0;

     mTexCoordsArrayEnabled = false;

     glDisable(GL_SCISSOR_TEST);
     scissorEnabled = false;
     mScissorX = mScissorY = mScissorWidth = mScissorHeight = 0;

     glActiveTexture(gTextureUnits[0]);
     mTextureUnit = 0;

     mRegionMesh = NULL;
     mMeshIndices = 0;

     blend = false;
     lastSrcMode = GL_ZERO;
     lastDstMode = GL_ZERO;
     currentProgram = NULL;

     mFunctorsCount = 0;

     debugLayersUpdates = false;
     debugOverdraw = false;
     debugStencilClip = kStencilHide;

     patchCache.init(*this);

     mInitialized = true;

     resetBoundTextures();

     return true;
 }

 void Caches::initFont() {
     fontRenderer = GammaFontRenderer::createRenderer();
 }

 void Caches::initExtensions() {
     if (mExtensions.hasDebugMarker()) {
         eventMark = glInsertEventMarkerEXT;

         startMark = glPushGroupMarkerEXT;
         endMark = glPopGroupMarkerEXT;
     } else {
         eventMark = eventMarkNull;
         startMark = startMarkNull;
         endMark = endMarkNull;
     }

     if (mExtensions.hasDebugLabel() && (drawDeferDisabled || drawReorderDisabled)) {
         setLabel = glLabelObjectEXT;
         getLabel = glGetObjectLabelEXT;
     } else {
         setLabel = setLabelNull;
         getLabel = getLabelNull;
     }
 }

 void Caches::initConstraints() {
     GLint maxTextureUnits;
     glGetIntegerv(GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS, &maxTextureUnits);
     if (maxTextureUnits < REQUIRED_TEXTURE_UNITS_COUNT) {
         ALOGW("At least %d texture units are required!", REQUIRED_TEXTURE_UNITS_COUNT);
     }

     glGetIntegerv(GL_MAX_TEXTURE_SIZE, &maxTextureSize);
 }

 void Caches::initStaticProperties() {
     gpuPixelBuffersEnabled = false;

     // OpenGL ES 3.0+ specific features
     if (mExtensions.hasPixelBufferObjects()) {
         char property[PROPERTY_VALUE_MAX];
         if (property_get(PROPERTY_ENABLE_GPU_PIXEL_BUFFERS, property, "true") > 0) {
             gpuPixelBuffersEnabled = !strcmp(property, "true");
         }
     }
 }

 bool Caches::initProperties() {
     bool prevDebugLayersUpdates = debugLayersUpdates;
     bool prevDebugOverdraw = debugOverdraw;
     StencilClipDebug prevDebugStencilClip = debugStencilClip;

     char property[PROPERTY_VALUE_MAX];
     if (property_get(PROPERTY_DEBUG_LAYERS_UPDATES, property, NULL) > 0) {
         INIT_LOGD("  Layers updates debug enabled: %s", property);
         debugLayersUpdates = !strcmp(property, "true");
     } else {
         debugLayersUpdates = false;
     }

     debugOverdraw = false;
     if (property_get(PROPERTY_DEBUG_OVERDRAW, property, NULL) > 0) {
         INIT_LOGD("  Overdraw debug enabled: %s", property);
         if (!strcmp(property, "show")) {
             debugOverdraw = true;
             mOverdrawDebugColorSet = kColorSet_Default;
         } else if (!strcmp(property, "show_deuteranomaly")) {
             debugOverdraw = true;
             mOverdrawDebugColorSet = kColorSet_Deuteranomaly;
         }
     }

     // See Properties.h for valid values
     if (property_get(PROPERTY_DEBUG_STENCIL_CLIP, property, NULL) > 0) {
         INIT_LOGD("  Stencil clip debug enabled: %s", property);
         if (!strcmp(property, "hide")) {
             debugStencilClip = kStencilHide;
         } else if (!strcmp(property, "highlight")) {
             debugStencilClip = kStencilShowHighlight;
         } else if (!strcmp(property, "region")) {
             debugStencilClip = kStencilShowRegion;
         }
     } else {
         debugStencilClip = kStencilHide;
     }

     if (property_get(PROPERTY_DISABLE_DRAW_DEFER, property, "false")) {
         drawDeferDisabled = !strcasecmp(property, "true");
         INIT_LOGD("  Draw defer %s", drawDeferDisabled ? "disabled" : "enabled");
     } else {
         INIT_LOGD("  Draw defer enabled");
     }

     if (property_get(PROPERTY_DISABLE_DRAW_REORDER, property, "false")) {
         drawReorderDisabled = !strcasecmp(property, "true");
         INIT_LOGD("  Draw reorder %s", drawReorderDisabled ? "disabled" : "enabled");
     } else {
         INIT_LOGD("  Draw reorder enabled");
     }

     return (prevDebugLayersUpdates != debugLayersUpdates) ||
             (prevDebugOverdraw != debugOverdraw) ||
             (prevDebugStencilClip != debugStencilClip);
 }

 void Caches::terminate() {
     if (!mInitialized) return;

     glDeleteBuffers(1, &meshBuffer);
     mCurrentBuffer = 0;

     glDeleteBuffers(1, &mMeshIndices);
     delete[] mRegionMesh;
     mMeshIndices = 0;
     mRegionMesh = NULL;

     fboCache.clear();

     programCache.clear();
     currentProgram = NULL;

     assetAtlas.terminate();

     patchCache.clear();

     clearGarbage();

     mInitialized = false;
 }

 ///////////////////////////////////////////////////////////////////////////////
 // Debug
 ///////////////////////////////////////////////////////////////////////////////

 uint32_t Caches::getOverdrawColor(uint32_t amount) const {
     static uint32_t sOverdrawColors[2][4] = {
             { 0x2f0000ff, 0x2f00ff00, 0x3fff0000, 0x7fff0000 },
             { 0x2f0000ff, 0x4fffff00, 0x5fff8ad8, 0x7fff0000 }
     };
     if (amount < 1) amount = 1;
     if (amount > 4) amount = 4;
     return sOverdrawColors[mOverdrawDebugColorSet][amount - 1];
 }

 void Caches::dumpMemoryUsage() {
     String8 stringLog;
     dumpMemoryUsage(stringLog);
     ALOGD("%s", stringLog.string());
 }

 void Caches::dumpMemoryUsage(String8 &log) {
     log.appendFormat("Current memory usage / total memory usage (bytes):\n");
     log.appendFormat("  TextureCache         %8d / %8d\n",
             textureCache.getSize(), textureCache.getMaxSize());
     log.appendFormat("  LayerCache           %8d / %8d\n",
             layerCache.getSize(), layerCache.getMaxSize());
     log.appendFormat("  RenderBufferCache    %8d / %8d\n",
             renderBufferCache.getSize(), renderBufferCache.getMaxSize());
     log.appendFormat("  GradientCache        %8d / %8d\n",
             gradientCache.getSize(), gradientCache.getMaxSize());
     log.appendFormat("  PathCache            %8d / %8d\n",
             pathCache.getSize(), pathCache.getMaxSize());
     log.appendFormat("  TextDropShadowCache  %8d / %8d\n", dropShadowCache.getSize(),
             dropShadowCache.getMaxSize());
     log.appendFormat("  PatchCache           %8d / %8d\n",
             patchCache.getSize(), patchCache.getMaxSize());
     for (uint32_t i = 0; i < fontRenderer->getFontRendererCount(); i++) {
         const uint32_t sizeA8 = fontRenderer->getFontRendererSize(i, GL_ALPHA);
         const uint32_t sizeRGBA = fontRenderer->getFontRendererSize(i, GL_RGBA);
         log.appendFormat("  FontRenderer %d A8    %8d / %8d\n", i, sizeA8, sizeA8);
         log.appendFormat("  FontRenderer %d RGBA  %8d / %8d\n", i, sizeRGBA, sizeRGBA);
         log.appendFormat("  FontRenderer %d total %8d / %8d\n", i, sizeA8 + sizeRGBA,
                 sizeA8 + sizeRGBA);
     }
     log.appendFormat("Other:\n");
     log.appendFormat("  FboCache             %8d / %8d\n",
             fboCache.getSize(), fboCache.getMaxSize());

     uint32_t total = 0;
     total += textureCache.getSize();
     total += layerCache.getSize();
     total += renderBufferCache.getSize();
     total += gradientCache.getSize();
     total += pathCache.getSize();
     total += dropShadowCache.getSize();
     total += patchCache.getSize();
     for (uint32_t i = 0; i < fontRenderer->getFontRendererCount(); i++) {
         total += fontRenderer->getFontRendererSize(i, GL_ALPHA);
         total += fontRenderer->getFontRendererSize(i, GL_RGBA);
     }

     log.appendFormat("Total memory usage:\n");
     log.appendFormat("  %d bytes, %.2f MB\n", total, total / 1024.0f / 1024.0f);
 }

 ///////////////////////////////////////////////////////////////////////////////
 // Memory management
 ///////////////////////////////////////////////////////////////////////////////

 void Caches::clearGarbage() {
     textureCache.clearGarbage();
     pathCache.clearGarbage();
     patchCache.clearGarbage();

     Vector<DisplayList*> displayLists;
     Vector<Layer*> layers;

     { // scope for the lock
         Mutex::Autolock _l(mGarbageLock);
         displayLists = mDisplayListGarbage;
         layers = mLayerGarbage;
         mDisplayListGarbage.clear();
         mLayerGarbage.clear();
     }

     size_t count = displayLists.size();
     for (size_t i = 0; i < count; i++) {
         DisplayList* displayList = displayLists.itemAt(i);
         delete displayList;
     }

     count = layers.size();
     for (size_t i = 0; i < count; i++) {
         Layer* layer = layers.itemAt(i);
         delete layer;
     }
     layers.clear();
 }

 void Caches::deleteLayerDeferred(Layer* layer) {
     Mutex::Autolock _l(mGarbageLock);
     mLayerGarbage.push(layer);
 }

 void Caches::deleteDisplayListDeferred(DisplayList* displayList) {
     Mutex::Autolock _l(mGarbageLock);
     mDisplayListGarbage.push(displayList);
 }

 void Caches::flush(FlushMode mode) {
     FLUSH_LOGD("Flushing caches (mode %d)", mode);

     // We must stop tasks before clearing caches
     if (mode > kFlushMode_Layers) {
         tasks.stop();
     }

     switch (mode) {
         case kFlushMode_Full:
             textureCache.clear();
             patchCache.clear();
             dropShadowCache.clear();
             gradientCache.clear();
             fontRenderer->clear();
             fboCache.clear();
             dither.clear();
             // fall through
         case kFlushMode_Moderate:
             fontRenderer->flush();
             textureCache.flush();
             pathCache.clear();
             // fall through
         case kFlushMode_Layers:
             layerCache.clear();
             renderBufferCache.clear();
             break;
     }

     clearGarbage();
 }

 ///////////////////////////////////////////////////////////////////////////////
 // VBO
 ///////////////////////////////////////////////////////////////////////////////

 bool Caches::bindMeshBuffer() {
     return bindMeshBuffer(meshBuffer);
 }

 bool Caches::bindMeshBuffer(const GLuint buffer) {
     if (mCurrentBuffer != buffer) {
         glBindBuffer(GL_ARRAY_BUFFER, buffer);
         mCurrentBuffer = buffer;
         return true;
     }
     return false;
 }

 bool Caches::unbindMeshBuffer() {
     if (mCurrentBuffer) {
         glBindBuffer(GL_ARRAY_BUFFER, 0);
         mCurrentBuffer = 0;
         return true;
     }
     return false;
 }

 bool Caches::bindIndicesBuffer(const GLuint buffer) {
     if (mCurrentIndicesBuffer != buffer) {
         glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, buffer);
         mCurrentIndicesBuffer = buffer;
         return true;
     }
     return false;
 }

 bool Caches::bindIndicesBuffer() {
     if (!mMeshIndices) {
         uint16_t* regionIndices = new uint16_t[gMaxNumberOfQuads * 6];
         for (uint32_t i = 0; i < gMaxNumberOfQuads; i++) {
             uint16_t quad = i * 4;
             int index = i * 6;
             regionIndices[index    ] = quad;       // top-left
             regionIndices[index + 1] = quad + 1;   // top-right
             regionIndices[index + 2] = quad + 2;   // bottom-left
             regionIndices[index + 3] = quad + 2;   // bottom-left
             regionIndices[index + 4] = quad + 1;   // top-right
             regionIndices[index + 5] = quad + 3;   // bottom-right
         }

         glGenBuffers(1, &mMeshIndices);
         bool force = bindIndicesBuffer(mMeshIndices);
         glBufferData(GL_ELEMENT_ARRAY_BUFFER, gMaxNumberOfQuads * 6 * sizeof(uint16_t),
                 regionIndices, GL_STATIC_DRAW);

         delete[] regionIndices;
         return force;
     }

     return bindIndicesBuffer(mMeshIndices);
 }

 bool Caches::unbindIndicesBuffer() {
     if (mCurrentIndicesBuffer) {
         glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, 0);
         mCurrentIndicesBuffer = 0;
         return true;
     }
     return false;
 }

 ///////////////////////////////////////////////////////////////////////////////
 // PBO
 ///////////////////////////////////////////////////////////////////////////////

 bool Caches::bindPixelBuffer(const GLuint buffer) {
     if (mCurrentPixelBuffer != buffer) {
         glBindBuffer(GL_PIXEL_UNPACK_BUFFER, buffer);
         mCurrentPixelBuffer = buffer;
         return true;
     }
     return false;
 }

 bool Caches::unbindPixelBuffer() {
     if (mCurrentPixelBuffer) {
         glBindBuffer(GL_PIXEL_UNPACK_BUFFER, 0);
         mCurrentPixelBuffer = 0;
         return true;
     }
     return false;
 }

 ///////////////////////////////////////////////////////////////////////////////
 // Meshes and textures
 ///////////////////////////////////////////////////////////////////////////////

 void Caches::bindPositionVertexPointer(bool force, GLvoid* vertices, GLsizei stride) {
     if (force || vertices != mCurrentPositionPointer || stride != mCurrentPositionStride) {
         GLuint slot = currentProgram->position;
         glVertexAttribPointer(slot, 2, GL_FLOAT, GL_FALSE, stride, vertices);
         mCurrentPositionPointer = vertices;
         mCurrentPositionStride = stride;
     }
 }

 void Caches::bindTexCoordsVertexPointer(bool force, GLvoid* vertices, GLsizei stride) {
     if (force || vertices != mCurrentTexCoordsPointer || stride != mCurrentTexCoordsStride) {
         GLuint slot = currentProgram->texCoords;
         glVertexAttribPointer(slot, 2, GL_FLOAT, GL_FALSE, stride, vertices);
         mCurrentTexCoordsPointer = vertices;
         mCurrentTexCoordsStride = stride;
     }
 }

 void Caches::resetVertexPointers() {
     mCurrentPositionPointer = this;
     mCurrentTexCoordsPointer = this;
 }

 void Caches::resetTexCoordsVertexPointer() {
     mCurrentTexCoordsPointer = this;
 }

 void Caches::enableTexCoordsVertexArray() {
     if (!mTexCoordsArrayEnabled) {
         glEnableVertexAttribArray(Program::kBindingTexCoords);
         mCurrentTexCoordsPointer = this;
         mTexCoordsArrayEnabled = true;
     }
 }

 void Caches::disableTexCoordsVertexArray() {
     if (mTexCoordsArrayEnabled) {
         glDisableVertexAttribArray(Program::kBindingTexCoords);
         mTexCoordsArrayEnabled = false;
     }
 }

 void Caches::activeTexture(GLuint textureUnit) {
     if (mTextureUnit != textureUnit) {
         glActiveTexture(gTextureUnits[textureUnit]);
         mTextureUnit = textureUnit;
     }
 }

 void Caches::resetActiveTexture() {
     mTextureUnit = -1;
 }

 void Caches::bindTexture(GLuint texture) {
     if (mBoundTextures[mTextureUnit] != texture) {
         glBindTexture(GL_TEXTURE_2D, texture);
         mBoundTextures[mTextureUnit] = texture;
     }
 }

 void Caches::bindTexture(GLenum target, GLuint texture) {
     if (mBoundTextures[mTextureUnit] != texture) {
         glBindTexture(target, texture);
         mBoundTextures[mTextureUnit] = texture;
     }
 }

 void Caches::deleteTexture(GLuint texture) {
     // When glDeleteTextures() is called on a currently bound texture,
     // OpenGL ES specifies that the texture is then considered unbound
     // Consider the following series of calls:
     //
     // glGenTextures -> creates texture name 2
     // glBindTexture(2)
     // glDeleteTextures(2) -> 2 is now unbound
     // glGenTextures -> can return 2 again
     //
     // If we don't call glBindTexture(2) after the second glGenTextures
     // call, any texture operation will be performed on the default
     // texture (name=0)

     for (int i = 0; i < REQUIRED_TEXTURE_UNITS_COUNT; i++) {
         if (mBoundTextures[i] == texture) {
             mBoundTextures[i] = 0;
         }
     }
     glDeleteTextures(1, &texture);
 }

 void Caches::resetBoundTextures() {
     memset(mBoundTextures, 0, REQUIRED_TEXTURE_UNITS_COUNT * sizeof(GLuint));
 }

 ///////////////////////////////////////////////////////////////////////////////
 // Scissor
 ///////////////////////////////////////////////////////////////////////////////

 bool Caches::setScissor(GLint x, GLint y, GLint width, GLint height) {
     if (scissorEnabled && (x != mScissorX || y != mScissorY ||
             width != mScissorWidth || height != mScissorHeight)) {

         if (x < 0) {
             width += x;
             x = 0;
         }
         if (y < 0) {
             height += y;
             y = 0;
         }
         if (width < 0) {
             width = 0;
         }
         if (height < 0) {
             height = 0;
         }
         glScissor(x, y, width, height);

         mScissorX = x;
         mScissorY = y;
         mScissorWidth = width;
         mScissorHeight = height;

         return true;
     }
     return false;
 }

 bool Caches::enableScissor() {
     if (!scissorEnabled) {
         glEnable(GL_SCISSOR_TEST);
         scissorEnabled = true;
         resetScissor();
         return true;
     }
     return false;
 }

 bool Caches::disableScissor() {
     if (scissorEnabled) {
         glDisable(GL_SCISSOR_TEST);
         scissorEnabled = false;
         return true;
     }
     return false;
 }

 void Caches::setScissorEnabled(bool enabled) {
     if (scissorEnabled != enabled) {
         if (enabled) glEnable(GL_SCISSOR_TEST);
         else glDisable(GL_SCISSOR_TEST);
         scissorEnabled = enabled;
     }
 }

 void Caches::resetScissor() {
     mScissorX = mScissorY = mScissorWidth = mScissorHeight = 0;
 }

 ///////////////////////////////////////////////////////////////////////////////
 // Tiling
 ///////////////////////////////////////////////////////////////////////////////

 void Caches::startTiling(GLuint x, GLuint y, GLuint width, GLuint height, bool discard) {
     if (mExtensions.hasTiledRendering() && !debugOverdraw) {
         glStartTilingQCOM(x, y, width, height, (discard ? GL_NONE : GL_COLOR_BUFFER_BIT0_QCOM));
     }
 }

 void Caches::endTiling() {
     if (mExtensions.hasTiledRendering() && !debugOverdraw) {
         glEndTilingQCOM(GL_COLOR_BUFFER_BIT0_QCOM);
     }
 }

 bool Caches::hasRegisteredFunctors() {
     return mFunctorsCount > 0;
 }

 void Caches::registerFunctors(uint32_t functorCount) {
     mFunctorsCount += functorCount;
 }

 void Caches::unregisterFunctors(uint32_t functorCount) {
     if (functorCount > mFunctorsCount) {
         mFunctorsCount = 0;
     } else {
         mFunctorsCount -= functorCount;
     }
 }

 ///////////////////////////////////////////////////////////////////////////////
 // Regions
 ///////////////////////////////////////////////////////////////////////////////

 TextureVertex* Caches::getRegionMesh() {
     // Create the mesh, 2 triangles and 4 vertices per rectangle in the region
     if (!mRegionMesh) {
         mRegionMesh = new TextureVertex[gMaxNumberOfQuads * 4];
     }

     return mRegionMesh;
 }

 }; // namespace uirenderer
 }; // namespace android
	/*
	* Copyright (C) 2010 The Android Open Source Project
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/

	#define LOG_TAG "OpenGLRenderer"

	#include <utils/Log.h>
	#include <utils/String8.h>

	#include "Caches.h"
	#include "DisplayListRenderer.h"
	#include "Properties.h"
	#include "LayerRenderer.h"

	namespace android {

	#ifdef USE_OPENGL_RENDERER
	using namespace uirenderer;
	ANDROID_SINGLETON_STATIC_INSTANCE(Caches);
	#endif

	namespace uirenderer {

	///////////////////////////////////////////////////////////////////////////////
	// Macros
	///////////////////////////////////////////////////////////////////////////////

	#if DEBUG_CACHE_FLUSH
	#define FLUSH_LOGD(...) ALOGD(__VA_ARGS__)
	#else
	#define FLUSH_LOGD(...)
	#endif

	///////////////////////////////////////////////////////////////////////////////
	// Constructors/destructor
	///////////////////////////////////////////////////////////////////////////////

	Caches::Caches(): Singleton<Caches>(),
	mExtensions(Extensions::getInstance()), mInitialized(false) {
	init();
	initFont();
	initConstraints();
	initProperties();
	initStaticProperties();
	initExtensions();

	mDebugLevel = readDebugLevel();
	ALOGD("Enabling debug mode %d", mDebugLevel);
	}

	bool Caches::init() {
	if (mInitialized) return false;

	glGenBuffers(1, &meshBuffer);
	glBindBuffer(GL_ARRAY_BUFFER, meshBuffer);
	glBufferData(GL_ARRAY_BUFFER, sizeof(gMeshVertices), gMeshVertices, GL_STATIC_DRAW);

	mCurrentBuffer = meshBuffer;
	mCurrentIndicesBuffer = 0;
	mCurrentPositionPointer = this;
	mCurrentPositionStride = 0;
	mCurrentTexCoordsPointer = this;
	mCurrentPixelBuffer = 0;

	mTexCoordsArrayEnabled = false;

	glDisable(GL_SCISSOR_TEST);
	scissorEnabled = false;
	mScissorX = mScissorY = mScissorWidth = mScissorHeight = 0;

	glActiveTexture(gTextureUnits[0]);
	mTextureUnit = 0;

	mRegionMesh = NULL;
	mMeshIndices = 0;

	blend = false;
	lastSrcMode = GL_ZERO;
	lastDstMode = GL_ZERO;
	currentProgram = NULL;

	mFunctorsCount = 0;

	debugLayersUpdates = false;
	debugOverdraw = false;
	debugStencilClip = kStencilHide;

	patchCache.init(*this);

	mInitialized = true;

	resetBoundTextures();

	return true;
	}

	void Caches::initFont() {
	fontRenderer = GammaFontRenderer::createRenderer();
	}

	void Caches::initExtensions() {
	if (mExtensions.hasDebugMarker()) {
	eventMark = glInsertEventMarkerEXT;

	startMark = glPushGroupMarkerEXT;
	endMark = glPopGroupMarkerEXT;
	} else {
	eventMark = eventMarkNull;
	startMark = startMarkNull;
	endMark = endMarkNull;
	}

	if (mExtensions.hasDebugLabel() && (drawDeferDisabled \|\| drawReorderDisabled)) {
	setLabel = glLabelObjectEXT;
	getLabel = glGetObjectLabelEXT;
	} else {
	setLabel = setLabelNull;
	getLabel = getLabelNull;
	}
	}

	void Caches::initConstraints() {
	GLint maxTextureUnits;
	glGetIntegerv(GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS, &maxTextureUnits);
	if (maxTextureUnits < REQUIRED_TEXTURE_UNITS_COUNT) {
	ALOGW("At least %d texture units are required!", REQUIRED_TEXTURE_UNITS_COUNT);
	}

	glGetIntegerv(GL_MAX_TEXTURE_SIZE, &maxTextureSize);
	}

	void Caches::initStaticProperties() {
	gpuPixelBuffersEnabled = false;

	// OpenGL ES 3.0+ specific features
	if (mExtensions.hasPixelBufferObjects()) {
	char property[PROPERTY_VALUE_MAX];
	if (property_get(PROPERTY_ENABLE_GPU_PIXEL_BUFFERS, property, "true") > 0) {
	gpuPixelBuffersEnabled = !strcmp(property, "true");
	}
	}
	}

	bool Caches::initProperties() {
	bool prevDebugLayersUpdates = debugLayersUpdates;
	bool prevDebugOverdraw = debugOverdraw;
	StencilClipDebug prevDebugStencilClip = debugStencilClip;

	char property[PROPERTY_VALUE_MAX];
	if (property_get(PROPERTY_DEBUG_LAYERS_UPDATES, property, NULL) > 0) {
	INIT_LOGD(" Layers updates debug enabled: %s", property);
	debugLayersUpdates = !strcmp(property, "true");
	} else {
	debugLayersUpdates = false;
	}

	debugOverdraw = false;
	if (property_get(PROPERTY_DEBUG_OVERDRAW, property, NULL) > 0) {
	INIT_LOGD(" Overdraw debug enabled: %s", property);
	if (!strcmp(property, "show")) {
	debugOverdraw = true;
	mOverdrawDebugColorSet = kColorSet_Default;
	} else if (!strcmp(property, "show_deuteranomaly")) {
	debugOverdraw = true;
	mOverdrawDebugColorSet = kColorSet_Deuteranomaly;
	}
	}

	// See Properties.h for valid values
	if (property_get(PROPERTY_DEBUG_STENCIL_CLIP, property, NULL) > 0) {
	INIT_LOGD(" Stencil clip debug enabled: %s", property);
	if (!strcmp(property, "hide")) {
	debugStencilClip = kStencilHide;
	} else if (!strcmp(property, "highlight")) {
	debugStencilClip = kStencilShowHighlight;
	} else if (!strcmp(property, "region")) {
	debugStencilClip = kStencilShowRegion;
	}
	} else {
	debugStencilClip = kStencilHide;
	}

	if (property_get(PROPERTY_DISABLE_DRAW_DEFER, property, "false")) {
	drawDeferDisabled = !strcasecmp(property, "true");
	INIT_LOGD(" Draw defer %s", drawDeferDisabled ? "disabled" : "enabled");
	} else {
	INIT_LOGD(" Draw defer enabled");
	}

	if (property_get(PROPERTY_DISABLE_DRAW_REORDER, property, "false")) {
	drawReorderDisabled = !strcasecmp(property, "true");
	INIT_LOGD(" Draw reorder %s", drawReorderDisabled ? "disabled" : "enabled");
	} else {
	INIT_LOGD(" Draw reorder enabled");
	}

	return (prevDebugLayersUpdates != debugLayersUpdates) \|\|
	(prevDebugOverdraw != debugOverdraw) \|\|
	(prevDebugStencilClip != debugStencilClip);
	}

	void Caches::terminate() {
	if (!mInitialized) return;

	glDeleteBuffers(1, &meshBuffer);
	mCurrentBuffer = 0;

	glDeleteBuffers(1, &mMeshIndices);
	delete[] mRegionMesh;
	mMeshIndices = 0;
	mRegionMesh = NULL;

	fboCache.clear();

	programCache.clear();
	currentProgram = NULL;

	assetAtlas.terminate();

	patchCache.clear();

	clearGarbage();

	mInitialized = false;
	}

	///////////////////////////////////////////////////////////////////////////////
	// Debug
	///////////////////////////////////////////////////////////////////////////////

	uint32_t Caches::getOverdrawColor(uint32_t amount) const {
	static uint32_t sOverdrawColors[2][4] = {
	{ 0x2f0000ff, 0x2f00ff00, 0x3fff0000, 0x7fff0000 },
	{ 0x2f0000ff, 0x4fffff00, 0x5fff8ad8, 0x7fff0000 }
	};
	if (amount < 1) amount = 1;
	if (amount > 4) amount = 4;
	return sOverdrawColors[mOverdrawDebugColorSet][amount - 1];
	}

	void Caches::dumpMemoryUsage() {
	String8 stringLog;
	dumpMemoryUsage(stringLog);
	ALOGD("%s", stringLog.string());
	}

	void Caches::dumpMemoryUsage(String8 &log) {
	log.appendFormat("Current memory usage / total memory usage (bytes):\n");
	log.appendFormat(" TextureCache %8d / %8d\n",
	textureCache.getSize(), textureCache.getMaxSize());
	log.appendFormat(" LayerCache %8d / %8d\n",
	layerCache.getSize(), layerCache.getMaxSize());
	log.appendFormat(" RenderBufferCache %8d / %8d\n",
	renderBufferCache.getSize(), renderBufferCache.getMaxSize());
	log.appendFormat(" GradientCache %8d / %8d\n",
	gradientCache.getSize(), gradientCache.getMaxSize());
	log.appendFormat(" PathCache %8d / %8d\n",
	pathCache.getSize(), pathCache.getMaxSize());
	log.appendFormat(" TextDropShadowCache %8d / %8d\n", dropShadowCache.getSize(),
	dropShadowCache.getMaxSize());
	log.appendFormat(" PatchCache %8d / %8d\n",
	patchCache.getSize(), patchCache.getMaxSize());
	for (uint32_t i = 0; i < fontRenderer->getFontRendererCount(); i++) {
	const uint32_t sizeA8 = fontRenderer->getFontRendererSize(i, GL_ALPHA);
	const uint32_t sizeRGBA = fontRenderer->getFontRendererSize(i, GL_RGBA);
	log.appendFormat(" FontRenderer %d A8 %8d / %8d\n", i, sizeA8, sizeA8);
	log.appendFormat(" FontRenderer %d RGBA %8d / %8d\n", i, sizeRGBA, sizeRGBA);
	log.appendFormat(" FontRenderer %d total %8d / %8d\n", i, sizeA8 + sizeRGBA,
	sizeA8 + sizeRGBA);
	}
	log.appendFormat("Other:\n");
	log.appendFormat(" FboCache %8d / %8d\n",
	fboCache.getSize(), fboCache.getMaxSize());

	uint32_t total = 0;
	total += textureCache.getSize();
	total += layerCache.getSize();
	total += renderBufferCache.getSize();
	total += gradientCache.getSize();
	total += pathCache.getSize();
	total += dropShadowCache.getSize();
	total += patchCache.getSize();
	for (uint32_t i = 0; i < fontRenderer->getFontRendererCount(); i++) {
	total += fontRenderer->getFontRendererSize(i, GL_ALPHA);
	total += fontRenderer->getFontRendererSize(i, GL_RGBA);
	}

	log.appendFormat("Total memory usage:\n");
	log.appendFormat(" %d bytes, %.2f MB\n", total, total / 1024.0f / 1024.0f);
	}

	///////////////////////////////////////////////////////////////////////////////
	// Memory management
	///////////////////////////////////////////////////////////////////////////////

	void Caches::clearGarbage() {
	textureCache.clearGarbage();
	pathCache.clearGarbage();
	patchCache.clearGarbage();

	Vector<DisplayList*> displayLists;
	Vector<Layer*> layers;

	{ // scope for the lock
	Mutex::Autolock _l(mGarbageLock);
	displayLists = mDisplayListGarbage;
	layers = mLayerGarbage;
	mDisplayListGarbage.clear();
	mLayerGarbage.clear();
	}

	size_t count = displayLists.size();
	for (size_t i = 0; i < count; i++) {
	DisplayList* displayList = displayLists.itemAt(i);
	delete displayList;
	}

	count = layers.size();
	for (size_t i = 0; i < count; i++) {
	Layer* layer = layers.itemAt(i);
	delete layer;
	}
	layers.clear();
	}

	void Caches::deleteLayerDeferred(Layer* layer) {
	Mutex::Autolock _l(mGarbageLock);
	mLayerGarbage.push(layer);
	}

	void Caches::deleteDisplayListDeferred(DisplayList* displayList) {
	Mutex::Autolock _l(mGarbageLock);
	mDisplayListGarbage.push(displayList);
	}

	void Caches::flush(FlushMode mode) {
	FLUSH_LOGD("Flushing caches (mode %d)", mode);

	// We must stop tasks before clearing caches
	if (mode > kFlushMode_Layers) {
	tasks.stop();
	}

	switch (mode) {
	case kFlushMode_Full:
	textureCache.clear();
	patchCache.clear();
	dropShadowCache.clear();
	gradientCache.clear();
	fontRenderer->clear();
	fboCache.clear();
	dither.clear();
	// fall through
	case kFlushMode_Moderate:
	fontRenderer->flush();
	textureCache.flush();
	pathCache.clear();
	// fall through
	case kFlushMode_Layers:
	layerCache.clear();
	renderBufferCache.clear();
	break;
	}

	clearGarbage();
	}

	///////////////////////////////////////////////////////////////////////////////
	// VBO
	///////////////////////////////////////////////////////////////////////////////

	bool Caches::bindMeshBuffer() {
	return bindMeshBuffer(meshBuffer);
	}

	bool Caches::bindMeshBuffer(const GLuint buffer) {
	if (mCurrentBuffer != buffer) {
	glBindBuffer(GL_ARRAY_BUFFER, buffer);
	mCurrentBuffer = buffer;
	return true;
	}
	return false;
	}

	bool Caches::unbindMeshBuffer() {
	if (mCurrentBuffer) {
	glBindBuffer(GL_ARRAY_BUFFER, 0);
	mCurrentBuffer = 0;
	return true;
	}
	return false;
	}

	bool Caches::bindIndicesBuffer(const GLuint buffer) {
	if (mCurrentIndicesBuffer != buffer) {
	glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, buffer);
	mCurrentIndicesBuffer = buffer;
	return true;
	}
	return false;
	}

	bool Caches::bindIndicesBuffer() {
	if (!mMeshIndices) {
	uint16_t* regionIndices = new uint16_t[gMaxNumberOfQuads * 6];
	for (uint32_t i = 0; i < gMaxNumberOfQuads; i++) {
	uint16_t quad = i * 4;
	int index = i * 6;
	regionIndices[index ] = quad; // top-left
	regionIndices[index + 1] = quad + 1; // top-right
	regionIndices[index + 2] = quad + 2; // bottom-left
	regionIndices[index + 3] = quad + 2; // bottom-left
	regionIndices[index + 4] = quad + 1; // top-right
	regionIndices[index + 5] = quad + 3; // bottom-right
	}

	glGenBuffers(1, &mMeshIndices);
	bool force = bindIndicesBuffer(mMeshIndices);
	glBufferData(GL_ELEMENT_ARRAY_BUFFER, gMaxNumberOfQuads * 6 * sizeof(uint16_t),
	regionIndices, GL_STATIC_DRAW);

	delete[] regionIndices;
	return force;
	}

	return bindIndicesBuffer(mMeshIndices);
	}

	bool Caches::unbindIndicesBuffer() {
	if (mCurrentIndicesBuffer) {
	glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, 0);
	mCurrentIndicesBuffer = 0;
	return true;
	}
	return false;
	}

	///////////////////////////////////////////////////////////////////////////////
	// PBO
	///////////////////////////////////////////////////////////////////////////////

	bool Caches::bindPixelBuffer(const GLuint buffer) {
	if (mCurrentPixelBuffer != buffer) {
	glBindBuffer(GL_PIXEL_UNPACK_BUFFER, buffer);
	mCurrentPixelBuffer = buffer;
	return true;
	}
	return false;
	}

	bool Caches::unbindPixelBuffer() {
	if (mCurrentPixelBuffer) {
	glBindBuffer(GL_PIXEL_UNPACK_BUFFER, 0);
	mCurrentPixelBuffer = 0;
	return true;
	}
	return false;
	}

	///////////////////////////////////////////////////////////////////////////////
	// Meshes and textures
	///////////////////////////////////////////////////////////////////////////////

	void Caches::bindPositionVertexPointer(bool force, GLvoid* vertices, GLsizei stride) {
	if (force \|\| vertices != mCurrentPositionPointer \|\| stride != mCurrentPositionStride) {
	GLuint slot = currentProgram->position;
	glVertexAttribPointer(slot, 2, GL_FLOAT, GL_FALSE, stride, vertices);
	mCurrentPositionPointer = vertices;
	mCurrentPositionStride = stride;
	}
	}

	void Caches::bindTexCoordsVertexPointer(bool force, GLvoid* vertices, GLsizei stride) {
	if (force \|\| vertices != mCurrentTexCoordsPointer \|\| stride != mCurrentTexCoordsStride) {
	GLuint slot = currentProgram->texCoords;
	glVertexAttribPointer(slot, 2, GL_FLOAT, GL_FALSE, stride, vertices);
	mCurrentTexCoordsPointer = vertices;
	mCurrentTexCoordsStride = stride;
	}
	}

	void Caches::resetVertexPointers() {
	mCurrentPositionPointer = this;
	mCurrentTexCoordsPointer = this;
	}

	void Caches::resetTexCoordsVertexPointer() {
	mCurrentTexCoordsPointer = this;
	}

	void Caches::enableTexCoordsVertexArray() {
	if (!mTexCoordsArrayEnabled) {
	glEnableVertexAttribArray(Program::kBindingTexCoords);
	mCurrentTexCoordsPointer = this;
	mTexCoordsArrayEnabled = true;
	}
	}

	void Caches::disableTexCoordsVertexArray() {
	if (mTexCoordsArrayEnabled) {
	glDisableVertexAttribArray(Program::kBindingTexCoords);
	mTexCoordsArrayEnabled = false;
	}
	}

	void Caches::activeTexture(GLuint textureUnit) {
	if (mTextureUnit != textureUnit) {
	glActiveTexture(gTextureUnits[textureUnit]);
	mTextureUnit = textureUnit;
	}
	}

	void Caches::resetActiveTexture() {
	mTextureUnit = -1;
	}

	void Caches::bindTexture(GLuint texture) {
	if (mBoundTextures[mTextureUnit] != texture) {
	glBindTexture(GL_TEXTURE_2D, texture);
	mBoundTextures[mTextureUnit] = texture;
	}
	}

	void Caches::bindTexture(GLenum target, GLuint texture) {
	if (mBoundTextures[mTextureUnit] != texture) {
	glBindTexture(target, texture);
	mBoundTextures[mTextureUnit] = texture;
	}
	}

	void Caches::deleteTexture(GLuint texture) {
	// When glDeleteTextures() is called on a currently bound texture,
	// OpenGL ES specifies that the texture is then considered unbound
	// Consider the following series of calls:
	//
	// glGenTextures -> creates texture name 2
	// glBindTexture(2)
	// glDeleteTextures(2) -> 2 is now unbound
	// glGenTextures -> can return 2 again
	//
	// If we don't call glBindTexture(2) after the second glGenTextures
	// call, any texture operation will be performed on the default
	// texture (name=0)

	for (int i = 0; i < REQUIRED_TEXTURE_UNITS_COUNT; i++) {
	if (mBoundTextures[i] == texture) {
	mBoundTextures[i] = 0;
	}
	}
	glDeleteTextures(1, &texture);
	}

	void Caches::resetBoundTextures() {
	memset(mBoundTextures, 0, REQUIRED_TEXTURE_UNITS_COUNT * sizeof(GLuint));
	}

	///////////////////////////////////////////////////////////////////////////////
	// Scissor
	///////////////////////////////////////////////////////////////////////////////

	bool Caches::setScissor(GLint x, GLint y, GLint width, GLint height) {
	if (scissorEnabled && (x != mScissorX \|\| y != mScissorY \|\|
	width != mScissorWidth \|\| height != mScissorHeight)) {

	if (x < 0) {
	width += x;
	x = 0;
	}
	if (y < 0) {
	height += y;
	y = 0;
	}
	if (width < 0) {
	width = 0;
	}
	if (height < 0) {
	height = 0;
	}
	glScissor(x, y, width, height);

	mScissorX = x;
	mScissorY = y;
	mScissorWidth = width;
	mScissorHeight = height;

	return true;
	}
	return false;
	}

	bool Caches::enableScissor() {
	if (!scissorEnabled) {
	glEnable(GL_SCISSOR_TEST);
	scissorEnabled = true;
	resetScissor();
	return true;
	}
	return false;
	}

	bool Caches::disableScissor() {
	if (scissorEnabled) {
	glDisable(GL_SCISSOR_TEST);
	scissorEnabled = false;
	return true;
	}
	return false;
	}

	void Caches::setScissorEnabled(bool enabled) {
	if (scissorEnabled != enabled) {
	if (enabled) glEnable(GL_SCISSOR_TEST);
	else glDisable(GL_SCISSOR_TEST);
	scissorEnabled = enabled;
	}
	}

	void Caches::resetScissor() {
	mScissorX = mScissorY = mScissorWidth = mScissorHeight = 0;
	}

	///////////////////////////////////////////////////////////////////////////////
	// Tiling
	///////////////////////////////////////////////////////////////////////////////

	void Caches::startTiling(GLuint x, GLuint y, GLuint width, GLuint height, bool discard) {
	if (mExtensions.hasTiledRendering() && !debugOverdraw) {
	glStartTilingQCOM(x, y, width, height, (discard ? GL_NONE : GL_COLOR_BUFFER_BIT0_QCOM));
	}
	}

	void Caches::endTiling() {
	if (mExtensions.hasTiledRendering() && !debugOverdraw) {
	glEndTilingQCOM(GL_COLOR_BUFFER_BIT0_QCOM);
	}
	}

	bool Caches::hasRegisteredFunctors() {
	return mFunctorsCount > 0;
	}

	void Caches::registerFunctors(uint32_t functorCount) {
	mFunctorsCount += functorCount;
	}

	void Caches::unregisterFunctors(uint32_t functorCount) {
	if (functorCount > mFunctorsCount) {
	mFunctorsCount = 0;
	} else {
	mFunctorsCount -= functorCount;
	}
	}

	///////////////////////////////////////////////////////////////////////////////
	// Regions
	///////////////////////////////////////////////////////////////////////////////

	TextureVertex* Caches::getRegionMesh() {
	// Create the mesh, 2 triangles and 4 vertices per rectangle in the region
	if (!mRegionMesh) {
	mRegionMesh = new TextureVertex[gMaxNumberOfQuads * 4];
	}

	return mRegionMesh;
	}

	}; // namespace uirenderer
	}; // namespace android