"""
OpenGL Geometry Buffer Upload
=============================
This module provides utilities for uploading vertex and element data to OpenGL buffers,
including VAOs (Vertex Array Objects), VBOs (Vertex Buffer Objects), and optionally EBOs
(Element Buffer Objects). It supports interleaved vertex attributes and automatic binding
of attribute pointers.
Functions:
----------
.. autofunction:: upload_geometry_buffers
General-purpose function to upload vertex and optional index data to OpenGL buffers.
Automatically binds attribute pointers and stores buffer handles in a user-defined object.
.. autofunction:: upload_vertex_buffer
Uploads a simple vertex buffer and computes proximity-based index pairs for rendering.
Parameters:
-----------
- `vao_target`: Name of the VAO attribute in the target object.
- `vbo_target`: Name of the VBO attribute in the target object.
- `render_buffers`: Object or dataclass holding OpenGL buffer handles.
- `vertex_data`: Interleaved vertex attributes (e.g., positions, normals).
- `attributes`: List of tuples (location, size, offset) for attribute pointers.
- `element_data`: Optional index data for indexed rendering.
- `ebo_target`: Name of the EBO attribute in the target object.
- `usage`: Buffer usage hint (e.g., GL_STATIC_DRAW).
Usage Example:
--------------
.. code-block:: python
upload_geometry_buffers(
vao_target="mesh_vao",
vbo_target="mesh_vbo",
render_buffers=my_buffers,
vertex_data=vertices,
attributes=[(0, 3, 0), (1, 3, 12)],
element_data=indices,
ebo_target="mesh_ebo"
)
"""
import ctypes
import numpy as np
from OpenGL.GL import glBufferData, glVertexAttribPointer
from OpenGL.raw.GL._types import GL_FALSE, GL_FLOAT
from OpenGL.raw.GL.VERSION.GL_1_5 import (
GL_ARRAY_BUFFER,
GL_ELEMENT_ARRAY_BUFFER,
GL_STATIC_DRAW,
glBindBuffer,
glGenBuffers,
)
from OpenGL.raw.GL.VERSION.GL_2_0 import glEnableVertexAttribArray
from OpenGL.raw.GL.VERSION.GL_3_0 import glBindVertexArray, glGenVertexArrays
from picogl.backend.modern.core.vertex.array.object import VertexArrayObject
[docs]
def upload_geometry_buffers(
vao_target: str,
vbo_target: str,
render_buffers: object,
vertex_data: np.ndarray,
attributes: list[tuple[int, int, int]], # (location, size, offset)
*,
element_data: np.ndarray = None,
ebo_target: str = None,
usage: int = GL_STATIC_DRAW,
) -> None:
"""
upload_geometry_buffers
:param vao_target: Name of the VAO attribute in render_buffers (e.g. "calpha_vao")
:param vbo_target: Name of the VBO attribute in render_buffers (e.g. "calpha_buffer_group")
:param render_buffers: Any object or dataclass holding OpenGL buffer handles
:param vertex_data: Interleaved vertex attributes (e.g. position_array + normal)
:param attributes: List of tuples (location, size, offset) for glVertexAttribPointer
:param element_data: Optional index data (e.g. for GL_TRIANGLES)
:param ebo_target: Name of the EBO attribute in render_buffers
:param usage: GL_STATIC_DRAW or GL_DYNAMIC_DRAW
General-purpose VAO/VBO upload function for vertex geometry.
"""
vao = glGenVertexArrays(1)
vao_object = VertexArrayObject()
vbo = glGenBuffers(1)
vao_object.add_vbo(index=0, data=vertex_data, size=3, name=vbo_target)
setattr(render_buffers, vao_target, vao)
setattr(render_buffers, vbo_target, vbo)
glBindVertexArray(vao)
glBindBuffer(GL_ARRAY_BUFFER, vbo)
glBufferData(GL_ARRAY_BUFFER, vertex_data.nbytes, vertex_data, usage)
stride = vertex_data.shape[1] * 4 # float32 = 4 bytes
for location, size, offset in attributes:
glEnableVertexAttribArray(location)
glVertexAttribPointer(
location, size, GL_FLOAT, GL_FALSE, stride, ctypes.c_void_p(offset)
)
if element_data is not None and ebo_target is not None:
ebo = glGenBuffers(1)
setattr(render_buffers, ebo_target, ebo)
glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, ebo)
glBufferData(GL_ELEMENT_ARRAY_BUFFER, element_data.nbytes, element_data, usage)
glBindVertexArray(0)
[docs]
def upload_vertex_buffer(vao: int, vbo: int, points: np.ndarray):
"""
upload_vertex_buffer
:param vao: int
:param vbo: int
:param points: np.ndarray
:return: list indices
"""
glBindVertexArray(vao)
glBindBuffer(GL_ARRAY_BUFFER, vbo)
glBufferData(GL_ARRAY_BUFFER, points.nbytes, points, GL_STATIC_DRAW)
glEnableVertexAttribArray(0)
glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 0, None)
glBindVertexArray(0)