egl_display.h revision 4b9511c16195a646242eff833b0af212933b6eca 
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_connection_t;
43
44// ----------------------------------------------------------------------------
45
46struct egl_config_t {
47    egl_config_t() {}
48    egl_config_t(int impl, EGLConfig config)
49        : impl(impl), config(config), configId(0), implConfigId(0) { }
50    int         impl;           // the implementation this config is for
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        if (impl < rhs.impl) return true;
56        if (impl > rhs.impl) return false;
57        return config < rhs.config;
58    }
59};
60
61// ----------------------------------------------------------------------------
62
63class EGLAPI egl_display_t { // marked as EGLAPI for testing purposes
64    static egl_display_t sDisplay[NUM_DISPLAYS];
65    EGLDisplay getDisplay(EGLNativeDisplayType display);
66
67public:
68    enum {
69        NOT_INITIALIZED = 0,
70        INITIALIZED     = 1,
71        TERMINATED      = 2
72    };
73
74    egl_display_t();
75    ~egl_display_t();
76
77    EGLBoolean initialize(EGLint *major, EGLint *minor);
78    EGLBoolean terminate();
79
80    // add object to this display's list
81    void addObject(egl_object_t* object);
82    // remove object from this display's list
83    void removeObject(egl_object_t* object);
84    // add reference to this object. returns true if this is a valid object.
85    bool getObject(egl_object_t* object) const;
86
87
88    static egl_display_t* get(EGLDisplay dpy);
89    static EGLDisplay getFromNativeDisplay(EGLNativeDisplayType disp);
90
91    inline bool isReady() const { return (refs > 0); }
92    inline bool isValid() const { return magic == '_dpy'; }
93    inline bool isAlive() const { return isValid(); }
94
95    char const * getVendorString() const { return mVendorString.string(); }
96    char const * getVersionString() const { return mVersionString.string(); }
97    char const * getClientApiString() const { return mClientApiString.string(); }
98    char const * getExtensionString() const { return mExtensionString.string(); }
99
100    inline uint32_t getRefsCount() const { return refs; }
101
102    struct strings_t {
103        char const * vendor;
104        char const * version;
105        char const * clientApi;
106        char const * extensions;
107    };
108
109    struct DisplayImpl {
110        DisplayImpl() : dpy(EGL_NO_DISPLAY), config(0),
111                        state(NOT_INITIALIZED), numConfigs(0) { }
112        EGLDisplay  dpy;
113        EGLConfig*  config;
114        EGLint      state;
115        EGLint      numConfigs;
116        strings_t   queryString;
117    };
118
119private:
120    uint32_t        magic;
121
122public:
123    DisplayImpl     disp[IMPL_NUM_IMPLEMENTATIONS];
124    EGLint          numTotalConfigs;
125    egl_config_t*   configs;
126
127private:
128            uint32_t                    refs;
129    mutable Mutex                       lock;
130            SortedVector<egl_object_t*> objects;
131            String8 mVendorString;
132            String8 mVersionString;
133            String8 mClientApiString;
134            String8 mExtensionString;
135};
136
137// ----------------------------------------------------------------------------
138
139inline egl_display_t* get_display(EGLDisplay dpy) {
140    return egl_display_t::get(dpy);
141}
142
143// ----------------------------------------------------------------------------
144
145egl_display_t* validate_display(EGLDisplay dpy);
146egl_connection_t* validate_display_config(EGLDisplay dpy,
147        EGLConfig config, egl_display_t const*& dp);
148EGLBoolean validate_display_context(EGLDisplay dpy, EGLContext ctx);
149EGLBoolean validate_display_surface(EGLDisplay dpy, EGLSurface surface);
150
151// ----------------------------------------------------------------------------
152}; // namespace android
153// ----------------------------------------------------------------------------
154
155#endif // ANDROID_EGL_DISPLAY_H
156