GitHub 热门项目:Vortex

2026-06-26 1 阅读 GitHub Trending
GitHub 项目:Vortex 仓库地址:https://github.com/twostraws/Vortex 星级:1557 | 作者:双吸管 项目描述:SwiftUI 的高性能粒子效果。 =================================================== 自述文件内容: 涡旋标志

Twitter: @twostraws

Vortex 是一个强大的、高性能的 SwiftUI 粒子系统库,让您只需几行代码即可创建火、雨、烟、雪等精美效果。 Vortex 附带一系列内置效果,例如烟花、魔法、五彩纸屑等,但您也可以创建适合您需求的完全自定义效果。 该框架与 iOS、macOS、tvOS、watchOS 和 VisionOS 兼容。 ## 安装 Vortex 使用 Swift Package Manager,因此您应该使用 Xcode 添加 的包依赖项。 完成后,在需要的地方将 Vortex 导入到 Swift 代码中: ````迅速 进口涡流 ```` 在此存储库的 **Assets** 目录中,您将找到三个可以使用的示例粒子图像,但您可以使用各种 SwiftUI 视图和形状,而不仅仅是图像。 ## 查看实际效果 该存储库包含一个跨平台示例项目,演示了正在使用的所有预设。示例项目是使用 SwiftUI 构建的,需要 iOS 17、macOS 14 或 VisionOS 1。 ![Vortex Sandbox 应用程序演示了几个内置粒子预设。](sandbox-preview.gif) ## 基本使用 渲染涡旋粒子系统需要两个步骤: 1. 创建一个“VortexSystem”实例,根据您希望的粒子行为方式进行配置。必须给出要渲染的粒子的标签名称列表。 2. 将 `VortexView` 添加到 SwiftUI 视图层次结构中,传入要渲染的粒子系统,以及用于粒子的所有视图,并使用步骤 1 中的相同名称进行标记。 有很多内置的粒子系统设计,比如雨: ````迅速 涡旋视图(.rain) { 圆() .填充(.白色) .frame(宽度: 32) .tag("圆圈") } ```` 烟花: ````迅速 VortexView(.fireworks) { 圆() .填充(.白色) .blendMode(.plusLighter) .frame(宽度: 32) .tag("圆圈") } ```` 还有火: ````迅速 VortexView(.fire) { 圆() .填充(.白色) .blendMode(.plusLighter) .模糊(半径:3) .frame(宽度: 32) .tag("圆圈") } ```` > [!注意] > 每个预设都旨在寻找一个或多个标签;请检查下面的文档以获取要提供的正确标签。 您还可以创建完全自定义的效果,如下所示: ````迅速 结构内容