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> 27e041716ba17674b9af957f68750ad6b2df376c22Mathias Agopian#include <utils/RefBase.h> 285f2165f9455d4893b581b73a67c5431f4344b47eMathias Agopian 293330b203039dea366d4981db1408a460134b2d2cMathias Agopian 30697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchevstruct ANativeWindowBuffer; 313330b203039dea366d4981db1408a460134b2d2cMathias Agopian 323330b203039dea366d4981db1408a460134b2d2cMathias Agopiannamespace android { 333330b203039dea366d4981db1408a460134b2d2cMathias Agopian 343330b203039dea366d4981db1408a460134b2d2cMathias Agopianclass GraphicBufferMapper; 353330b203039dea366d4981db1408a460134b2d2cMathias Agopian 363330b203039dea366d4981db1408a460134b2d2cMathias Agopian// =========================================================================== 373330b203039dea366d4981db1408a460134b2d2cMathias Agopian// GraphicBuffer 383330b203039dea366d4981db1408a460134b2d2cMathias Agopian// =========================================================================== 393330b203039dea366d4981db1408a460134b2d2cMathias Agopian 403330b203039dea366d4981db1408a460134b2d2cMathias Agopianclass GraphicBuffer 41e041716ba17674b9af957f68750ad6b2df376c22Mathias Agopian : public ANativeObjectBase< ANativeWindowBuffer, GraphicBuffer, RefBase >, 42e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian public Flattenable<GraphicBuffer> 433330b203039dea366d4981db1408a460134b2d2cMathias Agopian{ 44e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian friend class Flattenable<GraphicBuffer>; 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, 52d31824004277f554000417cea349d69f18655e95Dan Stoza 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, 6703414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews USAGE_HW_MASK = GRALLOC_USAGE_HW_MASK, 6803414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews 6903414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews USAGE_CURSOR = GRALLOC_USAGE_CURSOR, 703330b203039dea366d4981db1408a460134b2d2cMathias Agopian }; 713330b203039dea366d4981db1408a460134b2d2cMathias Agopian 723330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer(); 733330b203039dea366d4981db1408a460134b2d2cMathias Agopian 743330b203039dea366d4981db1408a460134b2d2cMathias Agopian // creates w * h buffer 75d31824004277f554000417cea349d69f18655e95Dan Stoza GraphicBuffer(uint32_t inWidth, uint32_t inHeight, PixelFormat inFormat, 76d31824004277f554000417cea349d69f18655e95Dan Stoza uint32_t inUsage); 7754ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian 7854ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian // create a buffer from an existing handle 79d31824004277f554000417cea349d69f18655e95Dan Stoza GraphicBuffer(uint32_t inWidth, uint32_t inHeight, PixelFormat inFormat, 80d31824004277f554000417cea349d69f18655e95Dan Stoza uint32_t inUsage, uint32_t inStride, native_handle_t* inHandle, 81d31824004277f554000417cea349d69f18655e95Dan Stoza bool keepOwnership); 823330b203039dea366d4981db1408a460134b2d2cMathias Agopian 83697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev // create a buffer from an existing ANativeWindowBuffer 84697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev GraphicBuffer(ANativeWindowBuffer* buffer, bool keepOwnership); 85309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis 863330b203039dea366d4981db1408a460134b2d2cMathias Agopian // return status 873330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t initCheck() const; 883330b203039dea366d4981db1408a460134b2d2cMathias Agopian 89d31824004277f554000417cea349d69f18655e95Dan Stoza uint32_t getWidth() const { return static_cast<uint32_t>(width); } 90d31824004277f554000417cea349d69f18655e95Dan Stoza uint32_t getHeight() const { return static_cast<uint32_t>(height); } 91d31824004277f554000417cea349d69f18655e95Dan Stoza uint32_t getStride() const { return static_cast<uint32_t>(stride); } 92d31824004277f554000417cea349d69f18655e95Dan Stoza uint32_t getUsage() const { return static_cast<uint32_t>(usage); } 933330b203039dea366d4981db1408a460134b2d2cMathias Agopian PixelFormat getPixelFormat() const { return format; } 943330b203039dea366d4981db1408a460134b2d2cMathias Agopian Rect getBounds() const { return Rect(width, height); } 95b1363d37fc6a661508fad106eb7698c5850a6c17Dan Stoza uint64_t getId() const { return mId; } 96b1363d37fc6a661508fad106eb7698c5850a6c17Dan Stoza 97812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza uint32_t getGenerationNumber() const { return mGenerationNumber; } 98812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza void setGenerationNumber(uint32_t generation) { 99812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza mGenerationNumber = generation; 100812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza } 101812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza 102d31824004277f554000417cea349d69f18655e95Dan Stoza status_t reallocate(uint32_t inWidth, uint32_t inHeight, 103d31824004277f554000417cea349d69f18655e95Dan Stoza PixelFormat inFormat, uint32_t inUsage); 1043330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1059de7293b0a1b01ebe6fb1ab4a498f144adc8029fDan Stoza bool needsReallocation(uint32_t inWidth, uint32_t inHeight, 1069de7293b0a1b01ebe6fb1ab4a498f144adc8029fDan Stoza PixelFormat inFormat, uint32_t inUsage); 1079de7293b0a1b01ebe6fb1ab4a498f144adc8029fDan Stoza 108d31824004277f554000417cea349d69f18655e95Dan Stoza status_t lock(uint32_t inUsage, void** vaddr); 109d31824004277f554000417cea349d69f18655e95Dan Stoza status_t lock(uint32_t inUsage, const Rect& rect, void** vaddr); 110c43946b931de5dafd28f49963f9af78e05390b26Eino-Ville Talvala // For HAL_PIXEL_FORMAT_YCbCr_420_888 111d31824004277f554000417cea349d69f18655e95Dan Stoza status_t lockYCbCr(uint32_t inUsage, android_ycbcr *ycbcr); 112d31824004277f554000417cea349d69f18655e95Dan Stoza status_t lockYCbCr(uint32_t inUsage, const Rect& rect, 113d31824004277f554000417cea349d69f18655e95Dan Stoza android_ycbcr *ycbcr); 1143330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t unlock(); 115d31824004277f554000417cea349d69f18655e95Dan Stoza status_t lockAsync(uint32_t inUsage, void** vaddr, int fenceFd); 116d31824004277f554000417cea349d69f18655e95Dan Stoza status_t lockAsync(uint32_t inUsage, const Rect& rect, void** vaddr, 117d31824004277f554000417cea349d69f18655e95Dan Stoza int fenceFd); 118d31824004277f554000417cea349d69f18655e95Dan Stoza status_t lockAsyncYCbCr(uint32_t inUsage, android_ycbcr *ycbcr, 119d31824004277f554000417cea349d69f18655e95Dan Stoza int fenceFd); 120d31824004277f554000417cea349d69f18655e95Dan Stoza status_t lockAsyncYCbCr(uint32_t inUsage, const Rect& rect, 121d31824004277f554000417cea349d69f18655e95Dan Stoza android_ycbcr *ycbcr, int fenceFd); 1228f3960179c56767e5077be8337792bd4e244b7d7Francis Hart status_t unlockAsync(int *fenceFd); 123678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian 124697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev ANativeWindowBuffer* getNativeBuffer() const; 1253330b203039dea366d4981db1408a460134b2d2cMathias Agopian 126678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian // for debugging 127678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian static void dumpAllocationsToSystemLog(); 128678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian 12987f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian // Flattenable protocol 13087f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian size_t getFlattenedSize() const; 13187f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian size_t getFdCount() const; 13287f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian status_t flatten(void*& buffer, size_t& size, int*& fds, size_t& count) const; 13387f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian status_t unflatten(void const*& buffer, size_t& size, int const*& fds, size_t& count); 13487f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian 135b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopianprivate: 136e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian ~GraphicBuffer(); 1373330b203039dea366d4981db1408a460134b2d2cMathias Agopian 13854ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian enum { 13954ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownNone = 0, 14054ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownHandle = 1, 14154ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownData = 2, 14254ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian }; 14354ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian 144b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian inline const GraphicBufferMapper& getBufferMapper() const { 145b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian return mBufferMapper; 146b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian } 147b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian inline GraphicBufferMapper& getBufferMapper() { 148b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian return mBufferMapper; 149b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian } 15054ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian uint8_t mOwner; 1513330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1523330b203039dea366d4981db1408a460134b2d2cMathias Agopianprivate: 1533330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class Surface; 1543330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class BpSurface; 1553330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class BnSurface; 1563330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class LightRefBase<GraphicBuffer>; 1573330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer(const GraphicBuffer& rhs); 1583330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer& operator = (const GraphicBuffer& rhs); 1593330b203039dea366d4981db1408a460134b2d2cMathias Agopian const GraphicBuffer& operator = (const GraphicBuffer& rhs) const; 1603330b203039dea366d4981db1408a460134b2d2cMathias Agopian 161d31824004277f554000417cea349d69f18655e95Dan Stoza status_t initSize(uint32_t inWidth, uint32_t inHeight, PixelFormat inFormat, 162d31824004277f554000417cea349d69f18655e95Dan Stoza uint32_t inUsage); 1633330b203039dea366d4981db1408a460134b2d2cMathias Agopian 16498e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian void free_handle(); 16598e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian 1663330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBufferMapper& mBufferMapper; 1673330b203039dea366d4981db1408a460134b2d2cMathias Agopian ssize_t mInitCheck; 168309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis 169309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis // If we're wrapping another buffer then this reference will make sure it 170309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis // doesn't get freed. 171697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev sp<ANativeWindowBuffer> mWrappedBuffer; 172b1363d37fc6a661508fad106eb7698c5850a6c17Dan Stoza 173b1363d37fc6a661508fad106eb7698c5850a6c17Dan Stoza uint64_t mId; 174812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza 175812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza // Stores the generation number of this buffer. If this number does not 176812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza // match the BufferQueue's internal generation number (set through 177812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza // IGBP::setGenerationNumber), attempts to attach the buffer will fail. 178812ed0644f8f8f71ca403f4e5793f0dbc1fcf9b2Dan Stoza uint32_t mGenerationNumber; 1793330b203039dea366d4981db1408a460134b2d2cMathias Agopian}; 1803330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1813330b203039dea366d4981db1408a460134b2d2cMathias Agopian}; // namespace android 1823330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1833330b203039dea366d4981db1408a460134b2d2cMathias Agopian#endif // ANDROID_GRAPHIC_BUFFER_H 184