Files
punktfunk/crates/pyrowave-sys/vendor/pyrowave/Granite/math/render_parameters.hpp
T
enricobuehler 4c3b11445c 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

197 lines
5.0 KiB
C++

/* 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 "math.hpp"
#include "image.hpp"
#include "lights/light_info.hpp"
#include "limits.hpp"
namespace Granite
{
class LightClusterer;
class VolumetricFog;
class VolumetricDiffuseLightManager;
enum { NumShadowCascades = 4 };
struct RenderParameters
{
mat4 projection;
mat4 view;
mat4 view_projection;
mat4 inv_projection;
mat4 inv_view;
mat4 inv_view_projection;
mat4 local_view_projection;
mat4 inv_local_view_projection;
mat4 unjittered_view_projection;
mat4 unjittered_inv_view_projection;
mat4 unjittered_prev_view_projection;
alignas(16) vec3 camera_position;
alignas(16) vec3 camera_front;
alignas(16) vec3 camera_right;
alignas(16) vec3 camera_up;
float z_near;
float z_far;
};
struct ResolutionParameters
{
alignas(8) vec2 resolution;
alignas(8) vec2 inv_resolution;
};
struct VolumetricFogParameters
{
float slice_z_log2_scale;
};
struct FogParameters
{
alignas(16) vec3 color;
float falloff;
};
struct DirectionalParameters
{
alignas(16) vec3 color;
alignas(16) vec3 direction;
};
struct ShadowParameters
{
alignas(16) mat4 transforms[NumShadowCascades];
float cascade_log_bias;
};
struct ClustererParametersBindless
{
alignas(16) mat4 transform;
alignas(16) vec4 clip_scale;
alignas(16) vec3 camera_base;
alignas(16) vec3 camera_front;
alignas(8) vec2 xy_scale;
alignas(8) ivec2 resolution_xy;
alignas(8) vec2 inv_resolution_xy;
uint32_t num_lights;
uint32_t num_lights_32;
uint32_t num_decals;
uint32_t num_decals_32;
uint32_t decals_texture_offset;
uint32_t z_max_index;
float z_scale;
};
struct DiffuseVolumeParameters
{
mat_affine world_to_texture;
vec4 world_lo;
vec4 world_hi;
float lo_tex_coord_x;
float hi_tex_coord_x;
float guard_band_factor;
float guard_band_sharpen;
};
#define CLUSTERER_MAX_VOLUMES 128
struct ClustererParametersVolumetric
{
alignas(16) muglm::vec3 sun_direction;
uint32_t bindless_index_offset;
alignas(16) muglm::vec3 sun_color;
uint32_t num_volumes;
alignas(16) DiffuseVolumeParameters volumes[CLUSTERER_MAX_VOLUMES];
};
struct FogRegionParameters
{
mat_affine world_to_texture;
vec4 world_lo;
vec4 world_hi;
};
#define CLUSTERER_MAX_FOG_REGIONS 128
struct ClustererParametersFogRegions
{
uint32_t bindless_index_offset;
uint32_t num_regions;
alignas(16) FogRegionParameters regions[CLUSTERER_MAX_FOG_REGIONS];
};
#define CLUSTERER_MAX_LIGHTS_BINDLESS 4096
#define CLUSTERER_MAX_DECALS_BINDLESS 4096
#define CLUSTERER_MAX_LIGHTS_GLOBAL 32
struct BindlessDecalTransform
{
mat_affine world_to_texture;
};
struct ClustererBindlessTransforms
{
PositionalFragmentInfo lights[CLUSTERER_MAX_LIGHTS_BINDLESS];
mat4 shadow[CLUSTERER_MAX_LIGHTS_BINDLESS];
mat_affine model[CLUSTERER_MAX_LIGHTS_BINDLESS];
uint32_t type_mask[CLUSTERER_MAX_LIGHTS_BINDLESS / 32];
BindlessDecalTransform decals[CLUSTERER_MAX_DECALS_BINDLESS];
};
struct ClustererGlobalTransforms
{
alignas(16) PositionalFragmentInfo lights[CLUSTERER_MAX_LIGHTS_GLOBAL];
alignas(16) mat4 shadow[CLUSTERER_MAX_LIGHTS_GLOBAL];
alignas(16) uint32_t type_mask[CLUSTERER_MAX_LIGHTS_GLOBAL / 32];
uint32_t descriptor_offset;
uint32_t num_lights;
};
static_assert(sizeof(ClustererGlobalTransforms) <= Vulkan::VULKAN_MAX_UBO_SIZE, "Global transforms is too large.");
struct CombinedRenderParameters
{
alignas(16) FogParameters fog;
alignas(16) ShadowParameters shadow;
alignas(16) VolumetricFogParameters volumetric_fog;
alignas(16) DirectionalParameters directional;
alignas(16) ResolutionParameters resolution;
};
static_assert(sizeof(CombinedRenderParameters) <= Vulkan::VULKAN_MAX_UBO_SIZE, "CombinedRenderParameters cannot fit in min-spec.");
struct LightingParameters
{
FogParameters fog = {};
DirectionalParameters directional;
ShadowParameters shadow;
Vulkan::ImageView *shadows = nullptr;
Vulkan::ImageView *ambient_occlusion = nullptr;
const LightClusterer *cluster = nullptr;
const VolumetricFog *volumetric_fog = nullptr;
const VolumetricDiffuseLightManager *volumetric_diffuse = nullptr;
};
}