feat(host): vendor PyroWave + minimal Granite subset as crates/pyrowave-sys

Phase 0 of design/pyrowave-codec-plan.md — the opt-in wired-LAN ultra-low- latency codec. Vendored at upstream 509e4f88 (API 0.4.0, Granite 44362775, volk + vulkan-headers pins in PUNKTFUNK-VENDOR.txt), pruned to the 6.6 MB the standalone no-renderer build needs; scripts/vendor-pyrowave.sh reproduces the tree (a pin bump is protocol-affecting, plan §4.2). build.rs drives the wrapper CMakeLists (static archives incl. a static C-API lib upstream only ships shared) + bindgen over pyrowave.h; Linux and Windows only, empty stub elsewhere (Apple gets a native Metal port, §4.7). Offline-safe by construction: no network, no system lib, vendored Vulkan headers — same model as the opus dep (flatpak builder has no network). Phase-0 validation on .21 (RTX 5070 Ti, driver 610.43.03): - upstream pyrowave-c-test + interop test (incl. dmabuf/DRM-modifier Vulkan<->Vulkan) pass, from the pristine AND the pruned tree - GPU kernel times at ~1.6 bpp noise: encode/decode 0.090/0.042 ms @800p, 0.146/0.067 @1080p, 0.226/0.103 @1440p, 0.477/0.201 @4K — order of magnitude under NVENC's 1-2 ms retrieve, CBR lands within ~100 B of target - cargo test -p pyrowave-sys green (static link + API-version pin check) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-15 00:35:10 +02:00
parent 1b73361372
commit 4c3b11445c
396 changed files with 140058 additions and 0 deletions
@@ -0,0 +1,208 @@
+/* Copyright (c) 2017-2026 Hans-Kristian Arntzen
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+#pragma once
+
+#include "vulkan_headers.hpp"
+#include "vulkan_common.hpp"
+#include "object_pool.hpp"
+#include <functional>
+
+namespace Vulkan
+{
+class Device;
+
+class PerformanceQueryPool
+{
+public:
+	void init_device(Device *device, uint32_t queue_family_index);
+	~PerformanceQueryPool();
+	bool init_counters(const std::vector<std::string> &enable_counter_names);
+
+	void begin_command_buffer(VkCommandBuffer cmd);
+	void end_command_buffer(VkCommandBuffer cmd);
+
+	void report();
+
+	uint32_t get_num_counters() const;
+	const VkPerformanceCounterKHR *get_available_counters() const;
+	const VkPerformanceCounterDescriptionKHR *get_available_counter_descs() const;
+
+	static void log_available_counters(const VkPerformanceCounterKHR *counters,
+	                                   const VkPerformanceCounterDescriptionKHR *descs,
+	                                   uint32_t count);
+
+private:
+	Device *device = nullptr;
+	uint32_t queue_family_index = 0;
+	VkQueryPool pool = VK_NULL_HANDLE;
+	std::vector<VkPerformanceCounterResultKHR> results;
+	std::vector<VkPerformanceCounterKHR> counters;
+	std::vector<VkPerformanceCounterDescriptionKHR> counter_descriptions;
+	std::vector<uint32_t> active_indices;
+};
+
+class QueryPoolResult;
+
+struct QueryPoolResultDeleter
+{
+	void operator()(QueryPoolResult *query);
+};
+
+class QueryPoolResult : public Util::IntrusivePtrEnabled<QueryPoolResult, QueryPoolResultDeleter, HandleCounter>
+{
+public:
+	friend struct QueryPoolResultDeleter;
+
+	inline void signal_value(uint64_t ticks)
+	{
+		value = ticks;
+		has_value = true;
+	}
+
+	// Compatibility alias.
+	inline uint64_t get_timestamp_ticks() const
+	{
+		VK_ASSERT(type == VK_QUERY_TYPE_TIMESTAMP);
+		return value;
+	}
+
+	inline uint64_t get_value() const
+	{
+		return value;
+	}
+
+	inline bool is_signalled() const
+	{
+		return has_value;
+	}
+
+	inline bool is_device_timebase() const
+	{
+		return device_timebase;
+	}
+
+	inline VkQueryPool get_query_pool() const
+	{
+		return pool;
+	}
+
+	inline uint32_t get_query_pool_index() const
+	{
+		return index;
+	}
+
+private:
+	friend class Util::ObjectPool<QueryPoolResult>;
+
+	explicit QueryPoolResult(Device *device_, bool device_timebase_, VkQueryType type_,
+							 VkQueryPool pool_, uint32_t index_)
+		: device(device_), device_timebase(device_timebase_), type(type_), pool(pool_), index(index_)
+	{}
+
+	Device *device;
+	uint64_t value = 0;
+	bool has_value = false;
+	bool device_timebase = false;
+	VkQueryType type;
+	VkQueryPool pool;
+	uint32_t index;
+};
+
+using QueryPoolHandle = Util::IntrusivePtr<QueryPoolResult>;
+
+class QueryPool
+{
+public:
+	QueryPool(Device *device, VkQueryType type);
+	~QueryPool();
+
+	void begin();
+
+	QueryPoolHandle write_timestamp(VkCommandBuffer cmd, VkPipelineStageFlags2 stage);
+	QueryPoolHandle allocate_query(VkCommandBuffer cmd);
+
+private:
+	Device *device;
+	const VolkDeviceTable &table;
+	VkQueryType type;
+
+	struct Pool
+	{
+		VkQueryPool pool = VK_NULL_HANDLE;
+		std::vector<uint64_t> query_results;
+		std::vector<QueryPoolHandle> cookies;
+		unsigned index = 0;
+		unsigned size = 0;
+	};
+	std::vector<Pool> pools;
+	unsigned pool_index = 0;
+
+	void add_pool();
+
+	bool supports_type = false;
+};
+
+class TimestampInterval : public Util::IntrusiveHashMapEnabled<TimestampInterval>
+{
+public:
+	explicit TimestampInterval(std::string tag);
+
+	void accumulate_time(double t);
+	double get_time_per_iteration() const;
+	double get_time_per_accumulation() const;
+	const std::string &get_tag() const;
+	void mark_end_of_frame_context();
+
+	double get_total_time() const;
+	uint64_t get_total_frame_iterations() const;
+	uint64_t get_total_accumulations() const;
+	void reset();
+
+private:
+	std::string tag;
+	double total_time = 0.0;
+	uint64_t total_frame_iterations = 0;
+	uint64_t total_accumulations = 0;
+};
+
+struct TimestampIntervalReport
+{
+	double time_per_accumulation;
+	double time_per_frame_context;
+	double accumulations_per_frame_context;
+};
+
+using TimestampIntervalReportCallback = std::function<void (const std::string &, const TimestampIntervalReport &)>;
+
+class TimestampIntervalManager
+{
+public:
+	TimestampInterval *get_timestamp_tag(const char *tag);
+	void mark_end_of_frame_context();
+	void reset();
+	void log_simple(const TimestampIntervalReportCallback &func = {}) const;
+
+private:
+	Util::IntrusiveHashMap<TimestampInterval> timestamps;
+};
+}