summaryrefslogtreecommitdiffstats
path: root/libs/hwui/RenderBufferCache.h
blob: 6c668b09c40dd06ac0e16cc7c3e9abf32a931ca9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
/*
 * 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 "utils/SortedList.h"

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();

    /**
     * Sets the maximum size of the cache in bytes.
     */
    void setMaxSize(uint32_t maxSize);
    /**
     * 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;
        }

        friend inline int strictly_order_type(const RenderBufferEntry& lhs,
                const RenderBufferEntry& rhs) {
            return RenderBufferEntry::compare(lhs, rhs) < 0;
        }

        friend inline int compare_type(const RenderBufferEntry& lhs,
                const RenderBufferEntry& rhs) {
            return RenderBufferEntry::compare(lhs, rhs);
        }

        RenderBuffer* mBuffer;
        GLenum mFormat;
        uint32_t mWidth;
        uint32_t mHeight;
    }; // struct RenderBufferEntry

    void deleteBuffer(RenderBuffer* buffer);

    SortedList<RenderBufferEntry> mCache;

    uint32_t mSize;
    uint32_t mMaxSize;
}; // class RenderBufferCache

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

#endif // ANDROID_HWUI_RENDER_BUFFER_CACHE_H