glBufferSubData无报错但OpenGL体素渲染无输出问题

代码存在多处OpenGL API误用，旧版固定管线默认静默忽略非法操作，所以不会抛出可见错误，直接导致渲染空白：

• 缓冲区初始化不完整、容量不足：顶点位置VBO初始仅分配48字节（仅够存4个顶点），纹理坐标VBO完全没调用glBufferData分配内存，直接调用glBufferSubData写入属于非法操作，数据根本没有写入显存。
• glBufferData参数顺序完全错误：该API的合法参数顺序为(目标类型, 缓冲区大小, 数据指针, 用法枚举)，原代码把用法枚举位置传成了顶点字节数、数据指针位置传错，每次调用都会创建大小非法的无效缓冲区。
• 顶点指针状态混乱：绑定顶点位置VBO时同时设置了顶点和纹理坐标指针，导致GPU把顶点位置数据当纹理坐标读取，数据完全错位。
• 纹理坐标维度不统一：一处设置3维纹理坐标、一处设置2维，体素渲染用的2维纹理坐标会导致内存读取步长错误。
• 写入偏移量计算错误：glBufferSubData的偏移参数传了追加完成后的数组总大小，而非追加前的已有数据末尾位置，每次写入都会越界、覆盖无效内存。
• 绘制顶点数计算错误：glDrawArrays需要传入实际顶点个数，原代码直接传了顶点数组的float元素总数，相当于把绘制数量放大了3倍，大量读取空显存数据。

glBufferSubData只能更新已经分配好的显存区域，不能用来给缓冲区扩容：

1. 初始化阶段先调用glBufferData给缓冲区预分配足够大的预留空间（data参数传None即可，只占显存不写入数据），用法枚举选GL_DYNAMIC_DRAW表示该缓冲区会频繁更新。
2. 追加数据时用变量记录当前的写入偏移位置，从偏移位置开始调用glBufferSubData写入新数据，写完后更新偏移量。
3. 如果预分配空间用完，再调用glBufferData扩容到更大尺寸（通常扩为原大小的2倍），用glCopyBufferSubData把旧数据拷贝到新缓冲区后继续写入。

import glfw, numpy as np
from OpenGL.GL import *
from ctypes import *
from core.texture_manager import *

glfw.init()

# 预定义缓冲区最大容量，可根据渲染需求调整
MAX_VERTEX_COUNT = 1024 * 1024
VBO_SIZE_POS = MAX_VERTEX_COUNT * 3 * 4  # 每个顶点3个float位置值，单float占4字节
VBO_SIZE_TEX = MAX_VERTEX_COUNT * 2 * 4  # 每个顶点2个float纹理坐标值

class VBOManager:
    def __init__(self, renderer):
        self.renderer = renderer
        self.current_pos_offset = 0  # 记录顶点位置缓冲区的写入偏移
        self.current_tex_offset = 0  # 记录纹理坐标缓冲区的写入偏移
    
    def run(self):
        for i in self.renderer.to_add[:self.renderer.to_add_count]:
            new_vert = np.array(i[0], dtype=np.float32)
            new_tex = np.array(i[1], dtype=np.float32)
            vert_byte_len = new_vert.nbytes
            tex_byte_len = new_tex.nbytes

            # 写入顶点位置到对应VBO
            glBindBuffer(GL_ARRAY_BUFFER, self.renderer.vbo)
            glBufferSubData(
                GL_ARRAY_BUFFER, 
                self.current_pos_offset,
                vert_byte_len, 
                new_vert.ctypes.data_as(POINTER(c_float))
            )

            # 写入纹理坐标到对应VBO
            glBindBuffer(GL_ARRAY_BUFFER, self.renderer.vbo_1)
            glBufferSubData(
                GL_ARRAY_BUFFER, 
                self.current_tex_offset,
                tex_byte_len, 
                new_tex.ctypes.data_as(POINTER(c_float))
            )

            # 更新写入偏移
            self.current_pos_offset += vert_byte_len
            self.current_tex_offset += tex_byte_len
            # 同步更新内存中的顶点数组
            self.renderer.vertices = np.concatenate([self.renderer.vertices, new_vert])
            self.renderer.texCoords = np.concatenate([self.renderer.texCoords, new_tex])

            self.renderer.to_add.remove(i)

class TerrainRenderer:
    def __init__(self, window):
        self.window = window

        self.vertices = np.array([], dtype=np.float32)
        self.texCoords = np.array([], dtype=np.float32)

        self.to_add = []
        self.to_add_count = 256

        # 生成两个VBO并预分配显存
        self.vbo, self.vbo_1 = glGenBuffers(2)
        glBindBuffer(GL_ARRAY_BUFFER, self.vbo)
        glBufferData(GL_ARRAY_BUFFER, VBO_SIZE_POS, None, GL_DYNAMIC_DRAW)
        glBindBuffer(GL_ARRAY_BUFFER, self.vbo_1)
        glBufferData(GL_ARRAY_BUFFER, VBO_SIZE_TEX, None, GL_DYNAMIC_DRAW)

        self.vbo_manager = VBOManager(self)
        self.texture_manager = TextureAtlas()

        glEnable(GL_TEXTURE_2D)
        glEnable(GL_BLEND)
        glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA)
        glEnableClientState(GL_TEXTURE_COORD_ARRAY)
        glEnableClientState(GL_VERTEX_ARRAY)

    def render(self):
        self.vbo_manager.run()
        glClear(GL_COLOR_BUFFER_BIT)

        glEnable(GL_TEXTURE_2D)
        glEnable(GL_BLEND)
        glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA)

        # 分别绑定VBO设置对应读取指针
        glBindBuffer(GL_ARRAY_BUFFER, self.vbo)
        glVertexPointer(3, GL_FLOAT, 0, None)
        glBindBuffer(GL_ARRAY_BUFFER, self.vbo_1)
        glTexCoordPointer(2, GL_FLOAT, 0, None)

        # 按每个顶点3个位置float计算实际顶点数
        glDrawArrays(GL_QUADS, 0, len(self.vertices) // 3)

        glDisable(GL_TEXTURE_2D)
        glDisable(GL_BLEND)

    def add(self, posList, texCoords):
        self.to_add.append((np.array(posList, dtype=np.float32), np.array(texCoords, dtype=np.float32)))

优化提示：直接用numpy数组的.ctypes.data_as()方法取内存指针，比手动构造(c_float * len(...))(*...)的方式性能高很多，也能避免类型转换错误。如果后续需要加载的顶点超过预分配的最大值，可以在检测到偏移量即将超出缓冲区大小时，重新调用glBufferData分配2倍大小的空间，把旧数据拷贝到新缓冲区后再继续写入。

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