# 美元编辑器 ## 描述和目标此技能指导对 USD ASCII (.usda) 文件进行安全、最少的编辑以及 USD 命令行工具的正确使用。它的重点是保留阶段结构，使用正确的说明符和属性类型，并在进行有针对性的更改时避免构图错误。 ### 目标 * 在不破坏现有美元构成的情况下进行精确编辑 * 保留文件格式和创作风格 * 使用正确的 prim 说明符、属性类型和关系 * 避免常见的美元陷阱（错误的路径、缺少 xformOpOrder、断开的连接） * 使用命令行工具指导美元资产的安全操作和检查 ## 这个技能应该做什么当要求修改 .usda 文件时，此技能应该： 1. **检查阶段结构** \- 识别根prims、范围和相关路径。 2. **选择正确的说明符** \- 使用 `over` 编辑现有 prims，使用 `def` 编辑新 prims。 3. **仅编辑必要的内容** \- 保留不相关的内容和格式。 4. **尊重构图** \- 除非要求，否则避免更改子图层、引用或变体。 5. **验证连接和路径** \- 确保 `SdfPath` 目标有效且类型兼容。如果更改与 RealityKit 的材质或着色器相关，则更喜欢使用“shadergraph-editor”技能来获取特定于节点的指导。 ### 快速启动工作流程 1. 找到需要编辑的 prim 路径（按 prim 名称或 `SdfPath` 搜索）。 2. 确定是否应该“over”现有的 prim 或“def”一个新的。 3. 应用尽可能小的更改（属性值、关系目标或子 prim）。 4. 如果添加转换，请更新 `xformOpOrder` 以匹配您的新操作。 5. 重新检查您触及的任何路径或连接。 ## 有关技能的信息 ### 核心概念 #### 阶段和层 USD 阶段由一层或多层组成。 .usda 文件是单个 ASCII 层，可以子层或引用其他层。 #### Prim 和说明符 prim 是场景图节点。说明符控制行为：“def”创建，“over”修改，“class”定义可重用模板。 #### 属性属性存储类型化数据；关系 (`rel`) 指向其他素数。 #### 构图弧将其他美元数据带入舞台的子层、引用和有效负载等机制。 #### SdfPath prim 或属性的路径，写法类似于 `` 或 ``。 #### 列表编辑 USD 列表操作（`prepend`、`append`、`delete`、`add`）修改列表而不替换它们。 #### 变体变体集为原语提供替代内容分支。 #### 时间样本存储在“timeSamples”字典中的动画或随时间变化的数据。 ### 参考表参考|何时使用 ---|--- [`usd-syntax`]() |当您需要复习 .usda 语法、值和路径格式时。 [`prims-properties`]() |添加或编辑prims、属性或关系时。 [`composition-variants`]() |当接触子层、引用、有效负载或变体集时。 [`transforms-units`]() |编辑变换、xformOps 或舞台单位/上轴元数据时。 [`时间样本`]() |修改动画/时间采样属性时。 [`命令行工具`]() |当您需要常见 USD 命令行工具的快速参考时。 [`usdcat`]() |转换、拼合或检查 USD 文件时。 [`usdchecker`]() |验证 USD 或 USDZ 资产时，包括以 RealityKit 为重点的检查。 [`usdrecord`]() |从 USD 文件渲染图像时。 [`usdtree`]() |检查 USD 文件的 prim 层次结构时。 [`usdzip`]() |创建或检查 USDZ 包时。 [`usdcrush`]() |压缩 USD 或 USDZ 资产大小时。 [`usdextract`]() |从美元兼容包中提取文件时。 ### 实现模式 #### 覆盖现有的 Prim 超过“网格” { 令牌可见性=“不可见” } #### 使用 Translate 添加一个简单的 Xform def Xform“枢轴” { double3 xformOp:翻译 = (0.0, 0.1, 0.0) 统一标记[] xformOpOrder = ["xformOp:translate"] } #### 绑定实质性关系 rel 材料：绑定 = ### 陷阱和检查 * 当您只需要“over”时，不要用“def”替换“prim”。 * 保持 `xformOpOrder` 与您添加或删除的操作保持一致。 * 验证 `SdfPath` 目标是否存在并匹配预期的属性类型。 * 除非明确要求，否则避免编辑合成弧。 * 保留现有的格式和注释以尽量减少差异噪音。

美元编辑器

包含技能