/*
* Copyright (C) 2013 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.
*/
#ifndef ANDROID_HWUI_RENDER_BUFFER_CACHE_H
#define ANDROID_HWUI_RENDER_BUFFER_CACHE_H
#include <GLES2/gl2.h>
#include "RenderBuffer.h"
#include <set>
namespace android {
namespace uirenderer {
class RenderBufferCache {
public:
RenderBufferCache();
~RenderBufferCache();
/**
* Returns a buffer with the exact specified dimensions. If no suitable
* buffer can be found, a new one is created and returned. If creating a
* new buffer fails, NULL is returned.
*
* When a buffer is obtained from the cache, it is removed and the total
* size of the cache goes down.
*
* The returned buffer is always allocated and bound
* (see RenderBuffer::isAllocated()).
*
* @param format The desired render buffer format
* @param width The desired width of the buffer
* @param height The desired height of the buffer
*/
RenderBuffer* get(GLenum format, const uint32_t width, const uint32_t height);
/**
* Adds the buffer to the cache. The buffer will not be added if there is
* not enough space available. Adding a buffer can cause other buffer to
* be removed from the cache.
*
* @param buffer The render buffer to add to the cache
*
* @return True if the buffer was added, false otherwise.
*/
bool put(RenderBuffer* buffer);
/**
* Clears the cache. This causes all layers to be deleted.
*/
void clear();
/**
* Returns the maximum size of the cache in bytes.
*/
uint32_t getMaxSize();
/**
* Returns the current size of the cache in bytes.
*/
uint32_t getSize();
private:
struct RenderBufferEntry {
RenderBufferEntry():
mBuffer(nullptr), mWidth(0), mHeight(0) {
}
RenderBufferEntry(GLenum format, const uint32_t width, const uint32_t height):
mBuffer(nullptr), mFormat(format), mWidth(width), mHeight(height) {
}
RenderBufferEntry(RenderBuffer* buffer):
mBuffer(buffer), mFormat(buffer->getFormat()),
mWidth(buffer->getWidth()), mHeight(buffer->getHeight()) {
}
static int compare(const RenderBufferEntry& lhs, const RenderBufferEntry& rhs);
bool operator==(const RenderBufferEntry& other) const {
return compare(*this, other) == 0;
}
bool operator!=(const RenderBufferEntry& other) const {
return compare(*this, other) != 0;
}
bool operator<(const RenderBufferEntry& other) const {
return RenderBufferEntry::compare(*this, other) < 0;
}
RenderBuffer* mBuffer;
GLenum mFormat;
uint32_t mWidth;
uint32_t mHeight;
}; // struct RenderBufferEntry
void deleteBuffer(RenderBuffer* buffer);
std::multiset<RenderBufferEntry> mCache;
uint32_t mSize;
uint32_t mMaxSize;
}; // class RenderBufferCache
}; // namespace uirenderer
}; // namespace android
#endif // ANDROID_HWUI_RENDER_BUFFER_CACHE_H