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

vapours

A collection of utilities surrounding vapoursynth4-rs

2 releases

new 0.1.1 Jan 14, 2025
0.1.0 Dec 31, 2024

#106 in Video

Download history 107/week @ 2024-12-26 169/week @ 2025-01-02 515/week @ 2025-01-09

791 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