Rust SVG处理库typst-svg的使用，高效解析与渲染矢量图形的轻量级解决方案

Typst是一个基于标记的排版系统，设计目标是拥有LaTeX的强大功能，同时更易于学习和使用。Typst具有以下特点：

• 内置常见格式化任务的标记语法
• 灵活的脚本系统
• 数学公式排版、参考文献管理等
• 增量编译带来的快速编译速度
• 出错时提供友好的错误信息

安装

可以通过以下方式安装Typst：

1. 从GitHub releases页面下载预编译二进制文件
2. 使用包管理器：
   • macOS: brew install typst
   • Windows: winget install --id Typst.Typst
3. 使用Rust工具链：

   cargo install --locked typst-cli
   

使用示例

以下是Typst的一个完整示例代码：

// 设置页面大小和标题编号
#set page(width: 10cm, height: auto)
#set heading(numbering: "1.")

= Fibonacci sequence
The Fibonacci sequence is defined through the
recurrence relation $F_n = F_(n-1) + F_(n-2)$.
It can also be expressed in _closed form:_

$ F_n = round(1 / sqrt(5) phi.alt^n), quad
  phi.alt = (1 + sqrt(5)) / 2 $

// 定义变量和函数
#let count = 8
#let nums = range(1, count + 1)
#let fib(n) = (
  if n <= 2 { 1 }
  else { fib(n - 1) + fib(n - 2) }
)

// 显示结果表格
The first #count numbers of the sequence are:

#align(center, table(
  columns: count,
  ..nums.map(n => $F_#n$),
  ..nums.map(n => str(fib(n))),
))

SVG处理示例

以下是使用typst-svg处理SVG的完整示例代码：

use typst_svg::{render, scale};
use usvg::Options;

// SVG内容
let svg_data = r#"
<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
  <circle cx="50" cy="50" r="40" stroke="green" stroke-width="4" fill="yellow" />
</svg>
"#;

// 解析和渲染SVG
let tree = usvg::Tree::from_str(svg_data, &Options::default()).unwrap();
let pixmap_size = tree.size.to_screen_size();
let mut pixmap = tiny_skia::Pixmap::new(pixmap_size.width(), pixmap_size.height()).unwrap();

// 缩放SVG
let transform = scale(1.0, 1.0);
render(&tree, transform, &mut pixmap.as_mut());

// 输出PNG
pixmap.save_png("output.png").unwrap();

完整示例demo

以下是一个更完整的typst-svg使用示例，包含文件读取和错误处理：

use std::fs;
use std::path::Path;
use typst_svg::{render, scale};
use usvg::{Options, Tree};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 1. 读取SVG文件内容
    let svg_path = Path::new("input.svg");
    let svg_data = fs::read_to_string(svg_path)?;
    
    // 2. 配置解析选项
    let options = Options {
        // 设置资源路径
        resources_dir: Some(svg_path.parent().unwrap().to_path_buf()),
        // 设置默认字体
        font_family: "Arial".to_string(),
        ..Options::default()
    };
    
    // 3. 解析SVG
    let tree = Tree::from_str(&svg_data, &options)?;
    
    // 4. 创建目标画布
    let pixmap_size = tree.size.to_screen_size();
    let mut pixmap = tiny_skia::Pixmap::new(
        pixmap_size.width(),
        pixmap_size.height()
    ).expect("Failed to create pixmap");
    
    // 5. 渲染SVG到画布
    let transform = scale(1.0, 1.0); // 不缩放
    render(&tree, transform, &mut pixmap.as_mut());
    
    // 6. 保存为PNG
    let output_path = "output.png";
    pixmap.save_png(output_path)?;
    
    println!("SVG成功渲染并保存为 {}", output_path);
    Ok(())
}

设计原则

Typst遵循三个核心设计原则：

1. 通过一致性实现简单性：知识可以跨功能转移
2. 通过可组合性实现强大功能：提供可以组合的系统
3. 通过增量性实现性能：所有语言特性都支持增量编译

社区

Typst的主要社区在Discord服务器上，你可以在那里提问、分享作品或参与讨论。

Typst是一个强大的排版系统，结合typst-svg库可以高效处理SVG矢量图形，是轻量级的解决方案。