Home | History | Annotate | Download | only in graphicsenv
      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