content/public/browser/gpu_data_manager.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CONTENT_PUBLIC_BROWSER_GPU_DATA_MANAGER_H_
   6 #define CONTENT_PUBLIC_BROWSER_GPU_DATA_MANAGER_H_
   7
   8 #include <list>
   9 #include <string>
  10
  11 #include "base/callback_forward.h"
  12 #include "base/process/process.h"
  13 #include "content/common/content_export.h"
  14
  15 class GURL;
  16
  17 namespace base {
  18 class FilePath;
  19 class ListValue;
  20 }
  21
  22 namespace gpu {
  23 struct GPUInfo;
  24 }
  25
  26 namespace content {
  27
  28 class GpuDataManagerObserver;
  29
  30 // This class is fully thread-safe.
  31 class GpuDataManager {
  32  public:
  33   typedef base::Callback<void(const std::list<base::ProcessHandle>&)>
  34       GetGpuProcessHandlesCallback;
  35
  36   // Getter for the singleton.
  37   CONTENT_EXPORT static GpuDataManager* GetInstance();
  38
  39   virtual void InitializeForTesting(const std::string& gpu_blacklist_json,
  40                                     const gpu::GPUInfo& gpu_info) = 0;
  41
  42   virtual bool IsFeatureBlacklisted(int feature) const = 0;
  43
  44   virtual gpu::GPUInfo GetGPUInfo() const = 0;
  45
  46   // Retrieves a list of process handles for all gpu processes.
  47   virtual void GetGpuProcessHandles(
  48       const GetGpuProcessHandlesCallback& callback) const = 0;
  49
  50   // This indicator might change because we could collect more GPU info or
  51   // because the GPU blacklist could be updated.
  52   // If this returns false, any further GPU access, including launching GPU
  53   // process, establish GPU channel, and GPU info collection, should be
  54   // blocked.
  55   // Can be called on any thread.
  56   // If |reason| is not nullptr and GPU access is blocked, upon return, |reason|
  57   // contains a description of the reason why GPU access is blocked.
  58   virtual bool GpuAccessAllowed(std::string* reason) const = 0;
  59
  60   // Requests complete GPU info if it has not already been requested
  61   virtual void RequestCompleteGpuInfoIfNeeded() = 0;
  62
  63   // Check if basic and context GPU info have been collected.
  64   virtual bool IsEssentialGpuInfoAvailable() const = 0;
  65
  66   // On Windows, besides basic and context GPU info, it also checks if
  67   // DxDiagnostics have been collected.
  68   // On other platforms, it's the same as IsEsentialGpuInfoAvailable().
  69   virtual bool IsCompleteGpuInfoAvailable() const = 0;
  70
  71   // Requests that the GPU process report its current video memory usage stats,
  72   // which can be retrieved via the GPU data manager's on-update function.
  73   virtual void RequestVideoMemoryUsageStatsUpdate() const = 0;
  74
  75   // Returns true if SwiftShader should be used.
  76   virtual bool ShouldUseSwiftShader() const = 0;
  77
  78   // Register a path to SwiftShader.
  79   virtual void RegisterSwiftShaderPath(const base::FilePath& path) = 0;
  80
  81   // Returns current state about WARP, which may be due to command-line
  82   // arguments or saved state.
  83   virtual bool ShouldUseWarp() const = 0;
  84
  85   // Registers/unregister |observer|.
  86   virtual void AddObserver(GpuDataManagerObserver* observer) = 0;
  87   virtual void RemoveObserver(GpuDataManagerObserver* observer) = 0;
  88
  89   // Allows a given domain previously blocked from accessing 3D APIs
  90   // to access them again.
  91   virtual void UnblockDomainFrom3DAPIs(const GURL& url) = 0;
  92
  93   // Disable the gpu process watchdog thread.
  94   virtual void DisableGpuWatchdog() = 0;
  95
  96   // Set GL strings. This triggers a re-calculation of GPU blacklist
  97   // decision.
  98   virtual void SetGLStrings(const std::string& gl_vendor,
  99                             const std::string& gl_renderer,
 100                             const std::string& gl_version) = 0;
 101
 102   // Obtain collected GL strings.
 103   virtual void GetGLStrings(std::string* gl_vendor,
 104                             std::string* gl_renderer,
 105                             std::string* gl_version) = 0;
 106
 107   // Turn off all hardware acceleration.
 108   virtual void DisableHardwareAcceleration() = 0;
 109
 110   // Whether the browser compositor can be used.
 111   virtual bool CanUseGpuBrowserCompositor() const = 0;
 112
 113  protected:
 114   virtual ~GpuDataManager() {}
 115 };
 116
 117 };  // namespace content
 118
 119 #endif  // CONTENT_PUBLIC_BROWSER_GPU_DATA_MANAGER_H_