vtkWebGPUConfiguration.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-License-Identifier: BSD-3-Clause
#ifndef vtkWebGPUConfiguration_h
#define vtkWebGPUConfiguration_h
 
#include "vtkObject.h"
 
#include "vtkCommand.h"               // for vtkCommand
#include "vtkRenderingWebGPUModule.h" // for export macro
#include "vtk_wgpu.h"                 // for wgpu
 
#include <memory> // for unique_ptr
 
VTK_ABI_NAMESPACE_BEGIN
 
class vtkWebGPURenderWindow;
class vtkWebGPUComputePipeline;
class vtkWebGPUConfigurationInternals;
 
class VTKRENDERINGWEBGPU_EXPORT vtkWebGPUConfiguration : public vtkObject
{
public:
  static vtkWebGPUConfiguration* New();
  vtkTypeMacro(vtkWebGPUConfiguration, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
  enum class PowerPreferenceType
  {
    Undefined,
    LowPower,
    HighPerformance
  };
 
  enum class BackendType
  {
    Undefined,
    Null,
    WebGPU,
    D3D11,
    D3D12,
    Metal,
    Vulkan,
    OpenGL,
    OpenGLES
  };
 
 
  vtkSetEnumMacro(PowerPreference, PowerPreferenceType);
  vtkGetEnumMacro(PowerPreference, PowerPreferenceType);
 
 
  vtkSetEnumMacro(Backend, BackendType);
  vtkGetEnumMacro(Backend, BackendType);
 
 
  vtkSetMacro(Timeout, double);
  vtkGetMacro(Timeout, double);
 
  static void SetDefaultTimeout(double);
 
  BackendType GetBackendInUse();
 
  std::string GetBackendInUseAsString();
 
 
  wgpu::Adapter GetAdapter();
  wgpu::Device GetDevice();
  wgpu::Instance GetInstance();
 
  bool Initialize();
 
  void Finalize();
 
  void ProcessEvents();
 
  static std::size_t Align(std::size_t value, std::size_t alignment);
 
  enum
  {
    AdapterRequestCompletedEvent = vtkCommand::UserEvent,
    DeviceRequestCompletedEvent,
  };
 
  std::string ReportCapabilities();
  static std::string DeviceNotReadyMessage();
 
  std::uint32_t GetAdapterVendorID();
  std::uint32_t GetAdapterDeviceID();
 
 
  bool IsAMDGPUInUse();
  bool IsAppleGPUInUse();
  bool IsARMGPUInUse();
  bool IsBroadcomGPUInUse();
  bool IsIntelGPUInUse();
  bool IsMesaGPUInUse();
  bool IsMicrosoftGPUInUse();
  bool IsNVIDIAGPUInUse();
  bool IsSamsungGPUInUse();
 
protected:
  vtkWebGPUConfiguration();
  ~vtkWebGPUConfiguration() override;
 
  PowerPreferenceType PowerPreference = PowerPreferenceType::HighPerformance;
  // Initialized in constructor at runtime based on the operating system.
  BackendType Backend;
  // In milliseconds
  double Timeout;
 
  void AcquireAdapter(vtkObject* caller, unsigned long event, void* calldata);
 
  void AcquireDevice(vtkObject* caller, unsigned long event, void* calldata);
 
private:
  vtkWebGPUConfiguration(const vtkWebGPUConfiguration&) = delete;
  void operator=(const vtkWebGPUConfiguration&) = delete;
 
  friend class vtkWebGPUConfigurationInternals;
  std::unique_ptr<vtkWebGPUConfigurationInternals> Internals;
};
 
VTK_ABI_NAMESPACE_END
 
#endif