界面元素

Noetic Garden 的作品 — 作者 millenomi。

此软件包旨在包含 SwiftUI 和 RealityKit 容器，用于 2D 和 3D UI 的工作 — 例如 3D 感知容器、调试可视化工具或这些元素的 RealityKit 集成。

目前，它包含两个模块。“UIElements”模块提供 SwiftUI 容器 — Concentric 容器，它将其边界内的所有视图放置在中心，包括深度；以及 Envelopment 容器 — 一个 SwiftUI 容器，允许您将其边界两侧放置视图。它在 visionOS 中以 3D 模式工作，在所有其他 Apple 操作系统中以 2D 模式工作。它还为处理矢量值提供了便利。“Marks”模块提供 MarksView — 一种在空间中标记几何元素的方法，作为调试可视化 UI 的构建块。

这是 Envelopment 容器的实际应用

A screenshot of an envelopment on visionOS.

A screenshot of an envelopment on macOS.

您可以通过在本地检出软件包，然后在 Examples 目录中运行示例代码来试用该软件包。

添加到您的项目

要将此软件包添加到您的项目，请在 Xcode 中使用以下 URL，方法是选择“File”>“Add Package Dependencies…”

https://github.com/noeticgarden/uielements.git

或者，按如下方式将其作为依赖项添加到您的软件包

…
// Package.swift
let package = Package(
…
    dependencies: [
        …
        .package(url: "https://github.com/noeticgarden/uielements.git", from: "0.1.0"),
    ],
    …
    targets: [
        .target(…
            dependencies: [
                .product("UIElements", package: "uielements")
            ])
    ]
)

许可

此模块的内容根据 MIT 许可证获得许可。有关详细信息，请参阅 LICENSE 文件。

贡献

使用 GitHub 来 报告问题 或 提出拉取请求。

此软件包不保证任何特定贡献将被包含或可见地审查，但所有问题和拉取请求都至少会被考虑。另外，请友善待人；这些空间将由作者自行决定积极管理。

1.0 验收标准

当任何 Noetic Garden 产品发布并使用其类型时，此软件包将被标记为源稳定。在此之前，预计该软件包将保持源不稳定，使用 0.x 语义版本 方案。我们将谨慎行事，避免破坏客户端，但更改可能需要重写现有代码或锁定到特定的 0.x 版本，直到那时。