iOS SceneKit中设置纹理位移平铺时应用崩溃问题排查

我之前也踩过这个坑，问题出在你设置的SCNMatrix4MakeScale(10, 10, 0)里的z轴缩放值为0。SceneKit的contentsTransform是一个4x4变换矩阵，虽然位移纹理是2D的，但矩阵的z轴分量不能设为0——这会导致矩阵不可逆，直接触发底层渲染引擎的崩溃。

修正后的代码 #

把z轴缩放改成1（完全不影响2D纹理的平铺效果，只是保证矩阵的有效性）：

material.displacement.contents = "displacement.png"
// 将z轴缩放从0改为1，避免矩阵奇异
material.displacement.contentsTransform = SCNMatrix4MakeScale(10, 10, 1)
material.displacement.wrapT = .repeat
material.displacement.wrapS = .repeat

为什么这样能解决问题？ #

• contentsTransform本质是用来变换纹理坐标的矩阵，对于2D纹理来说，z轴的变换不会实际影响显示效果，但矩阵必须是可逆的（行列式不能为0）。当z轴缩放设为0时，矩阵行列式直接变为0，SceneKit在尝试应用这个变换时会抛出崩溃。
• 设置z轴为1既保留了你需要的x/y轴缩放平铺效果，又能保证矩阵的有效性，让wrapS和wrapT的重复设置正常生效。

额外验证小贴士 #

1. 确认displacement.png已经正确添加到项目资源中，并且勾选了对应的target
2. 检查模型的UV坐标是否合理，UV映射错误的话，即使设置了重复模式，纹理也可能不会按预期平铺

内容的提问来源于stack exchange，提问作者Mr.Kushwaha