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,146 @@
/* 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 "indirect_layout.hpp"
#include "device.hpp"
namespace Vulkan
{
IndirectLayout::IndirectLayout(Device *device_,
const PipelineLayout *pipeline_layout, const IndirectLayoutToken *tokens,
uint32_t num_tokens, uint32_t stride)
: device(device_)
{
VkIndirectCommandsLayoutCreateInfoEXT info = { VK_STRUCTURE_TYPE_INDIRECT_COMMANDS_LAYOUT_CREATE_INFO_EXT };
info.indirectStride = stride;
info.pipelineLayout = pipeline_layout ? pipeline_layout->get_layout() : VK_NULL_HANDLE;
info.flags = VK_INDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_EXT |
VK_INDIRECT_COMMANDS_LAYOUT_USAGE_UNORDERED_SEQUENCES_BIT_EXT;
Util::SmallVector<VkIndirectCommandsLayoutTokenEXT, 8> ext_tokens;
Util::SmallVector<VkIndirectCommandsVertexBufferTokenEXT, 8> vbo_tokens;
Util::SmallVector<VkIndirectCommandsPushConstantTokenEXT, 8> push_tokens;
VkIndirectCommandsIndexBufferTokenEXT ibo_token;
VkIndirectCommandsExecutionSetTokenEXT exec_token;
ext_tokens.reserve(num_tokens);
vbo_tokens.reserve(num_tokens);
push_tokens.reserve(num_tokens);
bool heap = device->get_device_features().descriptor_heap_features.descriptorHeap == VK_TRUE;
for (uint32_t i = 0; i < num_tokens; i++)
{
VkIndirectCommandsLayoutTokenEXT token = { VK_STRUCTURE_TYPE_INDIRECT_COMMANDS_LAYOUT_TOKEN_EXT };
switch (tokens[i].type)
{
case IndirectLayoutToken::Type::VBO:
token.type = VK_INDIRECT_COMMANDS_TOKEN_TYPE_VERTEX_BUFFER_EXT;
vbo_tokens.emplace_back();
token.data.pVertexBuffer = &vbo_tokens.back();
vbo_tokens.back().vertexBindingUnit = tokens[i].data.vbo.binding;
break;
case IndirectLayoutToken::Type::IBO:
token.type = VK_INDIRECT_COMMANDS_TOKEN_TYPE_INDEX_BUFFER_EXT;
token.data.pIndexBuffer = &ibo_token;
ibo_token.mode = VK_INDIRECT_COMMANDS_INPUT_MODE_VULKAN_INDEX_BUFFER_EXT;
break;
case IndirectLayoutToken::Type::PushConstant:
case IndirectLayoutToken::Type::SequenceCount:
{
auto push_token_type = heap ?
VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_DATA_EXT :
VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_EXT;
auto sequence_token_type = heap ?
VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_DATA_SEQUENCE_INDEX_EXT :
VK_INDIRECT_COMMANDS_TOKEN_TYPE_SEQUENCE_INDEX_EXT;
token.type = tokens[i].type == IndirectLayoutToken::Type::PushConstant ?
push_token_type : sequence_token_type;
push_tokens.emplace_back();
token.data.pPushConstant = &push_tokens.back();
VK_ASSERT(pipeline_layout->get_layout());
push_tokens.back().updateRange.size = tokens[i].data.push.range;
push_tokens.back().updateRange.offset = tokens[i].data.push.offset;
push_tokens.back().updateRange.stageFlags =
heap ? VkShaderStageFlags(VK_SHADER_STAGE_ALL) :
pipeline_layout->get_resource_layout().push_constant_range.stageFlags;
break;
}
case IndirectLayoutToken::Type::Draw:
info.shaderStages = VK_SHADER_STAGE_VERTEX_BIT | VK_SHADER_STAGE_FRAGMENT_BIT;
token.type = VK_INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_EXT;
break;
case IndirectLayoutToken::Type::DrawIndexed:
token.type = VK_INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_INDEXED_EXT;
info.shaderStages = VK_SHADER_STAGE_VERTEX_BIT | VK_SHADER_STAGE_FRAGMENT_BIT;
break;
case IndirectLayoutToken::Type::Shader:
token.type = VK_INDIRECT_COMMANDS_TOKEN_TYPE_EXECUTION_SET_EXT;
token.data.pExecutionSet = &exec_token;
break;
case IndirectLayoutToken::Type::MeshTasks:
token.type = VK_INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_MESH_TASKS_EXT;
info.shaderStages |= VK_SHADER_STAGE_MESH_BIT_EXT | VK_SHADER_STAGE_TASK_BIT_EXT |
VK_SHADER_STAGE_FRAGMENT_BIT;
break;
case IndirectLayoutToken::Type::Dispatch:
token.type = VK_INDIRECT_COMMANDS_TOKEN_TYPE_DISPATCH_EXT;
info.shaderStages |= VK_SHADER_STAGE_COMPUTE_BIT;
break;
default:
LOGE("Invalid token type.\n");
break;
}
token.offset = tokens[i].offset;
ext_tokens.push_back(token);
}
info.pTokens = ext_tokens.data();
info.tokenCount = num_tokens;
exec_token.type = VK_INDIRECT_EXECUTION_SET_INFO_TYPE_PIPELINES_EXT;
exec_token.shaderStages = info.shaderStages;
stages = info.shaderStages;
auto &table = device->get_device_table();
if (table.vkCreateIndirectCommandsLayoutEXT(device->get_device(), &info, nullptr, &layout) != VK_SUCCESS)
{
LOGE("Failed to create indirect layout.\n");
}
}
IndirectLayout::~IndirectLayout()
{
device->get_device_table().vkDestroyIndirectCommandsLayoutEXT(device->get_device(), layout, nullptr);
}
}