SceneKit中字号≤0.5时SCNText多行失效，如何正常显示小字号多行文本？

问题场景 #

使用SCNText的isWrapped和containerFrame属性实现长文本换行时，遇到异常：当字号设置为0.5或更小时，多行文本会折叠成一行；将字号设为0.6时，文本则能按预期多行显示。

相关代码 #

let content = "This is an example of a very super extra long text."
let scnText = SCNText(string: content, extrusionDepth: 0.2)
scnText.font = UIFont(name: "Helvetica", size: 0.4)
scnText.alignmentMode = CATextLayerAlignmentMode.center.rawValue
scnText.isWrapped = true
let size = CGSize(width: 4, height: 6)
scnText.containerFrame = CGRect(origin: scnText.containerFrame.origin, size: size)
let scnTextNode = SCNNode(geometry: scnText)

解决思路 #

这是SceneKit处理极小字号文本布局时的精度计算问题，推荐以下两种修复方式：

方式一：放大字号+节点缩放（稳定性最优） #

先设置一个较大的基础字号，让布局系统能正常计算换行逻辑，再通过缩放节点还原到需要的视觉大小。修改后的代码示例：

let content = "This is an example of a very super extra long text."
let scnText = SCNText(string: content, extrusionDepth: 0.2)
// 设置较大的基础字号，避免布局精度丢失
scnText.font = UIFont(name: "Helvetica", size: 6)
scnText.alignmentMode = CATextLayerAlignmentMode.center.rawValue
scnText.isWrapped = true
// 对应放大容器尺寸，保持与字号的比例一致
let size = CGSize(width: 40, height: 60)
scnText.containerFrame = CGRect(origin: .zero, size: size)
let scnTextNode = SCNNode(geometry: scnText)
// 缩放节点到目标视觉大小（0.1对应原字号0.6→0.6，若要0.4则缩放比例为0.4/6≈0.0667）
scnTextNode.scale = SCNVector3(0.0667, 0.0667, 0.0667)

方式二：调整容器高度比例 #

针对极小字号，适当增大containerFrame的高度值，给布局系统足够的多行识别空间，但这种方式受字体、文本内容影响较大，稳定性不如第一种。

原理说明 #

SceneKit的文本布局引擎在处理极小数值时易出现精度丢失，放大字号后布局计算基于更大的数值，能避免精度问题，再通过节点缩放还原到所需的视觉大小，同时保证换行逻辑正常工作。

内容的提问来源于stack exchange，提问作者Rudy Huynh