1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149
|
// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
// This file contains some useful utilities for the ui/gl classes.
#ifndef UI_GL_GL_UTILS_H_
#define UI_GL_GL_UTILS_H_
#include "base/command_line.h"
#include "base/memory/raw_ptr.h"
#include "build/build_config.h"
#include "ui/gl/gl_export.h"
#include "ui/gl/gpu_preference.h"
#if BUILDFLAG(IS_WIN)
#include <dxgi1_6.h>
#endif
#if BUILDFLAG(IS_ANDROID)
#include "base/files/scoped_file.h"
#endif
namespace gl {
class GLApi;
class GLDisplayEGL;
class GLDisplay;
GL_EXPORT void Crash();
GL_EXPORT void Hang();
#if BUILDFLAG(IS_ANDROID)
GL_EXPORT base::ScopedFD MergeFDs(base::ScopedFD a, base::ScopedFD b);
// Disable ANGLE and force to use native or other GL implementation.
GL_EXPORT void DisableANGLE();
#endif
GL_EXPORT bool UsePassthroughCommandDecoder(
const base::CommandLine* command_line);
// Defines a set of workarounds that can be passed to ui/gl using the
// SetGlWorkarounds function below.
struct GlWorkarounds {
bool disable_d3d11 = false;
bool disable_metal = false;
bool disable_es3gl_context = false;
bool disable_es3gl_context_for_testing = false;
bool disable_direct_composition_video_overlays = false;
bool disable_vp_auto_hdr = false;
};
// Obtains the global GlWorkarounds. For use by ui/gl code to determine which
// workarounds have been set by a call to SetGlWorkarounds.
GL_EXPORT const GlWorkarounds& GetGlWorkarounds();
// Sets the GlWorkarounds. This should be called from the code hosting ui/gl.
GL_EXPORT void SetGlWorkarounds(const GlWorkarounds& workarounds);
#if BUILDFLAG(IS_WIN)
// BufferCount for the root surface swap chain.
GL_EXPORT unsigned int DirectCompositionRootSurfaceBufferCount();
// Labels swapchain with the name_prefix and its buffers with the string
// name_prefix + _Buffer_ + <buffer_number>.
GL_EXPORT void LabelSwapChainAndBuffers(IDXGISwapChain* swap_chain,
const char* name_prefix);
// Same as LabelSwapChainAndBuffers, but only does the buffers. Used for resize
// operations.
GL_EXPORT void LabelSwapChainBuffers(IDXGISwapChain* swap_chain,
const char* name_prefix);
#endif
// The following functions expose functionalities from GLDisplayManagerEGL
// and GLDisplayManagerX11 for access outside the ui/gl module. This is because
// the two GLDisplayManager classes are singletons and in component build,
// calling GetInstance() directly returns different instances in different
// components.
// Add an entry <preference, system_device_id> to GLDisplayManagerEGL.
GL_EXPORT void SetGpuPreferenceEGL(GpuPreference preference,
uint64_t system_device_id);
// Return the value for the entry at <preference> from GLDisplayManagerEGL.
GL_EXPORT uint64_t GetSystemDeviceIdEGLForTesting(GpuPreference preference);
// Remove the entry at <preference> from GLDisplayManagerEGL.
GL_EXPORT void RemoveGpuPreferenceEGL(GpuPreference preference);
// Query the default GLDisplay. May return either a GLDisplayEGL or
// GLDisplayX11.
GL_EXPORT GLDisplay* GetDefaultDisplay();
// Query the GLDisplay by |gpu_preference|. May return either a GLDisplayEGL or
// GLDisplayX11.
GL_EXPORT GLDisplay* GetDisplay(GpuPreference gpu_preference);
// Query the GLDisplay by |gpu_preference| and |display_key|. May return either
// a GLDisplayEGL or GLDisplayX11.
GL_EXPORT GLDisplay* GetDisplay(GpuPreference gpu_preference,
gl::DisplayKey display_key);
// Query the default GLDisplayEGL.
GL_EXPORT GLDisplayEGL* GetDefaultDisplayEGL();
// Query the GLDisplayEGL by |gpu_preference|.
GL_EXPORT GLDisplayEGL* GetDisplayEGL(GpuPreference gpu_preference);
// Temporarily allows compilation of shaders that use the
// ARB_texture_rectangle/ANGLE_texture_rectangle extension. We don't want to
// expose the extension to WebGL user shaders but we still need to use it for
// parts of the implementation on macOS. Note that the extension is always
// enabled on macOS and this only controls shader compilation.
class GL_EXPORT ScopedEnableTextureRectangleInShaderCompiler {
public:
ScopedEnableTextureRectangleInShaderCompiler(
const ScopedEnableTextureRectangleInShaderCompiler&) = delete;
ScopedEnableTextureRectangleInShaderCompiler& operator=(
const ScopedEnableTextureRectangleInShaderCompiler&) = delete;
// This class is a no-op except on macOS.
#if !BUILDFLAG(IS_MAC)
explicit ScopedEnableTextureRectangleInShaderCompiler(gl::GLApi* gl_api) {}
#else
explicit ScopedEnableTextureRectangleInShaderCompiler(gl::GLApi* gl_api);
~ScopedEnableTextureRectangleInShaderCompiler();
private:
raw_ptr<gl::GLApi> gl_api_;
#endif
};
class GL_EXPORT ScopedPixelStore {
public:
ScopedPixelStore(unsigned int name, int value);
~ScopedPixelStore();
ScopedPixelStore(ScopedPixelStore&) = delete;
ScopedPixelStore& operator=(ScopedPixelStore&) = delete;
private:
const unsigned int name_;
const int old_value_;
const int value_;
};
} // namespace gl
#endif // UI_GL_GL_UTILS_H_
|