EglManager.h revision c96955d9bb997b51be5fa929b5a67349d0459c3a 
1/*
2 * Copyright (C) 2014 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#ifndef EGLMANAGER_H
17#define EGLMANAGER_H
18
19#include <cutils/compiler.h>
20#include <EGL/egl.h>
21#include <SkRect.h>
22#include <ui/GraphicBuffer.h>
23#include <utils/StrongPointer.h>
24
25namespace android {
26namespace uirenderer {
27namespace renderthread {
28
29class RenderThread;
30class EglManager;
31
32class Frame {
33public:
34    EGLint width() const { return mWidth; }
35    EGLint height() const { return mHeight; }
36
37    // See: https://www.khronos.org/registry/egl/extensions/EXT/EGL_EXT_buffer_age.txt
38    // for what this means
39    EGLint bufferAge() const { return mBufferAge; }
40
41private:
42    friend class EglManager;
43
44    EGLSurface mSurface;
45    EGLint mWidth;
46    EGLint mHeight;
47    EGLint mBufferAge;
48
49    // Maps from 0,0 in top-left to 0,0 in bottom-left
50    // If out is not an EGLint[4] you're going to have a bad time
51    void map(const SkRect& in, EGLint* out) const;
52};
53
54// This class contains the shared global EGL objects, such as EGLDisplay
55// and EGLConfig, which are re-used by CanvasContext
56class EglManager {
57public:
58    // Returns true on success, false on failure
59    void initialize();
60
61    bool hasEglContext();
62
63    EGLSurface createSurface(EGLNativeWindowType window);
64    void destroySurface(EGLSurface surface);
65
66    void destroy();
67
68    bool isCurrent(EGLSurface surface) { return mCurrentSurface == surface; }
69    // Returns true if the current surface changed, false if it was already current
70    bool makeCurrent(EGLSurface surface, EGLint* errOut = nullptr);
71    Frame beginFrame(EGLSurface surface);
72    void damageFrame(const Frame& frame, const SkRect& dirty);
73    // If this returns true it is mandatory that swapBuffers is called
74    // if damageFrame is called without subsequent calls to damageFrame().
75    // See EGL_KHR_partial_update for more information
76    bool damageRequiresSwap();
77    bool swapBuffers(const Frame& frame, const SkRect& screenDirty);
78
79    // Returns true iff the surface is now preserving buffers.
80    bool setPreserveBuffer(EGLSurface surface, bool preserve);
81
82    void setTextureAtlas(const sp<GraphicBuffer>& buffer, int64_t* map, size_t mapSize);
83
84    void fence();
85
86private:
87    friend class RenderThread;
88
89    EglManager(RenderThread& thread);
90    // EglContext is never destroyed, method is purposely not implemented
91    ~EglManager();
92
93    void initExtensions();
94    void createPBufferSurface();
95    void loadConfig();
96    void createContext();
97    void initAtlas();
98    EGLint queryBufferAge(EGLSurface surface);
99
100    RenderThread& mRenderThread;
101
102    EGLDisplay mEglDisplay;
103    EGLConfig mEglConfig;
104    EGLContext mEglContext;
105    EGLSurface mPBufferSurface;
106
107    EGLSurface mCurrentSurface;
108
109    sp<GraphicBuffer> mAtlasBuffer;
110    int64_t* mAtlasMap;
111    size_t mAtlasMapSize;
112
113    enum class SwapBehavior {
114        Discard,
115        Preserved,
116        BufferAge,
117    };
118    SwapBehavior mSwapBehavior = SwapBehavior::Discard;
119};
120
121} /* namespace renderthread */
122} /* namespace uirenderer */
123} /* namespace android */
124
125#endif /* EGLMANAGER_H */
126