fedesanchez0/shader-lab
多媒体与设计在 Apple 各平台上实时调参数预览 Metal 着色器,可叠加文字并把画面导出为壁纸。
项目介绍
Shader Lab 是一个用 SwiftUI 写的 Metal 着色器试验场。它内置 15 个效果:全屏生成类包括热力图、波浪丝带、虹彩球体、青晒法风格的植物分形等,照片类包括扭曲、涟漪、挤压、条纹玻璃、色差和窗上雨滴。每个效果都暴露参数,拖动时画布实时变化。
应用覆盖 iPhone、iPad、可折叠的 iPhone Duo、Apple TV、Apple Vision Pro 和 Apple Watch,每个平台有各自布局。在 iPhone、iPad 和 Duo 上可以叠加文字,打开 Code 标签查看当前着色器函数及其参数值,把源码导出为 .metal 文件,或把画面以完整分辨率导出到相册作为壁纸。仓库还附带一个跑在虚拟机中、依赖 Apple 内部 HomeView SDK 的实验界面。
它适合想交互式体验着色器效果、制作壁纸或阅读并复用 Metal 源码的人。它不是用户自行编写着色器的编辑器:效果目录固定写在代码里,应用内不提供新建着色器的入口。
快速使用
- 安装 Xcode 27.1 或更高版本(iOS 27.1 SDK),或使用 Bitrig。
- 打开
Shader Lab.xcodeproj。Shader Lab scheme 构建 iPhone、iPad、Apple TV 和 Apple Vision Pro 版本;Watch 应用内嵌在 iPhone 应用中,Shader Lab Watch App scheme 单独构建手表版本。 - 在真机上运行需要设置开发团队,并把占位的 Bundle Identifier 改成你自己的。
不需要安装任何包或运行安装脚本。运行后选择效果、调整参数,再点 Export 把当前画布保存到相册;iPhone 上即使在横屏导出,图片也保持竖直,之后可在相册中通过「分享 → 用作墙纸」设为锁屏或主屏幕壁纸。HomeView 版本需要另行按项目的 HomeView 虚拟机说明 操作,流程更长。
测试套件可用例如 bitrig test -destination 'platform=iOS Simulator,name=iPhone 17' 运行,包含单元测试与 UI 测试。
使用约束
- 最低系统版本:iOS/iPadOS 26、tvOS 26、visionOS 26;iPhone Duo 的折叠感知布局需要 iOS 27.1;手表应用需要 watchOS 11。构建需要 iOS 27.1 SDK。
- HomeView 界面无法运行在真实 HomeView 硬件上;Apple 未开放该 SDK,因此该界面以 tvOS 应用形式供虚拟机使用。
- 代码整体采用 MIT 许可证,但 Rain 效果改编自 “Heartfelt”,其部分仍为 CC BY-NC-SA 3.0:禁止商业使用,改编需以相同协议共享。若打算在付费应用中发布 Rain,需要先考虑这一限制。
- 内置的 macOS 壁纸和 Clownfish 图片属于 Apple,仅用于演示;MIT 许可证不覆盖随仓库打包的照片和 Apple 图像,再分发素材前应查看致谢部分。
- 项目不使用第三方库或 Swift Package,只依赖 Apple 框架。
HotRepo 点评
Shader Lab 出现在 HotRepo 2026-11-17 的新项目记录中:在 2026-11-16 19:35 至 2026-11-17 09:46 UTC 约 14 小时的统计窗口内新增 100 Star、8 Fork,暂无 GitHub 全部语言日榜名次记录。这只是单个早期快照,说明的是项目刚出现时受到的关注,不足以判断趋势。技术上比较有特点的是:固定着色器目录配合跨效果保留共享参数值的动态参数面板、所有画布共用的 30 Hz 时钟,以及对柔和渐变采用降分辨率渲染。多平台布局,尤其是 iPhone Duo 的折痕处理和按 544 点方形设计的 TV 布局,值得结合自己目标设备去实际验证。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- GaelQuinta/minecraft-metal-shaders为 Apple Silicon Mac 上的 Minecraft Java 提供原生 Metal 光影,包括阴影、体积云、水面反射与 HDR,可按 Retina 分辨率运行。
- Kianuni/Camlo把 iPhone 锁屏壁纸做成上滑解锁动态变身和裸眼 3D 景深的 iOS 应用。
- ZSeven-W/openpencil把提示词和并行 Agent 直接变成画布上的 UI,并导出为代码的 AI 原生矢量设计工具。
- kgoedecke/doop一个多人设计画布,人类与 AI 代理通过 MCP 实时共同编辑 HTML 画面。
- antfu/furifont一款自带注音的日文字体:文字保持纯文本,也能在汉字上方显示假名读音。