Rust SVG滤镜处理库svgfilters的使用：高效实现SVG图形效果与滤镜操作

svgfilters简介

svgfilters 是一个提供底层SVG滤镜实现的Rust库。

该库并未实现完整的滤镜工作流程，仅实现了对栅格图像的操作。调用者需要自行实现滤镜区域计算、图像颜色(反)预乘、输入验证、滤镜原语顺序、变换等功能。

已实现的滤镜

• feColorMatrix
• feComponentTransfer
• feComposite (仅支持算术运算符)
• feConvolveMatrix
• feDiffuseLighting
• feDisplacementMap
• feGaussianBlur (提供Box blur和IIR blur两种实现)
• feMorphology
• feSpecularLighting
• feTurbulence

未实现的滤镜

• feFlood (简单填充)
• feImage (只能由调用者实现)
• feTile (基本的图案填充)
• feMerge (图层合成，2D库实现更高效)
• feOffset (带偏移的图层合成)

性能

该库尚未完全优化，但大部分操作是无内存分配的。某些方法会分配必要的临时缓冲区，这会在文档中注明。但大多数方法会直接在提供的缓冲区上工作。

许可证

svgfilters采用MPLv2.0许可证。

安装

在项目目录中运行以下Cargo命令：

cargo add svgfilters

或者在Cargo.toml中添加：

svgfilters = "0.4.0"

完整示例代码

以下是一个使用svgfilters进行高斯模糊处理的完整示例：

use svgfilters::{Filter, GaussianBlur, StdFilterError};
use image::{DynamicImage, ImageBuffer, Rgba};

fn main() -> Result<(), StdFilterError> {
    // 1. 加载图像
    let img = image::open("input.png").unwrap();
    let (width, height) = img.dimensions();
    
    // 2. 转换为RGBA格式
    let img_rgba = img.to_rgba8();
    let mut input = img_rgba.into_raw();
    
    // 3. 创建高斯模糊滤镜
    let mut filter = GaussianBlur::new();
    filter.set_std_dev_x(5.0);  // 设置X方向标准差
    filter.set_std_dev_y(5.0);  // 设置Y方向标准差
    
    // 4. 应用滤镜
    let mut output = vec![0; input.len()];
    filter.apply(
        width as usize,
        height as usize,
        &mut input,
        &mut output,
    )?;
    
    // 5. 保存结果
    let output_img = ImageBuffer::<Rgba<u8>, _>::from_raw(width, height, output).unwrap();
    output_img.save("output_blurred.png").unwrap();
    
    Ok(())
}

另一个使用feColorMatrix改变图像色调的示例：

use svgfilters::{Filter, ColorMatrix, StdFilterError};
use image::{DynamicImage, ImageBuffer, Rgba};

fn main() -> Result<(), StdFilterError> {
    // 1. 加载图像
    let img = image::open("input.png").unwrap();
    let (width, height) = img.dimensions();
    
    // 2. 转换为RGBA格式
    let img_rgba = img.to_rgba8();
    let mut input = img_rgba.into_raw();
    
    // 3. 创建颜色矩阵滤镜
    let mut filter = ColorMatrix::new();
    
    // 设置sepia色调矩阵
    filter.set_matrix(&[
        0.393, 0.769, 0.189, 0.0, 0.0,
        0.349, 0.686, 0.168, 0.0, 0.0,
        0.272, 0.534, 0.131, 0.0, 0.0,
        0.0,   0.0,   0.0,   1.0, 0.0,
    ]);
    
    // 4. 应用滤镜
    let mut output = vec![0; input.len()];
    filter.apply(
        width as usize,
        height as usize,
        &mut input,
        &mut output,
    )?;
    
    // 5. 保存结果
    let output_img = ImageBuffer::<Rgba<u8>, _>::from_raw(width, height, output).unwrap();
    output_img.save("output_sepia.png").unwrap();
    
    Ok(())
}

这些示例展示了如何使用svgfilters库来处理图像并应用不同的SVG滤镜效果。您可以根据需要调整参数以获得不同的视觉效果。