egl_display.h revision ada798b7ca7cabc255aa159964b64975e7fdb2df 
1/*
2 ** Copyright 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_EGL_DISPLAY_H
18#define ANDROID_EGL_DISPLAY_H
19
20
21#include <ctype.h>
22#include <stdint.h>
23#include <stdlib.h>
24
25#include <EGL/egl.h>
26#include <EGL/eglext.h>
27#include <GLES/gl.h>
28#include <GLES/glext.h>
29
30#include <utils/SortedVector.h>
31#include <utils/threads.h>
32#include <utils/String8.h>
33
34#include "egldefs.h"
35#include "hooks.h"
36
37// ----------------------------------------------------------------------------
38namespace android {
39// ----------------------------------------------------------------------------
40
41class egl_object_t;
42class egl_context_t;
43class egl_connection_t;
44
45// ----------------------------------------------------------------------------
46
47struct egl_config_t {
48    egl_config_t() {}
49    egl_config_t(EGLConfig config)
50        : config(config), configId(0), implConfigId(0) { }
51    EGLConfig   config;         // the implementation's EGLConfig
52    EGLint      configId;       // our CONFIG_ID
53    EGLint      implConfigId;   // the implementation's CONFIG_ID
54    inline bool operator < (const egl_config_t& rhs) const {
55        return config < rhs.config;
56    }
57};
58
59// ----------------------------------------------------------------------------
60
61class EGLAPI egl_display_t { // marked as EGLAPI for testing purposes
62    static egl_display_t sDisplay[NUM_DISPLAYS];
63    EGLDisplay getDisplay(EGLNativeDisplayType display);
64    void loseCurrentImpl(egl_context_t * cur_c);
65
66public:
67    enum {
68        NOT_INITIALIZED = 0,
69        INITIALIZED     = 1,
70        TERMINATED      = 2
71    };
72
73    egl_display_t();
74    ~egl_display_t();
75
76    EGLBoolean initialize(EGLint *major, EGLint *minor);
77    EGLBoolean terminate();
78
79    // add object to this display's list
80    void addObject(egl_object_t* object);
81    // remove object from this display's list
82    void removeObject(egl_object_t* object);
83    // add reference to this object. returns true if this is a valid object.
84    bool getObject(egl_object_t* object) const;
85
86    static egl_display_t* get(EGLDisplay dpy);
87    static EGLDisplay getFromNativeDisplay(EGLNativeDisplayType disp);
88
89    EGLBoolean makeCurrent(egl_context_t* c, egl_context_t* cur_c,
90            EGLSurface draw, EGLSurface read, EGLContext ctx,
91            EGLSurface impl_draw, EGLSurface impl_read, EGLContext impl_ctx);
92    static void loseCurrent(egl_context_t * cur_c);
93
94    inline bool isReady() const { return (refs > 0); }
95    inline bool isValid() const { return magic == '_dpy'; }
96    inline bool isAlive() const { return isValid(); }
97
98    char const * getVendorString() const { return mVendorString.string(); }
99    char const * getVersionString() const { return mVersionString.string(); }
100    char const * getClientApiString() const { return mClientApiString.string(); }
101    char const * getExtensionString() const { return mExtensionString.string(); }
102
103    inline uint32_t getRefsCount() const { return refs; }
104
105    struct strings_t {
106        char const * vendor;
107        char const * version;
108        char const * clientApi;
109        char const * extensions;
110    };
111
112    struct DisplayImpl {
113        DisplayImpl() : dpy(EGL_NO_DISPLAY), config(0),
114                        state(NOT_INITIALIZED), numConfigs(0) { }
115        EGLDisplay  dpy;
116        EGLConfig*  config;
117        EGLint      state;
118        EGLint      numConfigs;
119        strings_t   queryString;
120    };
121
122private:
123    uint32_t        magic;
124
125public:
126    DisplayImpl     disp;
127    EGLint          numTotalConfigs;
128    egl_config_t*   configs;
129
130private:
131            uint32_t                    refs;
132    mutable Mutex                       lock;
133            SortedVector<egl_object_t*> objects;
134            String8 mVendorString;
135            String8 mVersionString;
136            String8 mClientApiString;
137            String8 mExtensionString;
138};
139
140// ----------------------------------------------------------------------------
141
142inline egl_display_t* get_display(EGLDisplay dpy) {
143    return egl_display_t::get(dpy);
144}
145
146// ----------------------------------------------------------------------------
147
148egl_display_t* validate_display(EGLDisplay dpy);
149egl_connection_t* validate_display_config(EGLDisplay dpy,
150        EGLConfig config, egl_display_t const*& dp);
151EGLBoolean validate_display_context(EGLDisplay dpy, EGLContext ctx);
152EGLBoolean validate_display_surface(EGLDisplay dpy, EGLSurface surface);
153
154// ----------------------------------------------------------------------------
155}; // namespace android
156// ----------------------------------------------------------------------------
157
158#endif // ANDROID_EGL_DISPLAY_H
159