GraphicBuffer.h revision 697526bc9e44ce61c88614f98387ae8bbf0a187e
13330b203039dea366d4981db1408a460134b2d2cMathias Agopian/* 23330b203039dea366d4981db1408a460134b2d2cMathias Agopian * Copyright (C) 2007 The Android Open Source Project 33330b203039dea366d4981db1408a460134b2d2cMathias Agopian * 43330b203039dea366d4981db1408a460134b2d2cMathias Agopian * Licensed under the Apache License, Version 2.0 (the "License"); 53330b203039dea366d4981db1408a460134b2d2cMathias Agopian * you may not use this file except in compliance with the License. 63330b203039dea366d4981db1408a460134b2d2cMathias Agopian * You may obtain a copy of the License at 73330b203039dea366d4981db1408a460134b2d2cMathias Agopian * 83330b203039dea366d4981db1408a460134b2d2cMathias Agopian * http://www.apache.org/licenses/LICENSE-2.0 93330b203039dea366d4981db1408a460134b2d2cMathias Agopian * 103330b203039dea366d4981db1408a460134b2d2cMathias Agopian * Unless required by applicable law or agreed to in writing, software 113330b203039dea366d4981db1408a460134b2d2cMathias Agopian * distributed under the License is distributed on an "AS IS" BASIS, 123330b203039dea366d4981db1408a460134b2d2cMathias Agopian * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 133330b203039dea366d4981db1408a460134b2d2cMathias Agopian * See the License for the specific language governing permissions and 143330b203039dea366d4981db1408a460134b2d2cMathias Agopian * limitations under the License. 153330b203039dea366d4981db1408a460134b2d2cMathias Agopian */ 163330b203039dea366d4981db1408a460134b2d2cMathias Agopian 173330b203039dea366d4981db1408a460134b2d2cMathias Agopian#ifndef ANDROID_GRAPHIC_BUFFER_H 183330b203039dea366d4981db1408a460134b2d2cMathias Agopian#define ANDROID_GRAPHIC_BUFFER_H 193330b203039dea366d4981db1408a460134b2d2cMathias Agopian 203330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <stdint.h> 213330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <sys/types.h> 223330b203039dea366d4981db1408a460134b2d2cMathias Agopian 233330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <ui/android_native_buffer.h> 243330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <ui/PixelFormat.h> 253330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <ui/Rect.h> 2698e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian#include <utils/Flattenable.h> 273330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <pixelflinger/pixelflinger.h> 283330b203039dea366d4981db1408a460134b2d2cMathias Agopian 29697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchevstruct ANativeWindowBuffer; 303330b203039dea366d4981db1408a460134b2d2cMathias Agopian 313330b203039dea366d4981db1408a460134b2d2cMathias Agopiannamespace android { 323330b203039dea366d4981db1408a460134b2d2cMathias Agopian 333330b203039dea366d4981db1408a460134b2d2cMathias Agopianclass GraphicBufferMapper; 343330b203039dea366d4981db1408a460134b2d2cMathias Agopian 353330b203039dea366d4981db1408a460134b2d2cMathias Agopian// =========================================================================== 363330b203039dea366d4981db1408a460134b2d2cMathias Agopian// GraphicBuffer 373330b203039dea366d4981db1408a460134b2d2cMathias Agopian// =========================================================================== 383330b203039dea366d4981db1408a460134b2d2cMathias Agopian 393330b203039dea366d4981db1408a460134b2d2cMathias Agopianclass GraphicBuffer 403330b203039dea366d4981db1408a460134b2d2cMathias Agopian : public EGLNativeBase< 41697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev ANativeWindowBuffer, 423330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer, 4398e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian LightRefBase<GraphicBuffer> >, public Flattenable 443330b203039dea366d4981db1408a460134b2d2cMathias Agopian{ 453330b203039dea366d4981db1408a460134b2d2cMathias Agopianpublic: 463330b203039dea366d4981db1408a460134b2d2cMathias Agopian 473330b203039dea366d4981db1408a460134b2d2cMathias Agopian enum { 483330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SW_READ_NEVER = GRALLOC_USAGE_SW_READ_NEVER, 493330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SW_READ_RARELY = GRALLOC_USAGE_SW_READ_RARELY, 503330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SW_READ_OFTEN = GRALLOC_USAGE_SW_READ_OFTEN, 513330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SW_READ_MASK = GRALLOC_USAGE_SW_READ_MASK, 523330b203039dea366d4981db1408a460134b2d2cMathias Agopian 533330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SW_WRITE_NEVER = GRALLOC_USAGE_SW_WRITE_NEVER, 543330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SW_WRITE_RARELY = GRALLOC_USAGE_SW_WRITE_RARELY, 553330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SW_WRITE_OFTEN = GRALLOC_USAGE_SW_WRITE_OFTEN, 563330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SW_WRITE_MASK = GRALLOC_USAGE_SW_WRITE_MASK, 5716f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten 583330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_SOFTWARE_MASK = USAGE_SW_READ_MASK|USAGE_SW_WRITE_MASK, 5916f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten 6016f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten USAGE_PROTECTED = GRALLOC_USAGE_PROTECTED, 6116f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten 623330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_HW_TEXTURE = GRALLOC_USAGE_HW_TEXTURE, 633330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_HW_RENDER = GRALLOC_USAGE_HW_RENDER, 643330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_HW_2D = GRALLOC_USAGE_HW_2D, 653330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_HW_MASK = GRALLOC_USAGE_HW_MASK 663330b203039dea366d4981db1408a460134b2d2cMathias Agopian }; 673330b203039dea366d4981db1408a460134b2d2cMathias Agopian 683330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer(); 693330b203039dea366d4981db1408a460134b2d2cMathias Agopian 703330b203039dea366d4981db1408a460134b2d2cMathias Agopian // creates w * h buffer 7154ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian GraphicBuffer(uint32_t w, uint32_t h, PixelFormat format, uint32_t usage); 7254ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian 7354ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian // create a buffer from an existing handle 7454ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian GraphicBuffer(uint32_t w, uint32_t h, PixelFormat format, uint32_t usage, 7554ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian uint32_t stride, native_handle_t* handle, bool keepOwnership); 763330b203039dea366d4981db1408a460134b2d2cMathias Agopian 77697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev // create a buffer from an existing ANativeWindowBuffer 78697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev GraphicBuffer(ANativeWindowBuffer* buffer, bool keepOwnership); 79309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis 803330b203039dea366d4981db1408a460134b2d2cMathias Agopian // return status 813330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t initCheck() const; 823330b203039dea366d4981db1408a460134b2d2cMathias Agopian 833330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getWidth() const { return width; } 843330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getHeight() const { return height; } 853330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getStride() const { return stride; } 863330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getUsage() const { return usage; } 873330b203039dea366d4981db1408a460134b2d2cMathias Agopian PixelFormat getPixelFormat() const { return format; } 883330b203039dea366d4981db1408a460134b2d2cMathias Agopian Rect getBounds() const { return Rect(width, height); } 893330b203039dea366d4981db1408a460134b2d2cMathias Agopian 903330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t reallocate(uint32_t w, uint32_t h, PixelFormat f, uint32_t usage); 913330b203039dea366d4981db1408a460134b2d2cMathias Agopian 923330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t lock(uint32_t usage, void** vaddr); 933330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t lock(uint32_t usage, const Rect& rect, void** vaddr); 943330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t lock(GGLSurface* surface, uint32_t usage); 953330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t unlock(); 96678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian 97697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev ANativeWindowBuffer* getNativeBuffer() const; 983330b203039dea366d4981db1408a460134b2d2cMathias Agopian 993330b203039dea366d4981db1408a460134b2d2cMathias Agopian void setIndex(int index); 1003330b203039dea366d4981db1408a460134b2d2cMathias Agopian int getIndex() const; 1013330b203039dea366d4981db1408a460134b2d2cMathias Agopian 102678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian // for debugging 103678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian static void dumpAllocationsToSystemLog(); 104678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian 105b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopianprivate: 1063330b203039dea366d4981db1408a460134b2d2cMathias Agopian virtual ~GraphicBuffer(); 1073330b203039dea366d4981db1408a460134b2d2cMathias Agopian 10854ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian enum { 10954ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownNone = 0, 11054ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownHandle = 1, 11154ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownData = 2, 11254ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian }; 11354ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian 114b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian inline const GraphicBufferMapper& getBufferMapper() const { 115b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian return mBufferMapper; 116b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian } 117b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian inline GraphicBufferMapper& getBufferMapper() { 118b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian return mBufferMapper; 119b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian } 12054ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian uint8_t mOwner; 1213330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1223330b203039dea366d4981db1408a460134b2d2cMathias Agopianprivate: 1233330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class Surface; 1243330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class BpSurface; 1253330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class BnSurface; 1268ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis friend class SurfaceTextureClient; 1273330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class LightRefBase<GraphicBuffer>; 1283330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer(const GraphicBuffer& rhs); 1293330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer& operator = (const GraphicBuffer& rhs); 1303330b203039dea366d4981db1408a460134b2d2cMathias Agopian const GraphicBuffer& operator = (const GraphicBuffer& rhs) const; 1313330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1323330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t initSize(uint32_t w, uint32_t h, PixelFormat format, 1333330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t usage); 1343330b203039dea366d4981db1408a460134b2d2cMathias Agopian 13598e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian void free_handle(); 13698e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian 13798e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian // Flattenable interface 13898e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian size_t getFlattenedSize() const; 13998e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian size_t getFdCount() const; 14098e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian status_t flatten(void* buffer, size_t size, 14198e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian int fds[], size_t count) const; 14298e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian status_t unflatten(void const* buffer, size_t size, 14398e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian int fds[], size_t count); 14498e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian 1453330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1463330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBufferMapper& mBufferMapper; 1473330b203039dea366d4981db1408a460134b2d2cMathias Agopian ssize_t mInitCheck; 1483330b203039dea366d4981db1408a460134b2d2cMathias Agopian int mIndex; 149309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis 150309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis // If we're wrapping another buffer then this reference will make sure it 151309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis // doesn't get freed. 152697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev sp<ANativeWindowBuffer> mWrappedBuffer; 1533330b203039dea366d4981db1408a460134b2d2cMathias Agopian}; 1543330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1553330b203039dea366d4981db1408a460134b2d2cMathias Agopian}; // namespace android 1563330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1573330b203039dea366d4981db1408a460134b2d2cMathias Agopian#endif // ANDROID_GRAPHIC_BUFFER_H 158