gpu_startup_report.hpp

Go to the documentation of this file.

// gpu_startup_report.hpp — the always-on GPU bring-up lines a support read
// greps for.
//
// A shipped app's stdout/stderr is often the only evidence a remote support
// read gets. These formatters produce a handful of stable, greppable,
// info-level lines — the adapter Dawn actually picked, how long each bring-up
// stage took, and whether the Skia log bridge was wired — so a log that says
// "Graphite initialized" also says on WHAT and how fast. None of them is
// per-frame.
//
// The line shapes are a contract with downstream tooling: add fields at the
// end, never rename or reorder existing ones.
#pragma once
 
#if defined(PULP_GPU_RUNTIME)
// This build's device layer is gpu-runtime's (tools/cmake/PulpGpuRuntime.cmake):
// these are its types and functions under their Pulp names, so a Pulp object
// and a gpu-runtime object are one and the same.
#include <gpu_runtime/gpu_startup_report.hpp>
// The Pulp names of the types it uses, as the header always provided.
#include <pulp/render/gpu_diagnostics.hpp>
#include <pulp/render/gpu_surface.hpp>
 
namespace pulp::render {
using gpu_runtime::adapter_type_label;
using gpu_runtime::format_gpu_adapter_line;
using gpu_runtime::format_gpu_diagnostics_line;
using gpu_runtime::format_gpu_startup_line;
using gpu_runtime::GpuStartupReport;
using gpu_runtime::log_gpu_diagnostics_summary;
} // namespace pulp::render
#else // !PULP_GPU_RUNTIME
 
#include <pulp/render/gpu_diagnostics.hpp>
#include <pulp/render/gpu_surface.hpp>
 
#include <string>
 
namespace pulp::render {

const char* adapter_type_label(GpuSurface::AdapterType type) noexcept;

std::string format_gpu_adapter_line(const GpuSurface::AdapterInfo& info);

struct GpuStartupReport {
    GpuSurface::StartupTimings surface;
    double graphite_ms = -1.0;
    double first_frame_ms = -1.0;
};

std::string format_gpu_startup_line(const GpuStartupReport& report);

std::string format_gpu_diagnostics_line(const SkiaLogBridgeState& bridge,
                                        const GpuDiagnosticsStats& stats);

void log_gpu_diagnostics_summary();
 
} // namespace pulp::render
 
#endif // PULP_GPU_RUNTIME