Home | History | Annotate | Download | only in ui
      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 
     62     static inline GraphicBufferAllocator& get() { return getInstance(); }
     63 
     64 
     65     status_t alloc(uint32_t w, uint32_t h, PixelFormat format, int usage,
     66             buffer_handle_t* handle, int32_t* stride);
     67 
     68     status_t free(buffer_handle_t handle);
     69 
     70     void dump(String8& res) const;
     71 
     72 private:
     73     struct alloc_rec_t {
     74         uint32_t w;
     75         uint32_t h;
     76         PixelFormat format;
     77         uint32_t usage;
     78         void* vaddr;
     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