samples/config_helper_vulkan.h

// Copyright 2019 The Amber Authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#ifndef SAMPLES_CONFIG_HELPER_VULKAN_H_
#define SAMPLES_CONFIG_HELPER_VULKAN_H_

#include <vulkan/vulkan.h>

#include <limits>
#include <memory>
#include <string>
#include <vector>

#include "amber/amber.h"
#include "amber/amber_vulkan.h"
#include "samples/config_helper.h"

namespace sample {

// Child class of ConfigHelperImpl for Vulkan.
class ConfigHelperVulkan : public ConfigHelperImpl {
 public:
  ConfigHelperVulkan();
  ~ConfigHelperVulkan() override;

  // Create Vulkan instance and device and return them as
  // amber::VulkanEngineConfig. Required Vulkan device features and
  // extensions are given in |required_features| and
  // |required_extensions|, respectively.
  amber::Result CreateConfig(
      const std::vector<std::string>& required_features,
      const std::vector<std::string>& required_extensions,
      bool disable_validation_layer,
      std::unique_ptr<amber::EngineConfig>* config) override;

  // Destroy Vulkan instance and device.
  amber::Result Shutdown() override;

 private:
  // Create Vulkan instance.
  amber::Result CreateVulkanInstance(bool disable_validation_layer);

  // Create |vulkan_callback_| that reports validation layer errors
  // via debugCallback() function in config_helper_vulkan.cc.
  amber::Result CreateDebugReportCallback();

  // Choose Vulkan physical device that supports both
  // |required_features| and |required_extensions|.
  amber::Result ChooseVulkanPhysicalDevice(
      const VkPhysicalDeviceFeatures& required_features,
      const std::vector<std::string>& required_extensions);

  // Create Vulkan logical device that enables both
  // |required_features| and |required_extensions|.
  amber::Result CreateVulkanDevice(
      const VkPhysicalDeviceFeatures& required_features,
      const std::vector<std::string>& required_extensions);

  VkInstance vulkan_instance_ = VK_NULL_HANDLE;
  VkDebugReportCallbackEXT vulkan_callback_ = VK_NULL_HANDLE;
  VkPhysicalDevice vulkan_physical_device_ = VK_NULL_HANDLE;
  VkPhysicalDeviceFeatures available_features_ = {};
  std::vector<std::string> available_extensions_;
  uint32_t vulkan_queue_family_index_ = std::numeric_limits<uint32_t>::max();
  VkQueue vulkan_queue_ = VK_NULL_HANDLE;
  VkDevice vulkan_device_ = VK_NULL_HANDLE;
};

}  // namespace sample

#endif  // SAMPLES_CONFIG_HELPER_VULKAN_H_