path-kit

基于 Skia PathOps 和 PathKit 的 Rust 路径运算库，提供 safe 的 API 封装。
A Rust path operations library based on Skia PathOps and PathKit with safe API wrappers.

功能 / Features

路径构建 / Path construction
Path、PathBuilder（SkPathBuilder，snapshot / detach）；线段、二次/三次贝塞尔、矩形、椭圆、圆、圆角矩形、RRect（四角独立半径）。
Path and PathBuilder (SkPathBuilder, snapshot / detach); lines, quadratic/cubic Béziers, rectangles, ovals, circles, rounded rects, RRects with per-corner radii.
路径布尔运算 / Path boolean ops
并集、交集、差集、异或；OpBuilder 批量运算（底层 SkOpBuilder）。
Union, intersect, difference, xor; batch ops via OpBuilder (backed by SkOpBuilder).
路径简化、包围盒 / Simplify & bounds
simplify，path.tight_bounds，pathops_tight_bounds。
Path simplification, tight bounds, and pathops tight-bounds helpers.
路径变换 / Transforms
Matrix（与 SkMatrix 公开 API 对齐）、path.transform / path.transformed。
Matrix aligns with public SkMatrix APIs; in-place and copying path transforms.
路径填充 / Fill rules
PathFillType（winding / even-odd / inverse 等）。
Winding, even-odd, inverse variants, and related fill types.
路径测量 / Path measure
PathMeasure（长度、pos_tan、get_segment 等）。
Length, position/tangent, segment extraction, contour navigation.
路径迭代 / Iteration
按动词遍历 Move / Line / Quad / Cubic / Close。
Iterate verbs and associated points (move, line, quad, cubic, close).
描边 / Stroke
StrokeRec、StrokeCap / StrokeJoin；将路径转为描边轮廓。
Stroke parameters and caps/joins; convert paths to stroked outlines.
绘图参数 / Paint
Paint、PaintStyle（get_fill_path 等，与 SkPaint 对齐的封装）。
Paint style and stroke parameters; fill-path extraction aligned with SkPaint.
路径效果 / Path effects
DashPathEffect、CornerPathEffect（SkPathEffect::filterPath 封装，虚线 / 圆角等）。
Dash and corner path effects via SkPathEffect::filterPath wrappers.

文档 / Documentation

docs.rs/path-kit
托管的 API 参考：搜索符号、跳转至定义、查看各模块的 rustdoc（不少模块含中英说明）。
Hosted API reference: search symbols, jump to definitions, and read module-level rustdoc (many modules are documented in Chinese and English).
CHANGELOG.md
按版本记录新增、变更与依赖说明；升级前建议阅读。
Versioned list of notable changes and dependency notes; read before upgrading.
源码 rustdoc
克隆仓库后运行 cargo doc --open 可在本地浏览（含 pub(crate) 以外的公开项）。
After cloning, run cargo doc --open to browse docs locally for all public items.

线程安全 / Thread safety

当前未保证 Send / Sync，请勿跨线程共享 Path、Matrix、RRect、StrokeRec、Paint 等封装了 C++ 侧对象的类型。
Send / Sync are not guaranteed; do not share handles that wrap C++ objects (Path, Matrix, etc.) across threads.

安装 / Installation

[dependencies]
path-kit = "0.4"

示例 / Examples

路径布尔运算

use path_kit::{Path, Rect, Direction, RectCorner, PathOp, path_op, OpBuilder};

let mut path1 = Path::new();
path1.add_rect(&Rect::new(0.0, 0.0, 100.0, 100.0), Direction::Cw, RectCorner::UpperLeft);

let mut path2 = Path::new();
path2.add_rect(&Rect::new(50.0, 50.0, 150.0, 150.0), Direction::Cw, RectCorner::UpperLeft);

let union = path_op(&path1, &path2, PathOp::Union).unwrap();

// 批量运算（复用路径时可用 add_ref 避免 clone）
let result = OpBuilder::new()
    .add_ref(&path1, PathOp::Union)
    .add_ref(&path2, PathOp::Union)
    .resolve()
    .unwrap();

矩阵与路径变换 / Matrix and path transform

use path_kit::{Matrix, Path};

let mut path = Path::new();
path.move_to(0.0, 0.0).line_to(100.0, 0.0).line_to(100.0, 100.0).close();

let mut m = Matrix::identity();
m.pre_translate(10.0, 5.0).pre_scale(2.0, 2.0);
path.transform(&m);

// 或保留原路径：let out = path.transformed(&m);

圆角矩形 RRect

use path_kit::{Path, Rect, RRect, Radii, Direction};

// 统一圆角
let rr = RRect::from_rect_xy(&Rect::new(0.0, 0.0, 100.0, 50.0), 10.0, 10.0);
let mut path = Path::new();
path.add_rrect(&rr, Direction::Cw);

// 四角独立半径
let radii = [
    Radii { x: 10.0, y: 10.0 },
    Radii { x: 20.0, y: 10.0 },
    Radii { x: 10.0, y: 20.0 },
    Radii { x: 5.0, y: 5.0 },
];
let rr2 = RRect::from_rect_radii(&Rect::new(0.0, 0.0, 80.0, 60.0), &radii);
path.add_rrect(&rr2, Direction::Ccw);

路径迭代

use path_kit::{Path, PathVerbItem};

let mut path = Path::new();
path.move_to(0.0, 0.0).line_to(100.0, 0.0).line_to(100.0, 100.0).close();

for item in path.iter(false) {
    match item {
        PathVerbItem::Move(p) => println!("Move to {:?}", p),
        PathVerbItem::Line(from, to) => println!("Line {:?} -> {:?}", from, to),
        PathVerbItem::Close => println!("Close"),
        _ => {}
    }
}

描边

use path_kit::{Path, StrokeRec};

let rec = StrokeRec::new_stroke(4.0, false);
let mut path = Path::new();
path.move_to(0.0, 0.0).line_to(100.0, 0.0);
let stroked = rec.apply_to_path(&path).unwrap();

致谢 / Acknowledgments

感谢以下开源项目：

Skia — 2D 图形库，本库的 PathOps 能力源自 Skia
libpag/pathkit — 从 Skia 提取的 PathOps 库，提供轻量级 PathOps API

Thanks to:

Skia — 2D graphics library, PathOps capabilities originate from Skia
libpag/pathkit — PathOps library extracted from Skia, providing a lightweight PathOps API

License

BSD-3-Clause （与 Skia 一致 / Same as Skia）

path-kit 0.4.0