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>
This commit is contained in:
2026-07-15 00:35:10 +02:00
parent 1b73361372
commit 4c3b11445c
396 changed files with 140058 additions and 0 deletions
@@ -0,0 +1,156 @@
/* 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.
*/
#include "android.hpp"
#include "path_utils.hpp"
#include "logging.hpp"
#include <algorithm>
#include <stdexcept>
namespace Granite
{
bool AssetFile::init(AAssetManager *mgr, const std::string &path, FileMode mode)
{
if (mode != FileMode::ReadOnly)
{
LOGE("Asset files must be opened read-only.\n");
return false;
}
asset = AAssetManager_open(mgr, path.c_str(), AASSET_MODE_BUFFER);
if (!asset)
return false;
size = AAsset_getLength64(asset);
return true;
}
FileHandle AssetFile::open(AAssetManager *mgr, const std::string &path, Granite::FileMode mode)
{
auto file = Util::make_handle<AssetFile>();
if (!file->init(mgr, path, mode))
file.reset();
return file;
}
FileMappingHandle AssetFile::map_subset(uint64_t offset, size_t range)
{
if (offset + range > size)
return {};
auto *data = static_cast<uint8_t *>(const_cast<void *>(AAsset_getBuffer(asset)));
if (!data)
return {};
return Util::make_handle<FileMapping>(
reference_from_this(), offset,
data + offset, range,
0, range);
}
uint64_t AssetFile::get_size()
{
return size;
}
FileMappingHandle AssetFile::map_write(size_t)
{
return {};
}
void AssetFile::unmap(void *, size_t)
{
}
AssetFile::~AssetFile()
{
if (asset)
AAsset_close(asset);
}
AssetManagerFilesystem::AssetManagerFilesystem(const std::string &base_)
: base(base_), mgr(global_asset_manager)
{
}
FileHandle AssetManagerFilesystem::open(const std::string &path, FileMode mode)
{
return AssetFile::open(mgr, Path::join(base, Path::canonicalize_path(path)), mode);
}
int AssetManagerFilesystem::get_notification_fd() const
{
return -1;
}
void AssetManagerFilesystem::poll_notifications()
{
}
void AssetManagerFilesystem::uninstall_notification(FileNotifyHandle)
{
}
FileNotifyHandle AssetManagerFilesystem::install_notification(const std::string &,
std::function<void (const FileNotifyInfo &)>)
{
return -1;
}
std::vector<ListEntry> AssetManagerFilesystem::list(const std::string &path)
{
auto directory = Path::join(base, Path::canonicalize_path(path));
auto *dir = AAssetManager_openDir(mgr, directory.c_str());
if (!dir)
return {};
std::vector<ListEntry> entries;
const char *entry;
while ((entry = AAssetDir_getNextFileName(dir)))
{
PathType type = PathType::File;
entries.push_back({ entry, type });
}
AAssetDir_close(dir);
return entries;
}
bool AssetManagerFilesystem::stat(const std::string &path, FileStat &stat)
{
auto resolved_path = Path::join(base, Path::canonicalize_path(path));
auto *asset = AAssetManager_open(mgr, resolved_path.c_str(), AASSET_MODE_UNKNOWN);
if (!asset)
return false;
stat.size = AAsset_getLength(asset);
stat.type = PathType::File;
stat.last_modified = 0;
AAsset_close(asset);
return true;
}
AAssetManager *AssetManagerFilesystem::global_asset_manager;
}