1 /*
2  * Copyright 2017 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_UI_GRAPHICS_ENV_H
18 #define ANDROID_UI_GRAPHICS_ENV_H 1
19 
20 #include <string>
21 
22 struct android_namespace_t;
23 
24 namespace android {
25 
26 class GraphicsEnv {
27 public:
28     static GraphicsEnv& getInstance();
29 
30     // Set a search path for loading graphics drivers. The path is a list of
31     // directories separated by ':'. A directory can be contained in a zip file
32     // (drivers must be stored uncompressed and page aligned); such elements
33     // in the search path must have a '!' after the zip filename, e.g.
34     //     /data/app/com.example.driver/base.apk!/lib/arm64-v8a
35     void setDriverPath(const std::string path);
36     android_namespace_t* getDriverNamespace();
37 
38     void setLayerPaths(android_namespace_t* appNamespace, const std::string layerPaths);
39     android_namespace_t* getAppNamespace();
40     const std::string getLayerPaths();
41 
42     void setDebugLayers(const std::string layers);
43     const std::string getDebugLayers();
44 
45 private:
46     GraphicsEnv() = default;
47     std::string mDriverPath;
48     std::string mDebugLayers;
49     std::string mLayerPaths;
50     android_namespace_t* mDriverNamespace = nullptr;
51     android_namespace_t* mAppNamespace = nullptr;
52 };
53 
54 } // namespace android
55 
56 /* FIXME
57  * Export an un-mangled function that just does
58  *     return android::GraphicsEnv::getInstance().getDriverNamespace();
59  * This allows libEGL to get the function pointer via dlsym, since it can't
60  * directly link against libgui. In a future release, we'll fix this so that
61  * libgui does not depend on graphics API libraries, and libEGL can link
62  * against it. The current dependencies from libgui -> libEGL are:
63  *  - the GLConsumer class, which should be moved to its own library
64  *  - the EGLsyncKHR synchronization in BufferQueue, which is deprecated and
65  *    will be removed soon.
66  */
67 extern "C" android_namespace_t* android_getDriverNamespace();
68 
69 #endif // ANDROID_UI_GRAPHICS_ENV_H
70