include/gui/GraphicsEnv.h

   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_GUI_GRAPHICS_ENV_H
  18 #define ANDROID_GUI_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 private:
  39     GraphicsEnv() = default;
  40     std::string mDriverPath;
  41     android_namespace_t* mDriverNamespace = nullptr;
  42 };
  43
  44 } // namespace android
  45
  46 /* FIXME
  47  * Export an un-mangled function that just does
  48  *     return android::GraphicsEnv::getInstance().getDriverNamespace();
  49  * This allows libEGL to get the function pointer via dlsym, since it can't
  50  * directly link against libgui. In a future release, we'll fix this so that
  51  * libgui does not depend on graphics API libraries, and libEGL can link
  52  * against it. The current dependencies from libgui -> libEGL are:
  53  *  - the GLConsumer class, which should be moved to its own library
  54  *  - the EGLsyncKHR synchronization in BufferQueue, which is deprecated and
  55  *    will be removed soon.
  56  */
  57 extern "C" android_namespace_t* android_getDriverNamespace();
  58
  59 #endif // ANDROID_GUI_GRAPHICS_ENV_H