#pathfinder #geometry

servo/pathfinder_geometry

基本的SIMD加速几何/线性代数

2个不稳定版本

0.5.1 2021年5月23日
0.3.0 2019年6月8日

3,550 星 & 87 关注者

MIT/Apache

175KB
4.5K SLoC

Pathfinder 3

Logo

Pathfinder 3是一个快速、实用的基于GPU的位图化器,用于字体和矢量图形,它使用OpenGL 3.0+、OpenGL ES 3.0+、WebGL 2和Metal。

请注意,Pathfinder正处于快速发展阶段,并在多个方面尚不完整。

快速入门

Pathfinder包含一个实现了HTML canvas API子集的库。您可以使用它快速将矢量渲染添加到任何Rust或C/C++应用程序中。该库可在crates.io上找到。有关使用示例,请参阅examples/canvas_minimal

演示

演示应用程序的源代码可在demo/native中找到。只需运行

$ cd demo/native
$ cargo run --release

还有各种小型示例可供快速入门。例如,您可以像这样运行canvas_nanovg示例

$ cd examples/canvas_nanovg
$ cargo run --release

特性

该项目具有以下特性

  • Rust和C绑定,便于嵌入到您自己的应用程序中,无论编程语言如何。 (注意:C绑定目前尚不完整;欢迎提交拉取请求!)

  • 在可用的情况下基于GPU计算的渲染。Pathfinder有两种渲染模式:基于计算的D3D11和基于硬件光栅化的D3D9。 (注意:这些名称仅是引用硬件级别的便捷方式:该项目还没有适当的Direct3D后端。) 在D3D11模式下,Pathfinder使用计算着色器以实现CPU使用的大幅减少和整体性能优于内置GPU光栅化硬件。

  • 如有需要,快速设置CPU,充分利用并行性。如果使用D3D9后端,Pathfinder将使用SIMD和Rayon进行分块步骤,以尽可能从CPU中提取并行性。(在D3D11后端,这些步骤在GPU上执行。)CPU步骤可以与GPU流水线化,以隐藏其延迟。

  • 快速GPU渲染,即使在小像素尺寸下。即使在低端GPU上,Pathfinder通常也能达到或超过最佳CPU光栅化器的性能。在大尺寸下,这种差异尤为明显,Pathfinder通常会实现多倍速度提升。

  • 高质量抗锯齿。Pathfinder可以计算每个像素的精确分数梯形面积覆盖率,以实现可能的最大质量抗锯齿(实质上为256xAA)。

  • 高级字体渲染。Pathfinder可以带有轻微提示的字体渲染,并在LCD屏幕上执行子像素抗锯齿。它可以像macOS和FreeType那样执行茎干变暗/字体缩放,以使小尺寸文本更容易阅读。此外,库还支持伽马校正。

  • 支持SVG。Pathfinder 3被设计为高效处理由许多重叠矢量路径组成的工作负载,如常见于复杂SVG和PDF文件中的路径。它执行基于分块的遮挡剔除,通常能显著提高典型使用画家算法的软件渲染器的性能。包含一个简单的加载器,利用resvg库渲染SVG子集,因此很容易开始使用。

  • 3D功能。Pathfinder可以在不损失质量的情况下渲染3D环境中的字体和矢量路径。这旨在为基于矢量图形的用户界面在VR中提供便利。

  • 轻量级。Pathfinder首先考虑的是简单性和通用性,而不是大量的专用快速路径。它由一组模块化crate组成,因此应用程序可以选择仅必要的组件以最小化依赖。

  • 支持过去十年中制造的几乎所有GPU,包括集成和移动GPU。任何能够运行Direct3D 9/OpenGL 3.0/WebGL 2.0的GPU都应该能够运行Pathfinder。目前,后端支持OpenGL、OpenGL ES、Metal和WebGL。

构建

Pathfinder可以用Rust或C/C++使用。请参阅下面的适当部分。

Rust

只需在顶层运行cargo build --release来构建所有crate。Pathfinder是一组模块化crate,允许您选择库中需要的部分,并省略其余部分。库在crates.io上可用,带有pathfinder_前缀(例如pathfinder_canvas),但您可能希望使用main分支以获取最新的功能和错误修复。

C

C绑定使用cargo-c。使用cargo install cargo-c安装cargo-c,然后使用类似以下命令

$ cargo cinstall --destdir=/tmp/pathfinder-destdir --manifest-path c/Cargo.toml
$ sudo cp -a /tmp/pathfinder-destdir/* /

生成的库可以通过pkg-config作为pathfinder使用。有关使用示例,请参阅以c_开头的examples/目录中的示例。

cargo-c有各种其他选项,如--prefix,这可能对打包者很有用。

社区

Matrix聊天室在#pathfinder:mozilla.org可使用。如果您在Mozilla Matrix服务器上,可以搜索Pathfinder找到它。有关连接到Matrix网络更多信息,请参阅此页面wiki.mozilla.org

Pathfinder社区全体,包括聊天室和GitHub项目,预期将遵守与Rust项目相同的《行为准则》。(目前,作者将处理违规行为。)

构建状态

Build Status

作者

主要作者是Patrick Walton (@pcwalton),Servo开发社区也做出了贡献。

标志由Jay Vining设计。

许可协议

Pathfinder的许可协议与Rust本身相同。请参阅LICENSE-APACHELICENSE-MIT

Material Design图标版权属于Google Inc.,并使用Apache 2.0许可证。


lib.rs:

基本的几何和线性代数原语,使用SIMD优化。

依赖项

~89KB