IGraphicBufferProducer.h revision f0eaf25e9247edf4d124bedaeb863f7abdf35a3e
18ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis/* 28ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * Copyright (C) 2010 The Android Open Source Project 38ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * 48ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * Licensed under the Apache License, Version 2.0 (the "License"); 58ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * you may not use this file except in compliance with the License. 68ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * You may obtain a copy of the License at 78ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * 88ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * http://www.apache.org/licenses/LICENSE-2.0 98ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * 108ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * Unless required by applicable law or agreed to in writing, software 118ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * distributed under the License is distributed on an "AS IS" BASIS, 128ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 138ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * See the License for the specific language governing permissions and 148ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis * limitations under the License. 158ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis */ 168ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 172adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden#ifndef ANDROID_GUI_IGRAPHICBUFFERPRODUCER_H 182adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden#define ANDROID_GUI_IGRAPHICBUFFERPRODUCER_H 198ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 208ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <stdint.h> 218ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <sys/types.h> 228ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 238ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <utils/Errors.h> 248ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <utils/RefBase.h> 258ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 268ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <binder/IInterface.h> 278ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 28f78575400977f644cf0b12beb2fa5fc278b6ed4cJesse Hall#include <ui/Fence.h> 298ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <ui/GraphicBuffer.h> 308ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <ui/Rect.h> 318ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 328ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennisnamespace android { 338ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis// ---------------------------------------------------------------------------- 348ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 35f0eaf25e9247edf4d124bedaeb863f7abdf35a3eDan Stozaclass IProducerListener; 36399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hallclass NativeHandle; 37e3c697fb929c856b59fa56a8e05a2a7eba187c3dMathias Agopianclass Surface; 38eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian 390273adbf0bc202eda2ca579ae0773464ea9c701fAndy McFadden/* 40466a192d2088f9238d34597d1aa28da41367c1caAndy McFadden * This class defines the Binder IPC interface for the producer side of 41466a192d2088f9238d34597d1aa28da41367c1caAndy McFadden * a queue of graphics buffers. It's used to send graphics data from one 42466a192d2088f9238d34597d1aa28da41367c1caAndy McFadden * component to another. For example, a class that decodes video for 43466a192d2088f9238d34597d1aa28da41367c1caAndy McFadden * playback might use this to provide frames. This is typically done 44e3c697fb929c856b59fa56a8e05a2a7eba187c3dMathias Agopian * indirectly, through Surface. 450273adbf0bc202eda2ca579ae0773464ea9c701fAndy McFadden * 46466a192d2088f9238d34597d1aa28da41367c1caAndy McFadden * The underlying mechanism is a BufferQueue, which implements 47466a192d2088f9238d34597d1aa28da41367c1caAndy McFadden * BnGraphicBufferProducer. In normal operation, the producer calls 48466a192d2088f9238d34597d1aa28da41367c1caAndy McFadden * dequeueBuffer() to get an empty buffer, fills it with data, then 49466a192d2088f9238d34597d1aa28da41367c1caAndy McFadden * calls queueBuffer() to make it available to the consumer. 500273adbf0bc202eda2ca579ae0773464ea9c701fAndy McFadden * 512adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden * This class was previously called ISurfaceTexture. 520273adbf0bc202eda2ca579ae0773464ea9c701fAndy McFadden */ 532adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFaddenclass IGraphicBufferProducer : public IInterface 548ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis{ 558ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennispublic: 562adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden DECLARE_META_INTERFACE(GraphicBufferProducer); 578ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 588072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian enum { 597d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // A flag returned by dequeueBuffer when the client needs to call 607d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // requestBuffer immediately thereafter. 618072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian BUFFER_NEEDS_REALLOCATION = 0x1, 627d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // A flag returned by dequeueBuffer when all mirrored slots should be 637d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // released by the client. This flag should always be processed first. 648072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian RELEASE_ALL_BUFFERS = 0x2, 658072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian }; 66a5c75c01620179ce00812354778a29a80d76e71fMathias Agopian 678ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // requestBuffer requests a new buffer for the given index. The server (i.e. 682adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // the IGraphicBufferProducer implementation) assigns the newly created 692adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // buffer to the given slot index, and the client is expected to mirror the 708ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // slot->buffer mapping so that it's not necessary to transfer a 718ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // GraphicBuffer for every dequeue operation. 727d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 737d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The slot must be in the range of [0, NUM_BUFFER_SLOTS). 747d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 757d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Return of a value other than NO_ERROR means an error has occurred: 767d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * NO_INIT - the buffer queue has been abandoned. 777d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * BAD_VALUE - one of the two conditions occurred: 787d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * slot was out of range (see above) 797d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * buffer specified by the slot is not dequeued 807b305fffc39d0fe0926e7fd2d7f6a524fbce62b7Jamie Gennis virtual status_t requestBuffer(int slot, sp<GraphicBuffer>* buf) = 0; 818ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 828ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // setBufferCount sets the number of buffer slots available. Calling this 838ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // will also cause all buffer slots to be emptied. The caller should empty 848ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // its mirrored copy of the buffer slots when calling this method. 857d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 867d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // This function should not be called when there are any dequeued buffer 877d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // slots, doing so will result in a BAD_VALUE error returned. 887d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 897ea777f097784492f880623067becac1b276f884Igor Murashkin // The buffer count should be at most NUM_BUFFER_SLOTS (inclusive), but at least 907ea777f097784492f880623067becac1b276f884Igor Murashkin // the minimum undequeued buffer count (exclusive). The minimum value 917ea777f097784492f880623067becac1b276f884Igor Murashkin // can be obtained by calling query(NATIVE_WINDOW_MIN_UNDEQUEUED_BUFFERS). 927ea777f097784492f880623067becac1b276f884Igor Murashkin // In particular the range is (minUndequeudBuffers, NUM_BUFFER_SLOTS]. 937ea777f097784492f880623067becac1b276f884Igor Murashkin // 947ea777f097784492f880623067becac1b276f884Igor Murashkin // The buffer count may also be set to 0 (the default), to indicate that 957ea777f097784492f880623067becac1b276f884Igor Murashkin // the producer does not wish to set a value. 967d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 977d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Return of a value other than NO_ERROR means an error has occurred: 987d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * NO_INIT - the buffer queue has been abandoned. 997d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * BAD_VALUE - one of the below conditions occurred: 1007d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * bufferCount was out of range (see above) 1017d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * client has one or more buffers dequeued 1028ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t setBufferCount(int bufferCount) = 0; 1038ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 1048ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // dequeueBuffer requests a new buffer slot for the client to use. Ownership 1058ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // of the slot is transfered to the client, meaning that the server will not 1067d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // use the contents of the buffer associated with that slot. 1077d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1087d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The slot index returned may or may not contain a buffer (client-side). 1097d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // If the slot is empty the client should call requestBuffer to assign a new 1107d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // buffer to that slot. 1117d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1127d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Once the client is done filling this buffer, it is expected to transfer 1137d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // buffer ownership back to the server with either cancelBuffer on 1147d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // the dequeued slot or to fill in the contents of its associated buffer 1157d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // contents and call queueBuffer. 1167d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1177d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // If dequeueBuffer returns the BUFFER_NEEDS_REALLOCATION flag, the client is 118a5c75c01620179ce00812354778a29a80d76e71fMathias Agopian // expected to call requestBuffer immediately. 119f78575400977f644cf0b12beb2fa5fc278b6ed4cJesse Hall // 1207d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // If dequeueBuffer returns the RELEASE_ALL_BUFFERS flag, the client is 1217d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // expected to release all of the mirrored slot->buffer mappings. 1227d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 123f78575400977f644cf0b12beb2fa5fc278b6ed4cJesse Hall // The fence parameter will be updated to hold the fence associated with 124f78575400977f644cf0b12beb2fa5fc278b6ed4cJesse Hall // the buffer. The contents of the buffer must not be overwritten until the 1257d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // fence signals. If the fence is Fence::NO_FENCE, the buffer may be written 126f78575400977f644cf0b12beb2fa5fc278b6ed4cJesse Hall // immediately. 1277cdd786fa80cf03551291ae8feca7b77583be1c5Mathias Agopian // 1287d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The async parameter sets whether we're in asynchronous mode for this 1297d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // dequeueBuffer() call. 1307d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1317d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The width and height parameters must be no greater than the minimum of 1327d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // GL_MAX_VIEWPORT_DIMS and GL_MAX_TEXTURE_SIZE (see: glGetIntegerv). 1337d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // An error due to invalid dimensions might not be reported until 1347d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // updateTexImage() is called. If width and height are both zero, the 1357d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // default values specified by setDefaultBufferSize() are used instead. 1367d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1377d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The pixel formats are enumerated in <graphics.h>, e.g. 1387d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // HAL_PIXEL_FORMAT_RGBA_8888. If the format is 0, the default format 1397d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // will be used. 1407d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1417d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The usage argument specifies gralloc buffer usage flags. The values 1427d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // are enumerated in <gralloc.h>, e.g. GRALLOC_USAGE_HW_RENDER. These 1437d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // will be merged with the usage flags specified by 1447d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // IGraphicBufferConsumer::setConsumerUsageBits. 1457d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1467d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // This call will block until a buffer is available to be dequeued. If 1477d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // both the producer and consumer are controlled by the app, then this call 1487d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // can never block and will return WOULD_BLOCK if no buffer is available. 1497d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1507d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // A non-negative value with flags set (see above) will be returned upon 1517d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // success. 1527d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1537d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Return of a negative means an error has occurred: 1547d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * NO_INIT - the buffer queue has been abandoned. 1559f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // * BAD_VALUE - both in async mode and buffer count was less than the 1569f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // max numbers of buffers that can be allocated at once. 1579f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // * INVALID_OPERATION - cannot attach the buffer because it would cause 1589f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // too many buffers to be dequeued, either because 1599f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // the producer already has a single buffer dequeued 1609f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // and did not set a buffer count, or because a 1619f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // buffer count was set and this call would cause 1629f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // it to be exceeded. 1637d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * WOULD_BLOCK - no buffer is currently available, and blocking is disabled 1647d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // since both the producer/consumer are controlled by app 1657d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * NO_MEMORY - out of memory, cannot allocate the graphics buffer. 1667d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 1677d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // All other negative values are an unknown error returned downstream 1687d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // from the graphics allocator (typically errno). 1697d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin virtual status_t dequeueBuffer(int* slot, sp<Fence>* fence, bool async, 170f78575400977f644cf0b12beb2fa5fc278b6ed4cJesse Hall uint32_t w, uint32_t h, uint32_t format, uint32_t usage) = 0; 1718ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 1729f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // detachBuffer attempts to remove all ownership of the buffer in the given 1739f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // slot from the buffer queue. If this call succeeds, the slot will be 1749f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // freed, and there will be no way to obtain the buffer from this interface. 1759f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // The freed slot will remain unallocated until either it is selected to 1769f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // hold a freshly allocated buffer in dequeueBuffer or a buffer is attached 1779f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // to the slot. The buffer must have already been dequeued, and the caller 1789f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // must already possesses the sp<GraphicBuffer> (i.e., must have called 1799f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // requestBuffer). 1809f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // 1819f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // Return of a value other than NO_ERROR means an error has occurred: 1829f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // * NO_INIT - the buffer queue has been abandoned. 1839f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // * BAD_VALUE - the given slot number is invalid, either because it is 1849f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // out of the range [0, NUM_BUFFER_SLOTS), or because the slot 1859f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // it refers to is not currently dequeued and requested. 1869f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza virtual status_t detachBuffer(int slot) = 0; 1879f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza 1889f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // attachBuffer attempts to transfer ownership of a buffer to the buffer 1899f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // queue. If this call succeeds, it will be as if this buffer was dequeued 1909f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // from the returned slot number. As such, this call will fail if attaching 1919f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // this buffer would cause too many buffers to be simultaneously dequeued. 1929f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // 1939f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // If attachBuffer returns the RELEASE_ALL_BUFFERS flag, the caller is 1949f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // expected to release all of the mirrored slot->buffer mappings. 1959f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // 1969f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // A non-negative value with flags set (see above) will be returned upon 1979f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // success. 1989f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // 1999f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // Return of a negative value means an error has occurred: 2009f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // * NO_INIT - the buffer queue has been abandoned. 2019f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // * BAD_VALUE - outSlot or buffer were NULL or invalid combination of 2029f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // async mode and buffer count override. 2039f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // * INVALID_OPERATION - cannot attach the buffer because it would cause 2049f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // too many buffers to be dequeued, either because 2059f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // the producer already has a single buffer dequeued 2069f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // and did not set a buffer count, or because a 2079f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // buffer count was set and this call would cause 2089f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // it to be exceeded. 2099f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // * WOULD_BLOCK - no buffer slot is currently available, and blocking is 2109f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // disabled since both the producer/consumer are 2119f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza // controlled by the app. 2129f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza virtual status_t attachBuffer(int* outSlot, 2139f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza const sp<GraphicBuffer>& buffer) = 0; 2149f3053de78630815d60cf48a2cf2348cc5867c45Dan Stoza 2158ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // queueBuffer indicates that the client has finished filling in the 2168ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // contents of the buffer associated with slot and transfers ownership of 2177d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // that slot back to the server. 2187d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 2197d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // It is not valid to call queueBuffer on a slot that is not owned 2207d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // by the client or one for which a buffer associated via requestBuffer 2217d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // (an attempt to do so will fail with a return value of BAD_VALUE). 2227d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 2237d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // In addition, the input must be described by the client (as documented 2247d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // below). Any other properties (zero point, etc) 2251d01a12e7150be569557b64da9b8663c62c13594Eino-Ville Talvala // are client-dependent, and should be documented by the client. 22697c602c5af5f3ffd69009bf496d86347b71a2b4cMathias Agopian // 2277d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The slot must be in the range of [0, NUM_BUFFER_SLOTS). 2287d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 2297d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Upon success, the output will be filled with meaningful values 2307d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // (refer to the documentation below). 2317cdd786fa80cf03551291ae8feca7b77583be1c5Mathias Agopian // 2327d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Return of a value other than NO_ERROR means an error has occurred: 2337d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * NO_INIT - the buffer queue has been abandoned. 2347d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * BAD_VALUE - one of the below conditions occurred: 2357d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * fence was NULL 2367d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * scaling mode was unknown 2377d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * both in async mode and buffer count was less than the 2387d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // max numbers of buffers that can be allocated at once 2397d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * slot index was out of range (see above). 2407d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * the slot was not in the dequeued state 2417d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * the slot was enqueued without requesting a buffer 2427d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * crop rect is out of bounds of the buffer dimensions 243f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian 244e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian struct QueueBufferInput : public Flattenable<QueueBufferInput> { 245e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian friend class Flattenable<QueueBufferInput>; 246c777b0b3b9b0ea5d8e378fccde6935765e28e329Jesse Hall inline QueueBufferInput(const Parcel& parcel); 2477d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // timestamp - a monotonically increasing value in nanoseconds 2487d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // isAutoTimestamp - if the timestamp was synthesized at queue time 2497d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // crop - a crop rectangle that's used as a hint to the consumer 2507d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // scalingMode - a set of flags from NATIVE_WINDOW_SCALING_* in <window.h> 2517d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // transform - a set of flags from NATIVE_WINDOW_TRANSFORM_* in <window.h> 2527d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // async - if the buffer is queued in asynchronous mode 2537d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // fence - a fence that the consumer must wait on before reading the buffer, 2547d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // set this to Fence::NO_FENCE if the buffer is ready immediately 2553c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden inline QueueBufferInput(int64_t timestamp, bool isAutoTimestamp, 2567cdd786fa80cf03551291ae8feca7b77583be1c5Mathias Agopian const Rect& crop, int scalingMode, uint32_t transform, bool async, 2577cdd786fa80cf03551291ae8feca7b77583be1c5Mathias Agopian const sp<Fence>& fence) 2583c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden : timestamp(timestamp), isAutoTimestamp(isAutoTimestamp), crop(crop), 2593c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden scalingMode(scalingMode), transform(transform), async(async), 2603c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden fence(fence) { } 2613c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden inline void deflate(int64_t* outTimestamp, bool* outIsAutoTimestamp, 2623c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden Rect* outCrop, int* outScalingMode, uint32_t* outTransform, 2633c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden bool* outAsync, sp<Fence>* outFence) const { 264f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outTimestamp = timestamp; 2653c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden *outIsAutoTimestamp = bool(isAutoTimestamp); 266f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outCrop = crop; 267f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outScalingMode = scalingMode; 268f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outTransform = transform; 2697cdd786fa80cf03551291ae8feca7b77583be1c5Mathias Agopian *outAsync = bool(async); 270c777b0b3b9b0ea5d8e378fccde6935765e28e329Jesse Hall *outFence = fence; 271f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian } 272c777b0b3b9b0ea5d8e378fccde6935765e28e329Jesse Hall 273e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian // Flattenable protocol 274e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian size_t getFlattenedSize() const; 275e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian size_t getFdCount() const; 276e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian status_t flatten(void*& buffer, size_t& size, int*& fds, size_t& count) const; 277e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian status_t unflatten(void const*& buffer, size_t& size, int const*& fds, size_t& count); 278c777b0b3b9b0ea5d8e378fccde6935765e28e329Jesse Hall 279f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian private: 280f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian int64_t timestamp; 2813c25621ad7d13f64d3ab95a27fa970fbc9998f73Andy McFadden int isAutoTimestamp; 282f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian Rect crop; 283f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian int scalingMode; 284f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t transform; 2857cdd786fa80cf03551291ae8feca7b77583be1c5Mathias Agopian int async; 286c777b0b3b9b0ea5d8e378fccde6935765e28e329Jesse Hall sp<Fence> fence; 287f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian }; 288f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian 289f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian // QueueBufferOutput must be a POD structure 2907d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin struct __attribute__ ((__packed__)) QueueBufferOutput { 291f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian inline QueueBufferOutput() { } 2927d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // outWidth - filled with default width applied to the buffer 2937d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // outHeight - filled with default height applied to the buffer 2947d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // outTransformHint - filled with default transform applied to the buffer 2957d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // outNumPendingBuffers - num buffers queued that haven't yet been acquired 2967d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // (counting the currently queued buffer) 297f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian inline void deflate(uint32_t* outWidth, 2982488b20aec097accb20a853d9876bb0a5dc04636Mathias Agopian uint32_t* outHeight, 2992488b20aec097accb20a853d9876bb0a5dc04636Mathias Agopian uint32_t* outTransformHint, 3002488b20aec097accb20a853d9876bb0a5dc04636Mathias Agopian uint32_t* outNumPendingBuffers) const { 301f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outWidth = width; 302f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outHeight = height; 303f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outTransformHint = transformHint; 3042488b20aec097accb20a853d9876bb0a5dc04636Mathias Agopian *outNumPendingBuffers = numPendingBuffers; 305f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian } 306f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian inline void inflate(uint32_t inWidth, uint32_t inHeight, 3072488b20aec097accb20a853d9876bb0a5dc04636Mathias Agopian uint32_t inTransformHint, uint32_t inNumPendingBuffers) { 308f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian width = inWidth; 309f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian height = inHeight; 310f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian transformHint = inTransformHint; 3112488b20aec097accb20a853d9876bb0a5dc04636Mathias Agopian numPendingBuffers = inNumPendingBuffers; 312f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian } 313f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian private: 314f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t width; 315f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t height; 316f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t transformHint; 3172488b20aec097accb20a853d9876bb0a5dc04636Mathias Agopian uint32_t numPendingBuffers; 318f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian }; 319f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian 320f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian virtual status_t queueBuffer(int slot, 321f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian const QueueBufferInput& input, QueueBufferOutput* output) = 0; 3228ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 3238ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // cancelBuffer indicates that the client does not wish to fill in the 3248ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // buffer associated with slot and transfers ownership of the slot back to 3258ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // the server. 3267d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3277d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The buffer is not queued for use by the consumer. 3287d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3297d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The buffer will not be overwritten until the fence signals. The fence 3307d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // will usually be the one obtained from dequeueBuffer. 3314c00cc11141da7d159eb2323b186ed344115c0f1Jesse Hall virtual void cancelBuffer(int slot, const sp<Fence>& fence) = 0; 3328ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 333eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian // query retrieves some information for this surface 3347d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 'what' tokens allowed are that of NATIVE_WINDOW_* in <window.h> 3357d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3367d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Return of a value other than NO_ERROR means an error has occurred: 3377d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * NO_INIT - the buffer queue has been abandoned. 3387d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * BAD_VALUE - what was out of range 339eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian virtual int query(int what, int* value) = 0; 3408072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian 3412adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // connect attempts to connect a client API to the IGraphicBufferProducer. 3422adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // This must be called before any other IGraphicBufferProducer methods are 3437d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // called except for getAllocator. A consumer must be already connected. 344fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // 345fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // This method will fail if the connect was previously called on the 3462adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // IGraphicBufferProducer and no corresponding disconnect call was made. 3475bfc24515bb5c8ea7975f72d538df37753733a2fMathias Agopian // 348f0eaf25e9247edf4d124bedaeb863f7abdf35a3eDan Stoza // The listener is an optional binder callback object that can be used if 349f0eaf25e9247edf4d124bedaeb863f7abdf35a3eDan Stoza // the producer wants to be notified when the consumer releases a buffer 350f0eaf25e9247edf4d124bedaeb863f7abdf35a3eDan Stoza // back to the BufferQueue. It is also used to detect the death of the 351f0eaf25e9247edf4d124bedaeb863f7abdf35a3eDan Stoza // producer. If only the latter functionality is desired, there is a 352f0eaf25e9247edf4d124bedaeb863f7abdf35a3eDan Stoza // DummyProducerListener class in IProducerListener.h that can be used. 3537d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3547d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The api should be one of the NATIVE_WINDOW_API_* values in <window.h> 3557d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3567d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The producerControlledByApp should be set to true if the producer is hosted 3577d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // by an untrusted process (typically app_process-forked processes). If both 3587d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // the producer and the consumer are app-controlled then all buffer queues 3597d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // will operate in async mode regardless of the async flag. 3607d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3617d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Upon success, the output will be filled with meaningful data 3627d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // (refer to QueueBufferOutput documentation above). 3637d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3647d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Return of a value other than NO_ERROR means an error has occurred: 3657d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * NO_INIT - one of the following occurred: 3667d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * the buffer queue was abandoned 3677d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * no consumer has yet connected 3687d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * BAD_VALUE - one of the following has occurred: 3697d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * the producer is already connected 3707d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * api was out of range (see above). 3717ea777f097784492f880623067becac1b276f884Igor Murashkin // * output was NULL. 3727d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * DEAD_OBJECT - the token is hosted by an already-dead process 3737d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3747d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Additional negative errors may be returned by the internals, they 3757d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // should be treated as opaque fatal unrecoverable errors. 376f0eaf25e9247edf4d124bedaeb863f7abdf35a3eDan Stoza virtual status_t connect(const sp<IProducerListener>& listener, 377365857df8b94c959dea984a63013f6e7730ef976Mathias Agopian int api, bool producerControlledByApp, QueueBufferOutput* output) = 0; 378fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis 3792adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // disconnect attempts to disconnect a client API from the 3802adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // IGraphicBufferProducer. Calling this method will cause any subsequent 3812adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // calls to other IGraphicBufferProducer methods to fail except for 3822adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // getAllocator and connect. Successfully calling connect after this will 3832adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // allow the other methods to succeed again. 384fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // 3852adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden // This method will fail if the the IGraphicBufferProducer is not currently 386fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // connected to the specified client API. 3877d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3887d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // The api should be one of the NATIVE_WINDOW_API_* values in <window.h> 3897d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3907d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Disconnecting from an abandoned IGraphicBufferProducer is legal and 3917d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // is considered a no-op. 3927d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // 3937d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // Return of a value other than NO_ERROR means an error has occurred: 3947d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * BAD_VALUE - one of the following has occurred: 3957d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * the api specified does not match the one that was connected 3967d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * api was out of range (see above). 3977d2d160cdc3cba9f4454f38433c94b68376cb843Igor Murashkin // * DEAD_OBJECT - the token is hosted by an already-dead process 398fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis virtual status_t disconnect(int api) = 0; 399399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall 400399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // Attaches a sideband buffer stream to the IGraphicBufferProducer. 401399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // 402399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // A sideband stream is a device-specific mechanism for passing buffers 403399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // from the producer to the consumer without using dequeueBuffer/ 404399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // queueBuffer. If a sideband stream is present, the consumer can choose 405399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // whether to acquire buffers from the sideband stream or from the queued 406399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // buffers. 407399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // 408399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // Passing NULL or a different stream handle will detach the previous 409399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // handle if any. 410399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall virtual status_t setSidebandStream(const sp<NativeHandle>& stream) = 0; 4118ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; 4128ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 4138ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis// ---------------------------------------------------------------------------- 4148ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 4152adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFaddenclass BnGraphicBufferProducer : public BnInterface<IGraphicBufferProducer> 4168ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis{ 4178ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennispublic: 4188ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t onTransact( uint32_t code, 4198ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis const Parcel& data, 4208ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis Parcel* reply, 4218ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis uint32_t flags = 0); 4228ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; 4238ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 4248ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis// ---------------------------------------------------------------------------- 4258ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; // namespace android 4268ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 4272adaf04fab35cf47c824d74d901b54094e01ccd3Andy McFadden#endif // ANDROID_GUI_IGRAPHICBUFFERPRODUCER_H 428