launch_gpu_defaults_internal.h

#pragma once
 
#include "pixelbullet/application/specification.h"
#include "pixelbullet/graphics/gpu_session.h"
 
#include <filesystem>
#include <optional>
#include <string>
#include <string_view>
 
namespace pixelbullet::application_internal
{
struct SavedGpuLaunchDefault
{
    std::optional<uint32_t> gpu_index;
    std::optional<GraphicsDevicePreference> gpu_preference;
};
 
enum class LaunchGpuSelectorSource : uint8_t
{
    ImplicitAuto,
    ExplicitGpuPreference,
    ExplicitGpuIndex,
    SavedGpuPreference,
    SavedGpuIndex,
};
 
struct LaunchGpuDefaultsLoadResult
{
    std::filesystem::path path;
    std::optional<SavedGpuLaunchDefault> saved_default;
    std::string warning_message;
};
 
struct ResolvedLaunchGpuDefaults
{
    GraphicsDeviceSelection effective_selection;
    std::filesystem::path path;
    std::optional<SavedGpuLaunchDefault> saved_default;
    LaunchGpuSelectorSource selector_source = LaunchGpuSelectorSource::ImplicitAuto;
    bool applied_saved_default = false;
    std::string warning_message;
};
 
class ScopedPendingLaunchGpuDefaults
{
public:
    explicit ScopedPendingLaunchGpuDefaults(ResolvedLaunchGpuDefaults resolved_defaults);
    ~ScopedPendingLaunchGpuDefaults();
 
    ScopedPendingLaunchGpuDefaults(const ScopedPendingLaunchGpuDefaults&) = delete;
    ScopedPendingLaunchGpuDefaults& operator=(const ScopedPendingLaunchGpuDefaults&) = delete;
    ScopedPendingLaunchGpuDefaults(ScopedPendingLaunchGpuDefaults&&) = delete;
    ScopedPendingLaunchGpuDefaults& operator=(ScopedPendingLaunchGpuDefaults&&) = delete;
 
private:
    bool installed_ = false;
};
 
[[nodiscard]] bool HasExplicitGpuSelector(const ApplicationLaunchOptions& launch_options) noexcept;
[[nodiscard]] std::filesystem::path BuildLaunchGpuDefaultsPath(const std::filesystem::path& binary_path,
                                                               const std::filesystem::path& app_data_root);
[[nodiscard]] std::filesystem::path GetDefaultLaunchGpuDefaultsPath(const std::filesystem::path& binary_path);
[[nodiscard]] LaunchGpuDefaultsLoadResult LoadLaunchGpuDefaults(const std::filesystem::path& path);
[[nodiscard]] bool SaveLaunchGpuDefault(const std::filesystem::path& path, const SavedGpuLaunchDefault& saved_default,
                                        std::string* error_message);
[[nodiscard]] bool ClearLaunchGpuDefault(const std::filesystem::path& path, std::string* error_message);
[[nodiscard]] ResolvedLaunchGpuDefaults ResolveLaunchGpuDefaults(const ApplicationBootstrap& bootstrap);
[[nodiscard]] ResolvedLaunchGpuDefaults ResolveLaunchGpuDefaults(const ApplicationBootstrap& bootstrap,
                                                                 const std::filesystem::path& app_data_root);
[[nodiscard]] ResolvedLaunchGpuDefaults ConsumePendingLaunchGpuDefaults(const ApplicationBootstrap& bootstrap);
[[nodiscard]] GraphicsDeviceSelectionSession BuildGraphicsDeviceSelectionSession(const ResolvedLaunchGpuDefaults& resolved_defaults);
[[nodiscard]] std::string DescribeSavedGpuLaunchDefault(const SavedGpuLaunchDefault& saved_default);
[[nodiscard]] std::string DescribeResolvedGpuSelector(const ResolvedLaunchGpuDefaults& resolved_defaults);
} // namespace pixelbullet::application_internal