PAYATHON 2026

Metal 中如何用 VertexBuffer 传递动态顶点数据并避免图形错乱?

数据小陈

结论

这段代码的主要问题是,每次绘制图形前都向同一个 vertexBuffer 的起始位置写入新顶点,覆盖了前一次绘制仍需要的数据。

drawPrimitives 负责编码绘制命令,调用返回时 GPU 并没有完成绘制。setVertexBuffer 绑定缓冲区及其偏移量,不会为当前绘制保存一份缓冲区内容的副本。因此,多次绘制需要使用各自有效的数据区域,并在 GPU 使用结束前保持数据不变。

setVertexBuffer 和 setVertexBytes 可以混用。当前 shader 通过 buffer(0) 接收顶点,通过 buffer(1) 接收 Uniforms,两种传递方式可以配合使用。

单个 MTLBuffer 的长度固定,实际参与绘制的顶点数量可以变化。容量不足时,可以创建更大的缓冲区,也可以将数据分到多个缓冲区中。

为什么圆和粗线一起绘制会出错?

代码的执行顺序可以简化为:

CPU:将圆的顶点写入 vertexBuffer,起始偏移为 0
CPU:编码绘制圆的命令
CPU:将粗线的顶点写入同一个 vertexBuffer,起始偏移仍为 0
CPU:编码绘制粗线的命令
CPU:提交 commandBuffer
GPU:执行绘制命令并读取缓冲区

提交前,粗线的四个顶点已经覆盖了圆的前四个顶点。绘制圆的命令仍使用圆的 vertexCount,但读取的数组中已混入粗线数据。

如果后续图形写入更多数据,覆盖范围还会扩大。这可以解释多图形绘制时出现的缺失、扭曲和相互干扰。只画一个图形时,同一帧内没有后续写入造成覆盖,因此可能正常;不过,跨帧复用同一缓冲区仍需要同步。

setVertexBytes 会复制传入的数据,后续修改 CPU 数组不会改变前一次调用已提交给编码器的数据,因此原来的写法没有暴露同样的问题。

正方形只显示一个三角形的具体原因还无法确定,因为问题中没有提供 drawSquare 的实现。如果它也在多次绘制之间覆盖同一段缓冲区,就有相同的风险;如果整个正方形确实只用一次绘制调用,还需要检查顶点排列、primitive 类型、vertexCount 和剔除设置。

先用每个图形独立的缓冲区修复

最直接的修改是保留现有几何计算,为每个图形创建独立的顶点缓冲区。这样容易确认异常是否由数据覆盖引起。

将下面的辅助函数放在 draw(in:) 内,与现有嵌套绘制函数处于同一作用域,使用已经创建的 device、encoder 和 uniforms:

func drawShape(
    _ vertices: [SIMD2<Float>],
    color: SIMD4<Float>
) {
    guard !vertices.isEmpty else { return }

    let byteCount = vertices.count * MemoryLayout<SIMD2<Float>>.stride

    let buffer: MTLBuffer? = vertices.withUnsafeBufferPointer { pointer in
        device.makeBuffer(
            bytes: pointer.baseAddress!,
            length: byteCount,
            options: .storageModeShared
        )
    }

    guard let buffer = buffer else {
        fatalError("Could not create vertex buffer")
    }

    var shapeUniforms = uniforms
    shapeUniforms.color = color

    encoder.setVertexBuffer(buffer, offset: 0, index: 0)
    encoder.setVertexBytes(
        &shapeUniforms,
        length: MemoryLayout<Uniforms>.stride,
        index: 1
    )
    encoder.setFragmentBytes(
        &shapeUniforms,
        length: MemoryLayout<Uniforms>.stride,
        index: 1
    )
    encoder.drawPrimitives(
        type: .triangleStrip,
        vertexStart: 0,
        vertexCount: vertices.count
    )
}

在 drawArc 中生成顶点后,用下面的调用替换原来的顶点上传、Uniforms 上传和绘制部分:

drawShape(verticies, color: color)

在 drawThickLine 中生成顶点后,同样替换为:

drawShape(vertices, color: color)

makeBuffer(bytes:length:options:) 会复制数组中的字节,因此闭包结束后不需要继续保留数组的底层指针。这里沿用原代码的普通 makeCommandBuffer();默认的资源保留行为会让绘制引用的缓冲区存活到命令执行结束。如果使用不保留资源引用的 command buffer,则需要自行管理资源生命周期。

这种实现适合先验证修复效果。图形数量较多时,可以再减少每帧创建缓冲区的次数。

如何让多个图形共用一个缓冲区?

可以先收集一帧所需的全部顶点,将不同图形放在互不重叠的区域,并记录每个图形的起始位置、顶点数量和颜色。

例如:

frameBuffer
├─ 圆的顶点
├─ 粗线的顶点
└─ 正方形的顶点

一种简单的索引方式是始终绑定缓冲区起点,通过 vertexStart 选择图形所在的顶点范围:

encoder.setVertexBuffer(frameBuffer, offset: 0, index: 0)

// 在此之前设置当前图形的 Uniforms。
encoder.drawPrimitives(
    type: .triangleStrip,
    vertexStart: shapeFirstVertex,
    vertexCount: shapeVertexCount
)

shapeFirstVertex 和 shapeVertexCount 都以顶点为单位。当前 shader 使用 position[vid],因此非零的 vertexStart 会让它从对应的顶点位置开始读取。

也可以通过 setVertexBuffer 的字节 offset 定位图形,再将 vertexStart 设为 0。这种方式需要满足目标设备和数据类型的偏移对齐要求。不要同时把相同的起始偏移应用到绑定偏移和 vertexStart,否则会重复偏移。

不同图形仍应分别调用 drawPrimitives。直接把多个独立图形作为一条 .triangleStrip 绘制,会在图形之间产生连接三角形。

顶点数量持续增长时如何扩容?

缓冲区容量和本次绘制使用的数据量是两回事:

  • buffer.length 是已经分配的字节容量。
  • vertexCount 是当前绘制需要读取的顶点数量。
  • 顶点较少时,只绘制有效范围,剩余容量可以留空。
  • 容量不足时,创建更大的缓冲区,并上传仍然需要的数据。

如果每帧上传所有图形,应按这一帧的总字节数分配容量,而不是只按最大的单个图形分配。

原代码中的这段逻辑只更新了一个整数:

if maxVerticiesSize < verticiesSize {
    maxVerticiesSize = verticiesSize
}

它不会改变已经创建的 vertexBuffer.length。写入前必须检查实际缓冲区容量:

precondition(verticiesSize <= vertexBuffer.length)

这项检查只能发现容量不足,不能解决数据覆盖或 CPU/GPU 同步问题。扩容需要重新调用 makeBuffer。可以预留容量或按倍数增长,避免每增加少量顶点就重新分配。

对于持续增长的绘图内容,也可以按笔画或固定大小的数据块保存顶点。已完成的笔画保持不变,只更新正在绘制的部分,以减少重复上传。

复用缓冲区还需要处理跨帧同步

即使一帧内每个图形使用不同区域,下一帧也不能立即覆盖上一帧仍在读取的区域。

.storageModeShared 让 CPU 和 GPU 能访问同一块存储,但不会自动协调读写时机。commit() 返回也不代表 GPU 已完成执行。

常见做法是使用多个帧缓冲区或 ring buffer,通过 command buffer 的完成回调配合信号量、可用列表等机制,确认对应区域可以再次写入。仅按帧号轮换几个缓冲区还不够,还需要限制在途帧数量,避免 CPU 追上尚未完成的 GPU 工作。

排查时可以暂时在 commit() 后调用 waitUntilCompleted(),确认是否存在跨帧覆盖。它会阻塞 CPU,不适合作为交互式绘图程序的常规同步方案,也无法修复当前代码在同一次 commit() 前就覆盖圆顶点的问题。

顶点与 Uniforms 可以继续分别上传

当前绑定关系可以保留:

encoder.setVertexBuffer(vertexBuffer, offset: 0, index: 0)
encoder.setVertexBytes(
    &uniforms,
    length: MemoryLayout<Uniforms>.stride,
    index: 1
)
encoder.setFragmentBytes(
    &uniforms,
    length: MemoryLayout<Uniforms>.stride,
    index: 1
)

顶点阶段和片元阶段各自拥有缓冲区绑定位置。setVertexBytes 与 setFragmentBytes 分别为两个阶段提供 Uniforms,不会因为都使用 index: 1 就互相覆盖。每次设置完成后,再编码对应的绘制调用即可。

还有两处细节值得检查:

  1. 完整圆的循环每次追加四个 simd_float2。steps: 120 会生成 480 个顶点,按每个 8 字节计算为 3840 字节;steps: 360 则为 11520 字节。这也解释了提高分段数后为什么需要改用缓冲区。
  2. Swift 初始化参数写的是 drawWithTetxure,shader 字段写的是 drawWithTexture。字段名称本身不决定原始字节布局,但缺少 Swift 端 Uniforms 定义,无法确认两端是否一致。应检查字段顺序、大小、对齐及矩阵布局。

reserveCapacity(steps * 2) 只影响 Swift 数组的预分配。这里每轮追加四个顶点,可以按预期顶点数预留容量;预留不足时数组仍会自动扩容,因此这不是本次图形错乱的主要原因。

备注:内容仅供参考。