GraphicBuffer.h revision 5f2165f9455d4893b581b73a67c5431f4344b47e
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 235f2165f9455d4893b581b73a67c5431f4344b47eMathias Agopian#include <ui/ANativeObjectBase.h> 243330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <ui/PixelFormat.h> 253330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <ui/Rect.h> 2698e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian#include <utils/Flattenable.h> 275f2165f9455d4893b581b73a67c5431f4344b47eMathias Agopian 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 405f2165f9455d4893b581b73a67c5431f4344b47eMathias Agopian : public ANativeObjectBase< 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, 653599bf2c0727bc33e8136f5163eee6f398545e05Jamie Gennis USAGE_HW_COMPOSER = GRALLOC_USAGE_HW_COMPOSER, 66b7d87c40ef3f922fb10f6a4f24e6e1437ab3c7aeJamie Gennis USAGE_HW_VIDEO_ENCODER = GRALLOC_USAGE_HW_VIDEO_ENCODER, 673330b203039dea366d4981db1408a460134b2d2cMathias Agopian USAGE_HW_MASK = GRALLOC_USAGE_HW_MASK 683330b203039dea366d4981db1408a460134b2d2cMathias Agopian }; 693330b203039dea366d4981db1408a460134b2d2cMathias Agopian 703330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer(); 713330b203039dea366d4981db1408a460134b2d2cMathias Agopian 723330b203039dea366d4981db1408a460134b2d2cMathias Agopian // creates w * h buffer 7354ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian GraphicBuffer(uint32_t w, uint32_t h, PixelFormat format, uint32_t usage); 7454ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian 7554ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian // create a buffer from an existing handle 7654ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian GraphicBuffer(uint32_t w, uint32_t h, PixelFormat format, uint32_t usage, 7754ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian uint32_t stride, native_handle_t* handle, bool keepOwnership); 783330b203039dea366d4981db1408a460134b2d2cMathias Agopian 79697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev // create a buffer from an existing ANativeWindowBuffer 80697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev GraphicBuffer(ANativeWindowBuffer* buffer, bool keepOwnership); 81309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis 823330b203039dea366d4981db1408a460134b2d2cMathias Agopian // return status 833330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t initCheck() const; 843330b203039dea366d4981db1408a460134b2d2cMathias Agopian 853330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getWidth() const { return width; } 863330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getHeight() const { return height; } 873330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getStride() const { return stride; } 883330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getUsage() const { return usage; } 893330b203039dea366d4981db1408a460134b2d2cMathias Agopian PixelFormat getPixelFormat() const { return format; } 903330b203039dea366d4981db1408a460134b2d2cMathias Agopian Rect getBounds() const { return Rect(width, height); } 913330b203039dea366d4981db1408a460134b2d2cMathias Agopian 923330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t reallocate(uint32_t w, uint32_t h, PixelFormat f, uint32_t usage); 933330b203039dea366d4981db1408a460134b2d2cMathias Agopian 943330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t lock(uint32_t usage, void** vaddr); 953330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t lock(uint32_t usage, const Rect& rect, void** vaddr); 963330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t unlock(); 97678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian 98697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev ANativeWindowBuffer* getNativeBuffer() const; 993330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1003330b203039dea366d4981db1408a460134b2d2cMathias Agopian void setIndex(int index); 1013330b203039dea366d4981db1408a460134b2d2cMathias Agopian int getIndex() const; 1023330b203039dea366d4981db1408a460134b2d2cMathias Agopian 103678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian // for debugging 104678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian static void dumpAllocationsToSystemLog(); 105678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian 106b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopianprivate: 1073330b203039dea366d4981db1408a460134b2d2cMathias Agopian virtual ~GraphicBuffer(); 1083330b203039dea366d4981db1408a460134b2d2cMathias Agopian 10954ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian enum { 11054ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownNone = 0, 11154ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownHandle = 1, 11254ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownData = 2, 11354ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian }; 11454ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian 115b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian inline const GraphicBufferMapper& getBufferMapper() const { 116b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian return mBufferMapper; 117b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian } 118b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian inline GraphicBufferMapper& getBufferMapper() { 119b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian return mBufferMapper; 120b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian } 12154ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian uint8_t mOwner; 1223330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1233330b203039dea366d4981db1408a460134b2d2cMathias Agopianprivate: 1243330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class Surface; 1253330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class BpSurface; 1263330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class BnSurface; 1278ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis friend class SurfaceTextureClient; 1283330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class LightRefBase<GraphicBuffer>; 1293330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer(const GraphicBuffer& rhs); 1303330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer& operator = (const GraphicBuffer& rhs); 1313330b203039dea366d4981db1408a460134b2d2cMathias Agopian const GraphicBuffer& operator = (const GraphicBuffer& rhs) const; 1323330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1333330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t initSize(uint32_t w, uint32_t h, PixelFormat format, 1343330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t usage); 1353330b203039dea366d4981db1408a460134b2d2cMathias Agopian 13698e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian void free_handle(); 13798e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian 13898e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian // Flattenable interface 13998e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian size_t getFlattenedSize() const; 14098e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian size_t getFdCount() const; 14198e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian status_t flatten(void* buffer, size_t size, 14298e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian int fds[], size_t count) const; 14398e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian status_t unflatten(void const* buffer, size_t size, 14498e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian int fds[], size_t count); 14598e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian 1463330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1473330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBufferMapper& mBufferMapper; 1483330b203039dea366d4981db1408a460134b2d2cMathias Agopian ssize_t mInitCheck; 1493330b203039dea366d4981db1408a460134b2d2cMathias Agopian int mIndex; 150309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis 151309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis // If we're wrapping another buffer then this reference will make sure it 152309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis // doesn't get freed. 153697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev sp<ANativeWindowBuffer> mWrappedBuffer; 1543330b203039dea366d4981db1408a460134b2d2cMathias Agopian}; 1553330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1563330b203039dea366d4981db1408a460134b2d2cMathias Agopian}; // namespace android 1573330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1583330b203039dea366d4981db1408a460134b2d2cMathias Agopian#endif // ANDROID_GRAPHIC_BUFFER_H 159