Module wgpu_filter 

GPU-accelerated frame filtering backed by wgpu (Vulkan/Metal/DX12/GL). Successor to the deprecated opengl module.

Compared to the OpenGL filter, this module:

• runs headless (no X11/Wayland/display connection required),
• converts YUV<->RGB on the GPU with the correct color matrix (BT.601/BT.709, limited/full range) instead of sws_scale on the CPU,
• supports output resizing, live parameter updates, and per-stage timing statistics,
• overlaps GPU work with CPU work by default (up to two frames in flight; see WgpuFrameFilterBuilder::frames_in_flight) while always preserving output order,
• is Send without unsafe: all wgpu handles are thread-safe.

Example

use ez_ffmpeg::wgpu_filter::WgpuFrameFilter;
use ez_ffmpeg::filter::frame_pipeline_builder::FramePipelineBuilder;
use ez_ffmpeg::AVMediaType;

let shader = r#"
    @group(0) @binding(0) var texture1: texture_2d<f32>;
    @group(0) @binding(1) var sampler1: sampler;
    struct EzUniforms { play_time: f32, width: f32, height: f32, _pad: f32 };
    @group(0) @binding(2) var<uniform> ez: EzUniforms;

    @fragment
    fn fs_main(@location(0) tex_coord: vec2<f32>) -> @location(0) vec4<f32> {
        let color = textureSample(texture1, sampler1, tex_coord);
        let gray = dot(color.rgb, vec3<f32>(0.299, 0.587, 0.114));
        return vec4<f32>(vec3<f32>(gray), 1.0);
    }
"#;

let filter = WgpuFrameFilter::new_simple(shader)?;
let pipeline: FramePipelineBuilder = AVMediaType::AVMEDIA_TYPE_VIDEO.into();
let pipeline = pipeline.filter("wgpu", Box::new(filter));
// output.add_frame_pipeline(pipeline);

Feature flag: only available with the wgpu feature.

Input formats: YUV420P, YUV422P, YUV444P (plus their full-range J variants) and NV12 CPU frames. Hardware frames (e.g. set_hwaccel_output_format("vaapi")) are downloaded to system memory automatically, or imported zero-copy over DRM PRIME dmabufs when WgpuFrameFilterBuilder::hw_zero_copy_input is enabled (Linux/Vulkan, experimental). Other formats need a format=yuv420p conversion in filter_desc first. Output is always YUV420P (4:2:2/4:4:4 inputs are chroma-downsampled on the GPU).

Re-exports

pub use wgpu_frame_filter::WgpuFrameFilter;

pub use wgpu_frame_filter::WgpuFrameFilterBuilder;

Modules

wgpu_frame_filter

WgpuFrameFilter: the public GPU frame filter, its builder, and the in-flight output queue that overlaps GPU work with CPU work.

Structs

WgpuFilterStats

Cumulative per-stage timings, readable while the filter runs via crate::wgpu_filter::WgpuFrameFilter::stats_handle.

WgpuParamsHandle

Live handle for updating shader parameters from any thread while the filter runs inside a pipeline. Created via crate::wgpu_filter::WgpuFrameFilter::params_handle.