IGraphicBufferProducer.h revision f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246
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 178ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#ifndef ANDROID_GUI_ISURFACETEXTURE_H 188ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#define ANDROID_GUI_ISURFACETEXTURE_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 288ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <ui/GraphicBuffer.h> 298ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#include <ui/Rect.h> 308ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 318ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennisnamespace android { 328ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis// ---------------------------------------------------------------------------- 338ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 34eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopianclass SurfaceTextureClient; 35eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian 368ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennisclass ISurfaceTexture : public IInterface 378ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis{ 388ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennispublic: 398ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis DECLARE_META_INTERFACE(SurfaceTexture); 408ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 41eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopianprotected: 42eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian friend class SurfaceTextureClient; 43eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian 448072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian enum { 458072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian BUFFER_NEEDS_REALLOCATION = 0x1, 468072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian RELEASE_ALL_BUFFERS = 0x2, 478072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian }; 48a5c75c01620179ce00812354778a29a80d76e71fMathias Agopian 498ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // requestBuffer requests a new buffer for the given index. The server (i.e. 508ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // the ISurfaceTexture implementation) assigns the newly created buffer to 518ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // the given slot index, and the client is expected to mirror the 528ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // slot->buffer mapping so that it's not necessary to transfer a 538ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // GraphicBuffer for every dequeue operation. 547b305fffc39d0fe0926e7fd2d7f6a524fbce62b7Jamie Gennis virtual status_t requestBuffer(int slot, sp<GraphicBuffer>* buf) = 0; 558ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 568ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // setBufferCount sets the number of buffer slots available. Calling this 578ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // will also cause all buffer slots to be emptied. The caller should empty 588ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // its mirrored copy of the buffer slots when calling this method. 598ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t setBufferCount(int bufferCount) = 0; 608ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 618ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // dequeueBuffer requests a new buffer slot for the client to use. Ownership 628ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // of the slot is transfered to the client, meaning that the server will not 638ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // use the contents of the buffer associated with that slot. The slot index 648ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // returned may or may not contain a buffer. If the slot is empty the client 658ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // should call requestBuffer to assign a new buffer to that slot. The client 668ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // is expected to either call cancelBuffer on the dequeued slot or to fill 678ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // in the contents of its associated buffer contents and call queueBuffer. 68a5c75c01620179ce00812354778a29a80d76e71fMathias Agopian // If dequeueBuffer return BUFFER_NEEDS_REALLOCATION, the client is 69a5c75c01620179ce00812354778a29a80d76e71fMathias Agopian // expected to call requestBuffer immediately. 70c04f153353cdb0d291297d10452239f791d3fd2bMathias Agopian virtual status_t dequeueBuffer(int *slot, uint32_t w, uint32_t h, 71c04f153353cdb0d291297d10452239f791d3fd2bMathias Agopian uint32_t format, uint32_t usage) = 0; 728ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 738ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // queueBuffer indicates that the client has finished filling in the 748ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // contents of the buffer associated with slot and transfers ownership of 758ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // that slot back to the server. It is not valid to call queueBuffer on a 768ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // slot that is not owned by the client or one for which a buffer associated 771d01a12e7150be569557b64da9b8663c62c13594Eino-Ville Talvala // via requestBuffer. In addition, a timestamp must be provided by the 781d01a12e7150be569557b64da9b8663c62c13594Eino-Ville Talvala // client for this buffer. The timestamp is measured in nanoseconds, and 791d01a12e7150be569557b64da9b8663c62c13594Eino-Ville Talvala // must be monotonically increasing. Its other properties (zero point, etc) 801d01a12e7150be569557b64da9b8663c62c13594Eino-Ville Talvala // are client-dependent, and should be documented by the client. 8197c602c5af5f3ffd69009bf496d86347b71a2b4cMathias Agopian // 82c10d9d90b2088a3304076e0dc4bf05cdbb5d45abMathias Agopian // outWidth, outHeight and outTransform are filled with the default width 83c10d9d90b2088a3304076e0dc4bf05cdbb5d45abMathias Agopian // and height of the window and current transform applied to buffers, 8497c602c5af5f3ffd69009bf496d86347b71a2b4cMathias Agopian // respectively. 85f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian 86f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian // QueueBufferInput must be a POD structure 87f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian struct QueueBufferInput { 88f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian inline QueueBufferInput(int64_t timestamp, 89f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian const Rect& crop, int scalingMode, uint32_t transform) 90f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian : timestamp(timestamp), crop(crop), scalingMode(scalingMode), 91f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian transform(transform) { } 92f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian inline void deflate(int64_t* outTimestamp, Rect* outCrop, 93f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian int* outScalingMode, uint32_t* outTransform) const { 94f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outTimestamp = timestamp; 95f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outCrop = crop; 96f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outScalingMode = scalingMode; 97f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outTransform = transform; 98f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian } 99f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian private: 100f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian int64_t timestamp; 101f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian Rect crop; 102f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian int scalingMode; 103f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t transform; 104f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian }; 105f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian 106f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian // QueueBufferOutput must be a POD structure 107f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian struct QueueBufferOutput { 108f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian inline QueueBufferOutput() { } 109f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian inline void deflate(uint32_t* outWidth, 110f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t* outHeight, uint32_t* outTransformHint) const { 111f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outWidth = width; 112f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outHeight = height; 113f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian *outTransformHint = transformHint; 114f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian } 115f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian inline void inflate(uint32_t inWidth, uint32_t inHeight, 116f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t inTransformHint) { 117f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian width = inWidth; 118f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian height = inHeight; 119f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian transformHint = inTransformHint; 120f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian } 121f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian private: 122f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t width; 123f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t height; 124f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian uint32_t transformHint; 125f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian }; 126f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian 127f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian virtual status_t queueBuffer(int slot, 128f0bc2f1d8d37977bd3aef3d3326a70e9e69d4246Mathias Agopian const QueueBufferInput& input, QueueBufferOutput* output) = 0; 1298ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 1308ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // cancelBuffer indicates that the client does not wish to fill in the 1318ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // buffer associated with slot and transfers ownership of the slot back to 1328ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // the server. 1338ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual void cancelBuffer(int slot) = 0; 1348ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 135eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian // query retrieves some information for this surface 136eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian // 'what' tokens allowed are that of android_natives.h 137eafabcdc1639fb96062d9e3c39b0ae27b0238ae1Mathias Agopian virtual int query(int what, int* value) = 0; 1388072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian 1398072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian // setSynchronousMode set whether dequeueBuffer is synchronous or 1408072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian // asynchronous. In synchronous mode, dequeueBuffer blocks until 1418072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian // a buffer is available, the currently bound buffer can be dequeued and 1428072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian // queued buffers will be retired in order. 1438072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian // The default mode is asynchronous. 1448072711307aa98ee5ee6f7369860ae38c3e19656Mathias Agopian virtual status_t setSynchronousMode(bool enabled) = 0; 145fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis 146fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // connect attempts to connect a client API to the SurfaceTexture. This 147fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // must be called before any other ISurfaceTexture methods are called except 148fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // for getAllocator. 149fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // 150fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // This method will fail if the connect was previously called on the 151fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // SurfaceTexture and no corresponding disconnect call was made. 1525bfc24515bb5c8ea7975f72d538df37753733a2fMathias Agopian // 1535bfc24515bb5c8ea7975f72d538df37753733a2fMathias Agopian // outWidth, outHeight and outTransform are filled with the default width 1545bfc24515bb5c8ea7975f72d538df37753733a2fMathias Agopian // and height of the window and current transform applied to buffers, 1555bfc24515bb5c8ea7975f72d538df37753733a2fMathias Agopian // respectively. 1565bfc24515bb5c8ea7975f72d538df37753733a2fMathias Agopian virtual status_t connect(int api, 1575bfc24515bb5c8ea7975f72d538df37753733a2fMathias Agopian uint32_t* outWidth, uint32_t* outHeight, uint32_t* outTransform) = 0; 158fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis 159fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // disconnect attempts to disconnect a client API from the SurfaceTexture. 160fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // Calling this method will cause any subsequent calls to other 161fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // ISurfaceTexture methods to fail except for getAllocator and connect. 162fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // Successfully calling connect after this will allow the other methods to 163fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // succeed again. 164fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // 165fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // This method will fail if the the SurfaceTexture is not currently 166fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis // connected to the specified client API. 167fe0a87b54654a1392650e7f1862df473287d8332Jamie Gennis virtual status_t disconnect(int api) = 0; 1688ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; 1698ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 1708ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis// ---------------------------------------------------------------------------- 1718ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 1728ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennisclass BnSurfaceTexture : public BnInterface<ISurfaceTexture> 1738ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis{ 1748ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennispublic: 1758ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t onTransact( uint32_t code, 1768ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis const Parcel& data, 1778ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis Parcel* reply, 1788ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis uint32_t flags = 0); 1798ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; 1808ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 1818ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis// ---------------------------------------------------------------------------- 1828ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; // namespace android 1838ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 1848ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#endif // ANDROID_GUI_ISURFACETEXTURE_H 185