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,139 @@
+/* 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 <string>
+#include <vector>
+#include <unordered_set>
+#include <stdint.h>
+#include "small_vector.hpp"
+#include "global_managers.hpp"
+#include "hash.hpp"
+
+namespace Granite
+{
+enum class Stage
+{
+	Vertex,
+	Fragment = 4, // Skip over tess/geom to match Vulkan ordering
+	Compute,
+	Task,
+	Mesh,
+	Unknown
+};
+
+enum class Target
+{
+	Vulkan11,
+	Vulkan12,
+	Vulkan13
+};
+
+class GLSLCompiler
+{
+public:
+	explicit GLSLCompiler(FilesystemInterface &iface);
+
+	void set_target(Target target_)
+	{
+		target = target_;
+	}
+
+	void set_stage(Stage stage_)
+	{
+		stage = stage_;
+	}
+
+	void set_source(std::string source_, std::string path)
+	{
+		source = std::move(source_);
+		source_path = std::move(path);
+	}
+
+	void set_include_directories(const std::vector<std::string> *include_directories);
+
+	bool set_source_from_file(const std::string &path, Stage stage = Stage::Unknown);
+	bool set_source_from_file_multistage(const std::string &path);
+	bool preprocess();
+	Util::Hash get_source_hash() const;
+
+	std::vector<uint32_t> compile(std::string &error_message, const std::vector<std::pair<std::string, int>> *defines = nullptr) const;
+
+	const std::unordered_set<std::string> &get_dependencies() const
+	{
+		return dependencies;
+	}
+
+	enum class Optimization
+	{
+		ForceOff,
+		ForceOn,
+		Default
+	};
+
+	void set_optimization(Optimization opt)
+	{
+		optimization = opt;
+	}
+
+	void set_strip(bool strip_)
+	{
+		strip = strip_;
+	}
+
+	const std::vector<std::string> &get_user_pragmas() const
+	{
+		return pragmas;
+	}
+
+private:
+	FilesystemInterface &iface;
+	std::string source;
+	std::string source_path;
+	const std::vector<std::string> *include_directories = nullptr;
+	Stage stage = Stage::Unknown;
+
+	std::unordered_set<std::string> dependencies;
+	struct Section
+	{
+		Stage stage;
+		std::string source;
+	};
+	Util::SmallVector<Section> preprocessed_sections;
+	std::string preprocessed_source;
+	Stage preprocessing_active_stage = Stage::Unknown;
+
+	std::vector<std::pair<size_t, size_t>> preprocessed_lines;
+	std::vector<std::string> pragmas;
+
+	Target target = Target::Vulkan11;
+
+	bool parse_variants(const std::string &source, const std::string &path);
+
+	Optimization optimization = Optimization::Default;
+	bool strip = false;
+
+	bool find_include_path(const std::string &source_path, const std::string &include_path,
+	                       std::string &included_path, std::string &included_source);
+};
+}