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,154 @@
+/* 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 "cookie.hpp"
+#include "vulkan_common.hpp"
+#include "vulkan_headers.hpp"
+#include "object_pool.hpp"
+#include "memory_allocator.hpp"
+
+namespace Vulkan
+{
+enum class StockSampler
+{
+	NearestClamp,
+	LinearClamp,
+	TrilinearClamp,
+	NearestWrap,
+	LinearWrap,
+	TrilinearWrap,
+	NearestShadow,
+	LinearShadow,
+	DefaultGeometryFilterClamp,
+	DefaultGeometryFilterWrap,
+	Count
+};
+
+struct SamplerCreateInfo
+{
+	VkFilter mag_filter;
+	VkFilter min_filter;
+	VkSamplerMipmapMode mipmap_mode;
+	VkSamplerAddressMode address_mode_u;
+	VkSamplerAddressMode address_mode_v;
+	VkSamplerAddressMode address_mode_w;
+	float mip_lod_bias;
+	VkBool32 anisotropy_enable;
+	float max_anisotropy;
+	VkBool32 compare_enable;
+	VkCompareOp compare_op;
+	float min_lod;
+	float max_lod;
+	VkBorderColor border_color;
+	VkBool32 unnormalized_coordinates;
+};
+
+class Sampler;
+struct SamplerDeleter
+{
+	void operator()(Sampler *sampler);
+};
+
+class Sampler : public Util::IntrusivePtrEnabled<Sampler, SamplerDeleter, HandleCounter>,
+                public Cookie, public InternalSyncEnabled
+{
+public:
+	friend struct SamplerDeleter;
+	~Sampler();
+
+	VkSampler get_sampler() const
+	{
+		return sampler;
+	}
+
+	const CachedDescriptorPayload &get_descriptor_payload() const
+	{
+		VK_ASSERT(payload && payload.type == VK_DESCRIPTOR_TYPE_SAMPLER);
+		return payload;
+	}
+
+	const SamplerCreateInfo &get_create_info() const
+	{
+		return create_info;
+	}
+
+	static VkSamplerCreateInfo fill_vk_sampler_info(const SamplerCreateInfo &sampler_info);
+	static SamplerCreateInfo fill_sampler_info(const VkSamplerCreateInfo &sampler_info);
+
+private:
+	friend class Util::ObjectPool<Sampler>;
+	Sampler(Device *device, VkSampler sampler, const SamplerCreateInfo &info, bool immutable);
+
+	Device *device;
+	VkSampler sampler;
+	CachedDescriptorPayload payload;
+	SamplerCreateInfo create_info;
+	bool immutable;
+};
+using SamplerHandle = Util::IntrusivePtr<Sampler>;
+
+class ImmutableYcbcrConversion : public HashedObject<ImmutableYcbcrConversion>
+{
+public:
+	ImmutableYcbcrConversion(Util::Hash hash, Device *device,
+	                         const VkSamplerYcbcrConversionCreateInfo &info);
+	~ImmutableYcbcrConversion();
+	void operator=(const ImmutableYcbcrConversion &) = delete;
+	ImmutableYcbcrConversion(const ImmutableYcbcrConversion &) = delete;
+
+	VkSamplerYcbcrConversion get_conversion() const
+	{
+		return conversion;
+	}
+
+private:
+	Device *device;
+	VkSamplerYcbcrConversion conversion = VK_NULL_HANDLE;
+};
+
+class ImmutableSampler : public HashedObject<ImmutableSampler>
+{
+public:
+	ImmutableSampler(Util::Hash hash, Device *device,
+	                 const SamplerCreateInfo &info,
+	                 const ImmutableYcbcrConversion *ycbcr);
+	void operator=(const ImmutableSampler &) = delete;
+	ImmutableSampler(const ImmutableSampler &) = delete;
+
+	const Sampler &get_sampler() const
+	{
+		return *sampler;
+	}
+
+	VkSamplerYcbcrConversion get_ycbcr_conversion() const
+	{
+		return ycbcr ? ycbcr->get_conversion() : VK_NULL_HANDLE;
+	}
+
+private:
+	Device *device;
+	const ImmutableYcbcrConversion *ycbcr;
+	SamplerHandle sampler;
+};
+}