OpenUSD Primvar 完全指南五种插值模式、命名空间继承与索引化数据实战【免费下载链接】OpenUSDUniversal Scene Description项目地址: https://gitcode.com/GitHub_Trending/ope/OpenUSD本文以 OpenUSD 仓库docs/user_guides/primvars.rst为主线系统讲解 Primvar 的核心机制五种插值模式constant / uniform / varying / vertex / faceVarying的适用场景与元素数量约定、Primvar 沿场景命名空间的继承规则、索引化indexed数据与 attribute block 的陷阱以及 elementSize 的作用。阅读完本文你将能够为 Mesh、BasisCurves 等几何 prim 正确编写primvars:*属性理解 Hydra/Storm 渲染器与 USD 底层UsdGeomPrimvarsAPI如何消费这些数据并在实际资产制作中避开常见的插值错误与数据块block误用。什么是 PrimvarPrimvarprimitive variable图元变量是一种特殊类型的属性attribute它可以把属性值插值interpolate到几何 prim 的表面或体积上。Primvar 最常见的用途是向着色器 / 材质传递逐图元per-primitive的覆盖信息例如为曲面提供纹理坐标UV、逐点颜色、法线等凡是需要随表面或体积变化的信号都可以用 Primvar 承载。在 USD 中Primvar 通过primvars:命名空间前缀与普通属性区分。从源码角度看UsdGeomPrimvarsAPI 提供了CreatePrimvar()系列工厂方法以及CreateIndexedPrimvar()、CreateNonIndexedPrimvar()它们统一处理属性类型SdfValueTypeName、插值模式interpolation与元素大小elementSize三个关键参数而UsdGeomPrimvar见 primvar.h则封装了对单个 primvar 的读取GetInterpolation()、GetElementSize()、GetIndices()、ComputeFlattened()等 API 构成消费端访问 primvar 数据的主要入口。USD 当前支持五种 primvar 插值模式插值模式元素数量约定典型用途constant整个 prim 1 个元素整体着色、父级覆盖色uniform每个面片Mesh 的每个 face / 曲线的每个 segment1 个元素逐面颜色、材质 idvarying每个 point 1 个元素线性插值顶点色类游戏引擎vertex每个 point 1 个元素按基函数插值平滑渐变、细分表面着色faceVarying每个 face-vertex 1 个元素UV 接缝、拓扑不连续下面各节通过一个由两个四边形面组成的 Mesh Gprim 示例配合displayColorprimvar逐一说明每种模式的写法与渲染效果截图来自 usdview经 Hydra/Storm 渲染。Constant Interpolation恒定插值constant模式在整个 prim 表面/体积上只指定一个元素。注意即便如此你仍然需要为 primvar 提供一个数组——只不过数组只含一个元素。下面这个例子中displayColorprimvar 用只含单个颜色的数组表达Hydra/Storm 会把 Mesh 的所有面渲染成同一种颜色#usda 1.0 ( ) def Mesh constant { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(1, 0, 0)] ( interpolation constant ) double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }从源码定义看mesh.h 对 constant 的注释是One element for the entire mesh; no interpolation整个 Mesh 一个元素不插值。constant也是唯一一种可以沿场景命名空间向下继承给子 prim 的插值模式这一点将在后文详述。Uniform Interpolation均匀插值uniform模式要求每个面片段patch segment保持一个恒定元素对于 Mesh prim为每个面face提供数组中的一个元素数组元素的数量与顺序必须与 Mesh 的faceVertexCounts数组完全一致有多少个 face就有多少个元素对于曲线 prim为每个曲线段curve segment提供数组中的一个元素具体规则参见UsdGeomBasisCurves的 Primvar Interpolation 说明。uniform插值的元素通常不被插值但会被继承给由该面派生出的其他面例如细分、tessellation 产生的子面参见 mesh.h。以下示例中两面的 Mesh 对应两个颜色每个面获得各自的颜色#usda 1.0 ( ) def Mesh uniform { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(1, 0, 0), (0,0,1)] ( interpolation uniform ) double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }Vertex Interpolation顶点插值vertex模式使用 prim 表面或曲线的**基函数basis functions**对元素进行插值对于 Mesh primprimvar 数组为每个 point 提供 1 个元素数组顺序与 Mesh 的points数组一一对应对于 BasisCurvesprimvar 数组为曲线每个 point 提供 1 个元素顺序与 prim 的points数组一致。术语说明Mesh 在 USD 中是由 points 连接成边和面来定义的。许多外部参考资料会用 vertex 指代 points有时又用 vertex 指代定义面的 face-vertices。为避免混淆USD 中刻意避免使用 vertex 一词统一采用 point 或 face vertex见 mesh.h 的相关注释。下面例子中两个面的 Mesh 提供与points数组数量、顺序完全一致的 6 个颜色。Hydra/Storm 渲染结果从 (-1,0,0) 处的红色渐变到 (1,1,0) 处的蓝色#usda 1.0 ( ) def Mesh vertex { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(1, 0, 0), (0.75,0,0), (0.5,0,0.25), (0.25,0,0.5), (0,0,1), (0,0,0.75)] ( interpolation vertex ) double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }从 mesh.h 的源码注释可以看到vertex与varying的关键差异两者都是每个 point 一个元素但vertex模式的插值遵循subdivisionScheme属性指定的细分基函数而varying永远是线性插值。Varying Interpolation变化插值varying模式在每个表面面片或曲线段上使用线性基函数插值元素四边形面片使用双线性bilinear插值三角化 Mesh 面使用重心barycentric插值曲线段使用线性插值。对于 Mesh primprimvar 数组为每个 point 提供 1 个元素顺序与points数组一致。用 varying 为网格点设置颜色非常类似于游戏引擎中的 vertex colors对于 BasisCurves为每个曲线段提供 2 个元素。段数取决于曲线类型、wrap周期性以及curveVertexCounts值详见UsdGeomBasisCurves的 Primvar Interpolation 表格。示例同样提供与points一一对应的 6 个颜色#usda 1.0 ( ) def Mesh varying { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(1, 0, 0), (0.75,0,0), (0.5,0,0.25), (0.25,0,0.5), (0,0,1), (0,0,0.75)] ( interpolation varying ) double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }varying 与 vertex 的微妙差异细心的话你会发现上面的 varying 示例渲染结果与 vertex 示例看起来非常相似——两者的差异确实很微妙。由于vertex使用 prim 表面/曲线的基函数插值我们可以通过调整 Mesh 的细分方式来放大差异下面的例子展示同一个两四边形 Mesh 分别使用 varying 与 vertex 插值displayColor从黑渐变到白。用usdview --complexity veryhigh渲染可以看到高度细分后 vertex 插值沿着表面产生更平滑的渐变而 varying 插值呈现更线性的渐变#usda 1.0 ( ) def Mesh varying { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(0, 0, 0), (0,0,0), (1,1,1), (1,1,1), (0,0,0), (0,0,0)] ( interpolation varying ) double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] } def Mesh vertex { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(0, 0, 0), (0,0,0), (1,1,1), (1,1,1), (0,0,0), (0,0,0)] ( interpolation vertex ) double3 xformOp:translate (0, -1.5, -10) uniform token[] xformOpOrder [xformOp:translate] }在更复杂的曲面与纹理场景中这种差异会体现为纹理在面片边缘的拉伸程度不同下图为 varying 与 vertex 各自的效果注意高亮区域中 varying 示例纹理沿面片边缘略微更拉伸varying 复杂曲面纹理效果primvar_interp_varying.pngvertex 复杂曲面纹理效果primvar_interp_vertex.png实用建议如果你处理的网格数据是明确不打算细分的多边形网格应当使用 varying 插值并把 Mesh 的细分方案设为subdivisionScheme none。这样无论渲染器是否支持细分网格渲染结果都保持一致。faceVarying Interpolation逐面顶点插值faceVarying是五种模式中最灵活也最容易出错的一种。对于多边形与细分表面它允许为每个face-vertex指定不同的元素为每个点的每个面顶点提供独立元素从而在某个面上实现独立的插值同时不影响周围面上的插值结果。典型应用场景包括制造纹理坐标映射的 seam接缝例如模拟把标签纸环绕包裹在圆柱体上时产生的 UV 不连续常与索引化 primvar见下文配合描述网格拓扑的不连续处discontinuities。注意目前faceVarying插值不支持曲线basis curves。对于 Mesh primprimvar 数组为每个面的每个 face-vertex 提供 1 个元素数量与顺序必须与 Mesh 的faceVertexIndices数组一致。下面例子中两面 Mesh 提供与faceVertexIndices数量、顺序一致的 8 个颜色每个面从红色渐变到蓝色#usda 1.0 ( ) def Mesh faceVarying { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(0,0,1), (0,0,0.75), (0.75,0,0), (1,0,0), (0,0,1), (0,0,0.75), (0.75,0,0), (1,0,0)] ( interpolation faceVarying ) double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }控制细分表面的 faceVarying 插值规则对于细分表面元素如何插值还受 Mesh 的faceVaryingLinearInterpolation属性控制。根据 mesh.h 的源码定义该属性默认值为cornersPlus1允许值包括取值含义none无线性约束处处平滑cornersOnly仅在不连续边界拐角处锐化其余平滑cornersPlus1默认同cornersOnly并在出现 3 个及以上不同 face-varying 值的点处额外锐化cornersPlus2同cornersPlus1并在至少一个不连续边界拐角或只有一条不连续边界边dart的点处额外锐化boundaries沿不连续边界分段线性内部平滑all处处分段线性这些规则与 OpenSubdiv 的 FaceVarying Interpolation Rules 一一对应。下面的例子把上述 faceVarying 示例配置为在边界与内部都使用线性插值all#usda 1.0 ( ) def Mesh faceVarying { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(0,0,1), (0,0,0.75), (0.75,0,0), (1,0,0), (0,0,1), (0,0,0.75), (0.75,0,0), (1,0,0)] ( interpolation faceVarying ) # Configure the face-varying interpolation rule for this surface token faceVaryingLinearInterpolation all double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }Primvars 与场景命名空间Primvar 与普通 USD 属性有一个重要区别primvar 会沿场景命名空间向下继承。普通属性只作用于被指定的那个 prim而 primvar 隐式地作用于所有子级 imageable prim除非子 prim 对同名 primvar 拥有自己的意见 opinion。这使得在复杂模型层级中可以稀疏地在高层 prim 上一次性为所有 Gprim 声明共享数据。但需要注意只有constant插值模式的 primvar 会沿命名空间传播。这条限制是为了防止依赖拓扑的插值模式如 vertex、faceVarying被传播到子 prim 后一旦子 prim 的 Mesh 拓扑发生变化就会引发难以排查的资产损坏。从源码可以印证这一点primvarsAPI.h 中FindInheritablePrimvars()的注释明确写道Only primvars withauthored,non-blocked,constant interpolationvalues are inheritable; fallback values are not inherited只有已编写、未阻塞、constant 插值的 primvar 才可继承fallback 值不会被继承。配合FindInheritablePrimvars()自顶向下的递归计算见 primvarsAPI.h 中关于 O(n) 继承计算的描述USD 能以高效的方式把父级 constant primvar 提供给整棵子树。在下面的例子中ParentXform为displayColor编写了 constant 插值的意见ChildMesh自身没有为displayColor编写任何意见却会自动使用来自父 prim 的值进行渲染#usda 1.0 ( ) def Xform ParentXform { color3f[] primvars:displayColor [(1, 0, 0)] ( interpolation constant ) double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] def Mesh ChildMesh { float3[] extent [(0, 0, 0), (1, 1, 0)] point3f[] points [(0, 0, 0), (0, 1, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4] int[] faceVertexIndices [3, 2, 1, 0] # Primvar inherits down namespace, so this child prim automatically gets primvar double3 xformOp:translate (0.5, -1, 0) uniform token[] xformOpOrder [xformOp:translate] } }在使用**场景实例化scene instancing**时primvar 同样会按预期隐式作用于实例层级你可以在实例 prim 上编写覆盖值这些编辑会被隐式应用到该实例。需要注意不能在实例 prim 的子 prim 上覆盖 primvar因为场景实例化本身不允许在实例 prim 下的后代 prim 上存在属性。Indexed Primvars索引化 PrimvarPrimvar 支持索引化数据indexed data数据通过索引引用而不是重复书写完整元素从而显著降低内存占用。一个典型场景是用 primvar 描述 Mesh 的表面法线——多个顶点共享同一个法线向量此时用索引引用远比在 primvar 数组中重复法线高效。我们可以把前面 faceVarying 的例子改写成索引化版本用索引避免重复书写相同的颜色#usda 1.0 ( ) def Mesh faceVarying { float3[] extent [(-1, 0, 0), (1, 1, 0)] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] color3f[] primvars:displayColor [(0,0,1), (0,0,0.75), (0.75,0,0), (1,0,0)] ( interpolation faceVarying ) # Use primvar indices to avoid duplicate elements in primvars array int[] primvars:displayColor:indices [0,1,2,3,0,1,2,3] double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }注意索引引用的是 primvar 中的元素element在本例以及大多数场景中元素等价于 primvar 数组中的单个值但如果 primvar 的elementSize大于 1一个索引对应的是由多个数组值组成的元素详见下文 elementSize 一节。从消费端看primvar.h 提供了GetIndices()与IsIndexed()来查询索引信息ComputeFlattened()primvar.h则可以把索引化 primvar 展开成扁平数组——即使对非索引化 primvar 调用也是安全的它等价于直接读取值数组。使用 faceVarying 插值的 primvar 配合索引可以无歧义地定义函数在边和顶点处的不连续性再叠加 faceVarying 线性插值规则即上一节的faceVaryingLinearInterpolation即可完整刻画细分表面的 UV 接缝等效果。索引化 Primvar 与 Attribute Block 的陷阱Primvar 虽然以属性attribute的形式可访问但应避免直接对 primvar 使用 attribute block属性数据块。原因在于对 primvar 施加 attribute block 只会阻塞 primvar 的元素elements却不会阻塞 primvar 的索引——索引存储在一个独立属性primvars:name:indices中这样可以按需随时间变化。正确的做法是使用UsdGeom.PrimvarsAPI的BlockPrimvar()API它会同时阻塞元素与索引。以带索引的 faceVarying 示例为例如果只对 primvar 属性调用Block()stage Usd.Stage.Open(faceVarying-example.usda) prim stage.GetPrimAtPath(/faceVarying) primvar_api UsdGeom.PrimvarsAPI(prim) # If you call Block() on the primvar attribute, this will only block the # elements, not the indices primvar primvar_api.GetPrimvar(primvars:displayColor) primvar.GetAttr().Block() print(stage.ExportToString())扁平化后的 stage 中primvars:displayColor变为None但primvars:displayColor:indices仍保留着编写的索引数组def Mesh faceVarying { float3[] extent [(-1, 0, 0), (1, 1, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] color3f[] primvars:displayColor None ( interpolation faceVarying ) int[] primvars:displayColor:indices [0, 1, 2, 3, 0, 1, 2, 3] double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }这会在之后重新编写 primvar 元素、而不知晓索引如何设置时引发微妙的错误。如果改用BlockPrimvar()primvar_api.BlockPrimvar(primvars:displayColor)则 primvar 元素与索引都会被置为Nonedef Mesh faceVarying { float3[] extent [(-1, 0, 0), (1, 1, 0)] int[] faceVertexCounts [4, 4] int[] faceVertexIndices [3, 2, 1, 0, 5, 4, 2, 3] point3f[] points [(-1, 0, 0), (-1, 1, 0), (0, 1, 0), (0, 0, 0), (1, 1, 0), (1, 0, 0)] color3f[] primvars:displayColor None ( interpolation faceVarying ) int[] primvars:displayColor:indices None double3 xformOp:translate (0, 0, -10) uniform token[] xformOpOrder [xformOp:translate] }primvarsAPI.h 中BlockPrimvar()的源码注释也强调它将确保 EditTarget 中的所有值包括元素与索引都被正确移除这正是规避上述陷阱的标准做法。Primvar Element Size元素大小本文前面用 element元素 一词指代 primvar 值数组中的单个值。但 primvar 还可以通过elementSize指定primvar 数组中每多少个连续值被视为一个参与插值的元素。若未设置elementSize默认为 1。UsdGeomPrimvar::GetElementSize()primvar.h即为读取该值的消费端 API。下面是一个简单示例prim 上有一个字符串数组 primvarelementSize 2同时它被索引化我们可以展开扁平化后的 primvar观察每个索引如何对应字符串数组中的一对值#usda 1.0 ( ) def Cube TestPrim { string[] primvars:testPrimvar [element1-partA, element1-partB, element2-partA, element2-partB] ( elementSize 2 ) int[] primvars:testPrimvar:indices [0, 1, 0] }扁平化后的 primvar 为[element1-partA, element1-partB, element2-partA, element2-partB, element1-partA, element1-partB]注意索引引用的是值数组中的一对值例如索引 1 对应值数组中的第三、第四个元素element2-partA 与 element2-partB。通常情况下默认的elementSize 1足以满足绝大多数需求。但当你需要向渲染器传递聚合型元素时例如用 9 个浮点系数表示球谐函数 spherical harmonics就需要使用更大的elementSize。小结与最佳实践回顾全文围绕 Primvar 的使用可以沉淀出几条可验证的实践准则按拓扑选模式元素数量必须严格匹配——constant1 个、uniform每面 1 个、varying/vertex每 point 1 个、faceVarying每 face-vertex 1 个即与faceVertexIndices等长不细分网格用 varying对subdivisionScheme none的多边形网格使用 varying保证跨渲染器渲染结果一致父级共享数据用 constant只有 constant 插值且已编写、未阻塞的 primvar 才能沿命名空间继承见 primvarsAPI.h同时可利用实例 prim 上的覆盖实现按实例差异化重复数据走索引共享法线、UV 等高频重复数据用primvars:name:indices索引化降低内存占用并为 faceVarying 提供无歧义的不连续描述阻塞一律用BlockPrimvar()直接对 primvar 属性调用Block()只会阻塞元素而遗留索引是典型的隐性 bug 来源聚合数据调大 elementSize球谐系数等多值聚合元素通过elementSize声明消费端用ComputeFlattened()展开读取。如需深入源码可继续查阅 primvarsAPI.h、primvar.h 与 mesh.h 中 Mesh primvar 约定及faceVaryingLinearInterpolation的完整定义。【免费下载链接】OpenUSDUniversal Scene Description项目地址: https://gitcode.com/GitHub_Trending/ope/OpenUSD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考