1 /*
2 **
3 ** Copyright 2009, The Android Open Source Project
4 **
5 ** Licensed under the Apache License, Version 2.0 (the "License");
6 ** you may not use this file except in compliance with the License.
7 ** You may obtain a copy of the License at
8 **
9 **     http://www.apache.org/licenses/LICENSE-2.0
10 **
11 ** Unless required by applicable law or agreed to in writing, software
12 ** distributed under the License is distributed on an "AS IS" BASIS,
13 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 ** See the License for the specific language governing permissions and
15 ** limitations under the License.
16 */
17 
18 #ifndef ANDROID_BUFFER_ALLOCATOR_H
19 #define ANDROID_BUFFER_ALLOCATOR_H
20 
21 #include <stdint.h>
22 
23 #include <cutils/native_handle.h>
24 
25 #include <utils/Errors.h>
26 #include <utils/KeyedVector.h>
27 #include <utils/threads.h>
28 #include <utils/Singleton.h>
29 
30 #include <ui/PixelFormat.h>
31 
32 #include <hardware/gralloc.h>
33 
34 
35 namespace android {
36 // ---------------------------------------------------------------------------
37 
38 class String8;
39 
40 class GraphicBufferAllocator : public Singleton<GraphicBufferAllocator>
41 {
42 public:
43     enum {
44         USAGE_SW_READ_NEVER     = GRALLOC_USAGE_SW_READ_NEVER,
45         USAGE_SW_READ_RARELY    = GRALLOC_USAGE_SW_READ_RARELY,
46         USAGE_SW_READ_OFTEN     = GRALLOC_USAGE_SW_READ_OFTEN,
47         USAGE_SW_READ_MASK      = GRALLOC_USAGE_SW_READ_MASK,
48 
49         USAGE_SW_WRITE_NEVER    = GRALLOC_USAGE_SW_WRITE_NEVER,
50         USAGE_SW_WRITE_RARELY   = GRALLOC_USAGE_SW_WRITE_RARELY,
51         USAGE_SW_WRITE_OFTEN    = GRALLOC_USAGE_SW_WRITE_OFTEN,
52         USAGE_SW_WRITE_MASK     = GRALLOC_USAGE_SW_WRITE_MASK,
53 
54         USAGE_SOFTWARE_MASK     = USAGE_SW_READ_MASK|USAGE_SW_WRITE_MASK,
55 
56         USAGE_HW_TEXTURE        = GRALLOC_USAGE_HW_TEXTURE,
57         USAGE_HW_RENDER         = GRALLOC_USAGE_HW_RENDER,
58         USAGE_HW_2D             = GRALLOC_USAGE_HW_2D,
59         USAGE_HW_MASK           = GRALLOC_USAGE_HW_MASK
60     };
61 
get()62     static inline GraphicBufferAllocator& get() { return getInstance(); }
63 
64     status_t alloc(uint32_t w, uint32_t h, PixelFormat format, uint32_t usage,
65             buffer_handle_t* handle, uint32_t* stride);
66 
67     status_t free(buffer_handle_t handle);
68 
69     void dump(String8& res) const;
70     static void dumpToSystemLog();
71 
72 private:
73     struct alloc_rec_t {
74         uint32_t width;
75         uint32_t height;
76         uint32_t stride;
77         PixelFormat format;
78         uint32_t usage;
79         size_t size;
80     };
81 
82     static Mutex sLock;
83     static KeyedVector<buffer_handle_t, alloc_rec_t> sAllocList;
84 
85     friend class Singleton<GraphicBufferAllocator>;
86     GraphicBufferAllocator();
87     ~GraphicBufferAllocator();
88 
89     alloc_device_t  *mAllocDev;
90 };
91 
92 // ---------------------------------------------------------------------------
93 }; // namespace android
94 
95 #endif // ANDROID_BUFFER_ALLOCATOR_H
96