GraphicBuffer.h revision 03414a1cfe6c1222fd7723949bd622f9cba145aa
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, 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, 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 7554ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian GraphicBuffer(uint32_t w, uint32_t h, PixelFormat format, uint32_t usage); 7654ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian 7754ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian // create a buffer from an existing handle 7854ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian GraphicBuffer(uint32_t w, uint32_t h, PixelFormat format, uint32_t usage, 7954ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian uint32_t stride, native_handle_t* handle, bool keepOwnership); 803330b203039dea366d4981db1408a460134b2d2cMathias Agopian 81697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev // create a buffer from an existing ANativeWindowBuffer 82697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev GraphicBuffer(ANativeWindowBuffer* buffer, bool keepOwnership); 83309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis 843330b203039dea366d4981db1408a460134b2d2cMathias Agopian // return status 853330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t initCheck() const; 863330b203039dea366d4981db1408a460134b2d2cMathias Agopian 873330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getWidth() const { return width; } 883330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getHeight() const { return height; } 893330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getStride() const { return stride; } 903330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getUsage() const { return usage; } 913330b203039dea366d4981db1408a460134b2d2cMathias Agopian PixelFormat getPixelFormat() const { return format; } 923330b203039dea366d4981db1408a460134b2d2cMathias Agopian Rect getBounds() const { return Rect(width, height); } 93b1363d37fc6a661508fad106eb7698c5850a6c17Dan Stoza uint64_t getId() const { return mId; } 94b1363d37fc6a661508fad106eb7698c5850a6c17Dan Stoza 953330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t reallocate(uint32_t w, uint32_t h, PixelFormat f, uint32_t usage); 963330b203039dea366d4981db1408a460134b2d2cMathias Agopian 973330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t lock(uint32_t usage, void** vaddr); 983330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t lock(uint32_t usage, const Rect& rect, void** vaddr); 99c43946b931de5dafd28f49963f9af78e05390b26Eino-Ville Talvala // For HAL_PIXEL_FORMAT_YCbCr_420_888 100c43946b931de5dafd28f49963f9af78e05390b26Eino-Ville Talvala status_t lockYCbCr(uint32_t usage, android_ycbcr *ycbcr); 101c43946b931de5dafd28f49963f9af78e05390b26Eino-Ville Talvala status_t lockYCbCr(uint32_t usage, const Rect& rect, android_ycbcr *ycbcr); 1023330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t unlock(); 1038f3960179c56767e5077be8337792bd4e244b7d7Francis Hart status_t lockAsync(uint32_t usage, void** vaddr, int fenceFd); 1048f3960179c56767e5077be8337792bd4e244b7d7Francis Hart status_t lockAsync(uint32_t usage, const Rect& rect, void** vaddr, int fenceFd); 1058f3960179c56767e5077be8337792bd4e244b7d7Francis Hart status_t lockAsyncYCbCr(uint32_t usage, android_ycbcr *ycbcr, int fenceFd); 1068f3960179c56767e5077be8337792bd4e244b7d7Francis Hart status_t lockAsyncYCbCr(uint32_t usage, const Rect& rect, android_ycbcr *ycbcr, int fenceFd); 1078f3960179c56767e5077be8337792bd4e244b7d7Francis Hart status_t unlockAsync(int *fenceFd); 108678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian 109697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev ANativeWindowBuffer* getNativeBuffer() const; 1103330b203039dea366d4981db1408a460134b2d2cMathias Agopian 111678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian // for debugging 112678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian static void dumpAllocationsToSystemLog(); 113678bdd6349344df254cc0c3377a40fd99e216635Mathias Agopian 11487f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian // Flattenable protocol 11587f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian size_t getFlattenedSize() const; 11687f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian size_t getFdCount() const; 11787f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian status_t flatten(void*& buffer, size_t& size, int*& fds, size_t& count) const; 11887f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian status_t unflatten(void const*& buffer, size_t& size, int const*& fds, size_t& count); 11987f9b877964b7d7db9b59ba45b73b4b1a779ecf8Mathias Agopian 120b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopianprivate: 121e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian ~GraphicBuffer(); 1223330b203039dea366d4981db1408a460134b2d2cMathias Agopian 12354ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian enum { 12454ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownNone = 0, 12554ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownHandle = 1, 12654ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian ownData = 2, 12754ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian }; 12854ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian 129b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian inline const GraphicBufferMapper& getBufferMapper() const { 130b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian return mBufferMapper; 131b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian } 132b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian inline GraphicBufferMapper& getBufferMapper() { 133b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian return mBufferMapper; 134b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian } 13554ba51dff21de666c5ae3bf3abd4f0634ebb0676Mathias Agopian uint8_t mOwner; 1363330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1373330b203039dea366d4981db1408a460134b2d2cMathias Agopianprivate: 1383330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class Surface; 1393330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class BpSurface; 1403330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class BnSurface; 1413330b203039dea366d4981db1408a460134b2d2cMathias Agopian friend class LightRefBase<GraphicBuffer>; 1423330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer(const GraphicBuffer& rhs); 1433330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBuffer& operator = (const GraphicBuffer& rhs); 1443330b203039dea366d4981db1408a460134b2d2cMathias Agopian const GraphicBuffer& operator = (const GraphicBuffer& rhs) const; 1453330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1463330b203039dea366d4981db1408a460134b2d2cMathias Agopian status_t initSize(uint32_t w, uint32_t h, PixelFormat format, 1473330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t usage); 1483330b203039dea366d4981db1408a460134b2d2cMathias Agopian 14998e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian void free_handle(); 15098e71ddaede9a0bfb681fd237bec1f66c6c53193Mathias Agopian 1513330b203039dea366d4981db1408a460134b2d2cMathias Agopian GraphicBufferMapper& mBufferMapper; 1523330b203039dea366d4981db1408a460134b2d2cMathias Agopian ssize_t mInitCheck; 153309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis 154309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis // If we're wrapping another buffer then this reference will make sure it 155309d3bb2f902163356f9d40b6d45c11b435d77a9Jamie Gennis // doesn't get freed. 156697526bc9e44ce61c88614f98387ae8bbf0a187eIliyan Malchev sp<ANativeWindowBuffer> mWrappedBuffer; 157b1363d37fc6a661508fad106eb7698c5850a6c17Dan Stoza 158b1363d37fc6a661508fad106eb7698c5850a6c17Dan Stoza uint64_t mId; 1593330b203039dea366d4981db1408a460134b2d2cMathias Agopian}; 1603330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1613330b203039dea366d4981db1408a460134b2d2cMathias Agopian}; // namespace android 1623330b203039dea366d4981db1408a460134b2d2cMathias Agopian 1633330b203039dea366d4981db1408a460134b2d2cMathias Agopian#endif // ANDROID_GRAPHIC_BUFFER_H 164