1 个不稳定版本
0.1.0 | 2019年6月1日 |
---|
1070 在 图形API 中
3,550 个星标 & 87 个关注者
35KB
759 行
Pathfinder 3
Pathfinder 3 是一个使用 OpenGL 3.0+、OpenGL ES 3.0+、WebGL 2 和 Metal 的快速、实用、基于GPU的字体和矢量图形光栅化器。
请注意,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
,这可能对打包者很有用。
社区
在 #pathfinder:mozilla.org
有一个 Matrix 聊天室。如果您在 Mozilla Matrix 服务器上,可以搜索 Pathfinder 来找到它。有关连接到 Matrix 网络的更多信息,请参阅 这个 wiki.mozilla.org
页面。
Pathfinder 社区的全体成员,包括聊天室和 GitHub 项目,都应遵守 Rust 项目本身遵循的相同行为准则。(目前,作者将处理违规行为。)
构建状态
作者
主要作者是 Patrick Walton (@pcwalton),Servo 开发社区也有贡献。
标志由 Jay Vining 设计。
许可证
Pathfinder 的许可证与 Rust 本身相同。请参阅 LICENSE-APACHE
和 LICENSE-MIT
。
Material Design 图标归 Google Inc. 所有,并受 Apache 2.0 许可证的许可。
lib.rs
:
Pathfinder 的 C 绑定。
依赖关系
~3–13MB
~159K SLoC