#utilities #plane #frame #plugin #collection #surrounding #vapoursynth4-rs

vapours

A collection of utilities surrounding vapoursynth4-rs

6 releases

new 0.1.5 Mar 10, 2025
0.1.4 Mar 7, 2025
0.1.2 Jan 28, 2025
0.1.0 Dec 31, 2024

#126 in Video

Download history 246/week @ 2024-12-29 132/week @ 2025-01-05 536/week @ 2025-01-12 227/week @ 2025-01-19 331/week @ 2025-01-26 160/week @ 2025-02-02 145/week @ 2025-02-09 106/week @ 2025-02-16 331/week @ 2025-02-23 442/week @ 2025-03-02 234/week @ 2025-03-09

1,178 downloads per month

MIT license

29KB
563 lines

vapours

vapours is a collection of utilities surrounding vapoursynth4-rs. Generally these aid in VapourSynth plugin development. vapours can also be seen as a Rust equivalent to vs-tools to some extent.

For example, the classic invert filter goes from this:

for plane in 0..fi.num_planes {
    let mut src_p = src.plane(plane);
    let src_stride = src.stride(plane);
    let mut dst_p = dst.plane_mut(plane);
    let dst_stride = dst.stride(plane);

    let h = src.frame_height(plane);
    let w = src.frame_width(plane);

    for _ in 0..h {
        for x in 0..w as usize {
            unsafe { *dst_p.wrapping_add(x) = !*src_p.wrapping_add(x) };
        }

        src_p = src_p.wrapping_offset(src_stride);
        dst_p = dst_p.wrapping_offset(dst_stride);
    }
}

To this:

// Bring in extensions on `VideoFrame` like `as_slice()` and `as_mut_slice()`.
use vapours::frame::VapoursVideoFrame;

// ...

for plane in 0..fi.num_planes {
    let src_slice = src.as_slice::<u8>(plane);
    let dst_slice = dst.as_mut_slice::<u8>(plane);

    for (src_pixel, dst_pixel) in zip(src_slice, dst_slice) {
        *dst_pixel = !*src_pixel;
    }
}

Dependencies

~3.5MB
~66K SLoC