简介
ShapeScript 是一种混合脚本/标记语言,用于创建和操作 3D 几何形状,通过诸如拉伸或“车削”2D 路径以创建实心 3D 形状等技术,以及使用 CSG(构造实体几何)将这些形状组合或从中减去。
ShapeScript 也是 ShapeScript Mac 和 iOS 应用中使用的脚本语言。
ShapeScript 是在 Euclid 上实现的,这是一个用于 Swift 的跨平台 3D 建模库。您可以使用 ShapeScript 构造的任何内容都可以使用 Euclid 编程性地在 Swift 中复制。
如果您想支持 Euclid 和 ShapeScript 语言的开发,请考虑购买 ShapeScript for Mac 或 iOS 的副本(应用程序本身是免费的,但要进行内购以解锁一些功能)。
安装
ShapeScript 打包为一个 Swift 框架,该框架本身依赖于 Euclid 框架,其副本包含在这个存储库中。
要使用 CocoaPods 安装 ShapeScript 框架,请将以下内容添加到您的 Podfile 中
pod 'ShapeScript', '~> 1.6'
要使用 Carthage 安装,将以下内容添加到您的 Cartfile 中
github "nicklockwood/ShapeScript" ~> 1.6
要使用 Swift 包管理器安装,请在您的 Package.swift 文件中 dependencies:
部分
.package(url: "https://github.com/nicklockwood/ShapeScript.git", .upToNextMinor(from: "1.6.0")),
该仓库还包含 iOS 和 macOS 的 ShapeScript 查看器应用程序,这是在 Mac 和 iOS 应用商店提供的完整 ShapeScript 应用程序的一个简化版本。目前无法使用 CocoaPods、Carthage 或 Swift 包管理器安装或运行这些应用程序,但您可以通过打开包含的 Xcode 项目并选择 Viewer (Mac)
或 Viewer (iOS)
方案来运行它们。有关 Linux 的使用说明,请见下文。
注意:ShapeScript 查看器需要 Xcode 11+ 来构建,并且可在 macOS 10.13+ 或 iOS 14+ 上运行。
使用方法(Mac)
尝试 ShapeScript 的最佳方法是在 ShapeScript 查看器应用程序中运行(见上文)。
打开应用程序后,您可以通过文件菜单创建新的 ShapeScript 文档,或从帮助菜单中打开示例项目之一。
ShapeScript 不包含内置的编辑器。在 ShapeScript 查看器中打开形状文件后,您可以从编辑菜单中选择在编辑器中打开(Cmd-E),以便在您选择的文本编辑器中打开源文件。
ShapeScript 查看器将跟踪源文件中的更改,并在您进行编辑时实时更新。
有关更多信息,请参阅 帮助部分。
使用方法(Linux)
ShapeScript 为 Linux 机器提供了一个命令行界面。您可以从 发布页面 下载最新的 CLI 构建版本。
或者,要从源代码构建工具,您需要安装最新的 Swift 工具链,然后运行以下命令
$ git clone https://github.com/nicklockwood/ShapeScript
$ cd ShapeScript
$ swift build -c release
与 GUI 应用程序一样,ShapeScript CLI 不包含编辑器。使用您选择的文本编辑器创建您的 .shape
文件,然后按照以下方式传递给 CLI
shapescript myfile.shape
这将运行文件并报告任何错误。在成功的情况下,它会打印有关模型的一些信息。要导出模型,请添加第二个参数,指定您想导出 STL(立体光刻)文件的路径
shapescript myfile.shape myfile.stl
贡献
如果您在使用库时有疑问,或者认为可能发现了错误,请自由在Github上提出一个问题。
如果您愿意对文档或代码本身做出改进,那太好了!但在提交拉取请求之前,请先阅读CONTRIBUTING.md文件。
致谢
ShapeScript框架和应用程序主要是Nick Lockwood的工作。