insertAlongUV 操作

语法

• insertAlongUV(uvSet, filePath, height)
• insertAlongUV(uvSet, filePath, height, heightDirection, heightAlignment)

参数

1. uvSet - float
   纹理坐标集编号（介于 [0,9] 之间的整数）。 编号与材料属性的纹理图层相对应，另请参阅纹理：基本知识。
2. filePath - string
   要插入的几何资产的文件路径。 有关搜索位置的信息，请参阅资产搜索。 有关插入操作的受支持的资产格式的备注在此同样适用。
3. height - float
   插入的几何的高度，采用世界坐标系。
4. heightDirection - selector
   • scope.y - 高度沿范围 y 轴（默认）投影。 用于示例 alignScopeToAxes 或 alignScopeToGeometry 以调整 y 轴。
   • vertex.normal - 高度将沿当前形状的（内插）折点法线进行投影。

     注：

     始终根据当前形状的几何计算折点法线；将丢弃现有折点法线。 如果面断开连接，则必须合并重复折点，才能使用相邻面法线计算折点法线。

5. heightAlignment - selector
   • alignPosition - 资产将置于当前形状的面（默认）上。
   • keepPosition - 资产沿高度维度的位置相对于其原点放置。

描述

insertAlongUV 用于从文件中读取几何资产（3D 模型、面网格），然后通过将资产的宽度和深度映射到所选 uv 集沿当前形状的 uv 坐标将其插入。 具体如下： 资产的 x 跨度映射至 u（范围介于 [0,1] 之间）并进行重复， z 跨度映射至 -v， y 跨度设置为所选 height 参数。
将根据适合初始形状的 uv 空间的新几何对资产进行剪切和弯曲。 在已分配 uv 集的形状上，使用分割以及 normalizeUV、rotateUV 和 scaleUV 等纹理操作可根据需求设置 uv。

注：

资产仅映射到当前形状的三角形和四边形上。

注意事项

• 新几何不会继承资产的折点法线。 可使用 setNormals 或 softenNormals 重新计算折点法线。
• 资产需要剪切才能适合 uv 空间。 这将创建可使用 cleanupGeometry 移除的共面边和共线折点。
• 与插入操作不同，创建新几何会中断实例化。 此外，不会自动应用修剪。

相关内容

• insert 操作
• normalizeUV 操作
• projectUV 操作
• resetGeometry 操作
• rotateUV 操作
• scaleUV 操作
• setupProjection 操作
• tileUV 操作
• translateUV 操作

示例

街道

道路障碍资产沿街道形状的 uv 坐标进行插入。 const width = assetInfo("barrier.obj", sx) const height = assetInfo("barrier.obj", sy) Street --> split(v, unitSpace, 0) { width : InsertBarrier | ~1 : Street. | width : InsertBarrier | ~1 : Street. | width : InsertBarrier } InsertBarrier --> rotateUV(0, 90) normalizeUV(0, u, collectiveAllFaces) insertAlongUV(0, "barrier.obj", height)
如果资产定向为 x 与 u 反向对应，则不需要 rotateUV()，以下更改产生的结果与上面相同。 const width = assetInfo("barrier.obj", sz) InsertBarrier --> normalizeUV(0, u, collectiveAllFaces) insertAlongUV(0, "barrier.obj", height)
使用 alignScopeToAxes(y) 可确保护栏沿上坡街道形状的 uv 坐标插入时保持竖直。 tileUV 会导致资产重复。 const width = assetInfo("guardrail.obj", sx) const height = assetInfo("guardrail.obj", sy) const depth = assetInfo("guardrail.obj", sz) Street --> alignScopeToAxes(y) split(v, unitSpace, 0) { depth : rotateUV(0, 180) InsertGuardrail | ~1 : NIL | depth : InsertGuardrail } InsertGuardrail --> normalizeUV(0, v, collectiveAllFaces) tileUV(0, ~width, 0) insertAlongUV(0, "guardrail.obj", height)

重复几何

平面形状沿其 uv 坐标进行分割，并在每个分割结点处插入球体资产。 要获得类似的结果，可通过转换 uv 坐标并沿 uv 坐标插入球体资产。 与第一个示例相反，这仅创建一个叶形状。 Example1 --> split(u, uvSpace, 0) { '0.25 : split(v, uvSpace, 0) { '0.25 : s('1, 2.5, '1) i("sphere.obj") Sphere. }* }* Example2 --> scaleUV(0, 4.0, 4.0) insertAlongUV(0, "sphere.obj", 2.5) setNormals(auto)
树模型将根据 uv 范围进行插入，并使用组件分割提取树干。 Lot --> setupProjection(0, scope.zx, '0.25, '0.25) projectUV(0) Texture insertAlongUV(0, "Orange_Tree_Analytical_0.obj", 25) comp(g) { 0 : set(material.opacity, 0.1) Foliage. | 1 : Trunk. } Texture --> texture("builtin:uvtest.png")

曲面

insertAlongUV 操作也可以用于创建弯曲窗户。 通过使用 vertex.normal 选项，窗户资产将绕圆柱弯曲。 keepPosition 选项会相对于资产原点对其进行放置。 const asset = "windowAligned.obj" const sy = assetInfo(asset, sy) const sx = assetInfo(asset, sx) const sz = assetInfo(asset, sz) Lot --> primitiveCylinder(32, 2, 4) comp(f) { side = Side | all = Endcaps. } Side --> split(u, unitSpace, 0) { sx : Split | ~1.5 : Wall. }* Split --> split(y) { ~1: Wall. | sz: Window | ~1: Wall. } Window --> normalizeUV(0, uv, collectiveAllFaces) insertAlongUV(0, asset, sy, vertex.normal, keepPosition) color("#804000")

在此示例中，2D 和 3D 资产在曲面上重复插入。 请注意，height 参数可设置为正值、零和负值。 Sphere --> primitiveSphere() scaleUV(0, 10, 10) split(y) { ~1 : insertAlongUV(0, "pyramid.obj", 0.5, vertex.normal, alignPosition) color(1,0.5,0.5) Pyramids. | ~1 : insertAlongUV(0, "circles2D.obj", 0, vertex.normal, alignPosition) color(0.5,1,0.5) Circles2D. | ~1 : insertAlongUV(0, "circles3D.obj", -0.5, vertex.normal, alignPosition) color(0.5,0.5,1) Circles3D. }