ShapeScript 1.8.5

ShapeScript 1.8.5

Nick Lockwood 维护。



  • 作者:
  • Nick Lockwood

Build Codecov Platforms Swift 5.1 License Mastodon

Screenshot

简介

ShapeScript 是一种混合脚本/标记语言,用于创建和操作 3D 几何形状,通过诸如拉伸或“车削”2D 路径以创建实心 3D 形状等技术,以及使用 CSG(构造实体几何)将这些形状组合或从中减去。

ShapeScript 也是 ShapeScript MaciOS 应用中使用的脚本语言。

ShapeScript 是在 Euclid 上实现的,这是一个用于 Swift 的跨平台 3D 建模库。您可以使用 ShapeScript 构造的任何内容都可以使用 Euclid 编程性地在 Swift 中复制。

如果您想支持 Euclid 和 ShapeScript 语言的开发,请考虑购买 ShapeScript for Mac 或 iOS 的副本(应用程序本身是免费的,但要进行内购以解锁一些功能)。

Mac App Store App Store

安装

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 查看器应用程序,这是在 MaciOS 应用商店提供的完整 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的工作。