IGraphicBufferProducer.h revision 8ba32fade11abb73f3fd47ea0953c9528eb5b91f
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 348ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennisclass ISurfaceTexture : public IInterface 358ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis{ 368ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennispublic: 378ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis DECLARE_META_INTERFACE(SurfaceTexture); 388ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 398ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // requestBuffer requests a new buffer for the given index. The server (i.e. 408ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // the ISurfaceTexture implementation) assigns the newly created buffer to 418ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // the given slot index, and the client is expected to mirror the 428ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // slot->buffer mapping so that it's not necessary to transfer a 438ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // GraphicBuffer for every dequeue operation. 448ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual sp<GraphicBuffer> requestBuffer(int slot, uint32_t w, uint32_t h, 458ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis uint32_t format, uint32_t usage) = 0; 468ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 478ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // setBufferCount sets the number of buffer slots available. Calling this 488ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // will also cause all buffer slots to be emptied. The caller should empty 498ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // its mirrored copy of the buffer slots when calling this method. 508ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t setBufferCount(int bufferCount) = 0; 518ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 528ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // dequeueBuffer requests a new buffer slot for the client to use. Ownership 538ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // of the slot is transfered to the client, meaning that the server will not 548ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // use the contents of the buffer associated with that slot. The slot index 558ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // returned may or may not contain a buffer. If the slot is empty the client 568ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // should call requestBuffer to assign a new buffer to that slot. The client 578ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // is expected to either call cancelBuffer on the dequeued slot or to fill 588ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // in the contents of its associated buffer contents and call queueBuffer. 598ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t dequeueBuffer(int *slot) = 0; 608ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 618ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // queueBuffer indicates that the client has finished filling in the 628ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // contents of the buffer associated with slot and transfers ownership of 638ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // that slot back to the server. It is not valid to call queueBuffer on a 648ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // slot that is not owned by the client or one for which a buffer associated 658ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // via requestBuffer. 668ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t queueBuffer(int slot) = 0; 678ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 688ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // cancelBuffer indicates that the client does not wish to fill in the 698ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // buffer associated with slot and transfers ownership of the slot back to 708ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis // the server. 718ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual void cancelBuffer(int slot) = 0; 728ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 738ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t setCrop(const Rect& reg) = 0; 748ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t setTransform(uint32_t transform) = 0; 758ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; 768ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 778ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis// ---------------------------------------------------------------------------- 788ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 798ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennisclass BnSurfaceTexture : public BnInterface<ISurfaceTexture> 808ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis{ 818ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennispublic: 828ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis virtual status_t onTransact( uint32_t code, 838ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis const Parcel& data, 848ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis Parcel* reply, 858ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis uint32_t flags = 0); 868ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; 878ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 888ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis// ---------------------------------------------------------------------------- 898ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis}; // namespace android 908ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis 918ba32fade11abb73f3fd47ea0953c9528eb5b91fJamie Gennis#endif // ANDROID_GUI_ISURFACETEXTURE_H 92