1/*
2 * Copyright (C) 2007 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#ifndef ANDROID_SF_FRAMEBUFFER_SURFACE_H
18#define ANDROID_SF_FRAMEBUFFER_SURFACE_H
19
20#include <stdint.h>
21#include <sys/types.h>
22
23#include <gui/ConsumerBase.h>
24
25// ---------------------------------------------------------------------------
26namespace android {
27// ---------------------------------------------------------------------------
28
29class Rect;
30class String8;
31class HWComposer;
32
33// ---------------------------------------------------------------------------
34
35class FramebufferSurface : public ConsumerBase {
36public:
37    FramebufferSurface(HWComposer& hwc, int disp);
38
39    bool isUpdateOnDemand() const { return false; }
40    status_t setUpdateRectangle(const Rect& updateRect);
41    status_t compositionComplete();
42
43    virtual void dump(String8& result);
44
45    // setReleaseFenceFd stores a fence file descriptor that will signal when the
46    // current buffer is no longer being read. This fence will be returned to
47    // the producer when the current buffer is released by updateTexImage().
48    // Multiple fences can be set for a given buffer; they will be merged into
49    // a single union fence. The SurfaceTexture will close the file descriptor
50    // when finished with it.
51    status_t setReleaseFenceFd(int fenceFd);
52
53private:
54    virtual ~FramebufferSurface() { }; // this class cannot be overloaded
55
56    virtual void onFrameAvailable();
57    virtual void freeBufferLocked(int slotIndex);
58
59    // nextBuffer waits for and then latches the next buffer from the
60    // BufferQueue and releases the previously latched buffer to the
61    // BufferQueue.  The new buffer is returned in the 'buffer' argument.
62    status_t nextBuffer(sp<GraphicBuffer>& outBuffer, sp<Fence>& outFence);
63
64    // mDisplayType must match one of the HWC display types
65    int mDisplayType;
66
67    // mCurrentBufferIndex is the slot index of the current buffer or
68    // INVALID_BUFFER_SLOT to indicate that either there is no current buffer
69    // or the buffer is not associated with a slot.
70    int mCurrentBufferSlot;
71
72    // mCurrentBuffer is the current buffer or NULL to indicate that there is
73    // no current buffer.
74    sp<GraphicBuffer> mCurrentBuffer;
75
76    // Hardware composer, owned by SurfaceFlinger.
77    HWComposer& mHwc;
78};
79
80// ---------------------------------------------------------------------------
81}; // namespace android
82// ---------------------------------------------------------------------------
83
84#endif // ANDROID_SF_FRAMEBUFFER_SURFACE_H
85
86