pyglet 2.1.12__py3-none-any.whl → 3.0.dev1__py3-none-any.whl

pyglet/graphics/api/webgl/vertexarray.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import pyglet
+
+if TYPE_CHECKING:
+    from pyglet.graphics.api.webgl import OpenGLSurfaceContext
+    from pyglet.graphics.api.webgl.webgl_js import WebGLVertexArrayObject
+
+__all__ = ['VertexArray']
+
+
+class VertexArray:
+    """OpenGL Vertex Array Object."""
+
+    _context: OpenGLSurfaceContext | None
+    _id: WebGLVertexArrayObject
+
+    def __init__(self, context: OpenGLSurfaceContext) -> None:
+        """Create an instance of a Vertex Array object."""
+        self._context = context
+        self._gl = self._context.gl
+        self._id = self._gl.createVertexArray()
+
+    @property
+    def id(self) -> WebGLVertexArrayObject | int:
+        return self._id
+
+    def bind(self) -> None:
+        self._gl.bindVertexArray(self._id)
+
+    def unbind(self) -> None:
+        self._gl.bindVertexArray(None)
+
+    def delete(self) -> None:
+        self._gl.deleteVertexArray(self._id)
+        self._id = None
+
+    __enter__ = bind
+
+    def __exit__(self, *_) -> None:  # noqa: ANN002
+        self._gl.bindVertexArray(None)
+
+    def __del__(self) -> None:
+        if self._id is not None:
+            try:
+                self._context.delete_vao(self.id)
+                self._id = None
+            except (ImportError, AttributeError):
+                pass  # Interpreter is shutting down
+
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}(id={self._id})"

pyglet/graphics/api/webgl/vertexdomain.py

@@ -0,0 +1,616 @@
+"""Manage related vertex attributes within a single vertex domain.
+
+A vertex "domain" consists of a set of attribute descriptions that together
+describe the layout of one or more vertex buffers which are used together to
+specify the vertices in a primitive.  Additionally, the domain manages the
+buffers used to store the data and will resize them as necessary to accommodate
+new vertices.
+
+Domains can optionally be indexed, in which case they also manage a buffer
+containing vertex indices.  This buffer is grown separately and has no size
+relation to the attribute buffers.
+
+Applications can create vertices (and optionally, indices) within a domain
+with the :py:meth:`VertexDomain.create` method.  This returns a
+:py:class:`VertexList` representing the list of vertices created.  The vertex
+attribute data within the group can be modified, and the changes will be made
+to the underlying buffers automatically.
+
+The entire domain can be efficiently drawn in one step with the
+:py:meth:`VertexDomain.draw` method, assuming all the vertices comprise
+primitives of the same OpenGL primitive mode.
+"""
+from __future__ import annotations
+
+import ctypes
+from typing import TYPE_CHECKING, Any, Sequence
+
+from pyglet.graphics.api.base import SurfaceContext
+from pyglet.graphics.api.webgl import vertexarray
+from pyglet.graphics.api.webgl.gl import (
+    GL_BYTE,
+    GL_DOUBLE,
+    GL_FLOAT,
+    GL_INT,
+    GL_SHORT,
+    GL_UNSIGNED_BYTE,
+    GL_UNSIGNED_INT,
+    GL_UNSIGNED_SHORT,
+    GLint,
+    GLintptr,
+    GLsizei,
+    GLvoid,
+)
+from pyglet.graphics.api.webgl.enums import geometry_map
+from pyglet.graphics.api.webgl.shader import GLAttribute
+from pyglet.graphics.api.webgl.buffer import AttributeBufferObject, IndexedBufferObject
+from pyglet.graphics.instance import InstanceBucket, BaseInstanceDomain, VertexInstanceBase
+from pyglet.graphics.vertexdomain import (
+    VertexArrayBinding,
+    VertexArrayProtocol,
+    InstanceStream,
+    VertexStream,
+    IndexStream,
+    VertexListBase,
+    IndexedVertexListBase,
+    VertexDomainBase,
+    IndexedVertexDomainBase,
+    VertexGroupBucket,
+    _RunningIndexSupport,
+    InstanceIndexedVertexListBase,
+    InstancedIndexedVertexDomainBase,
+    InstancedVertexDomainBase,
+    InstanceVertexListBase,
+)
+
+if TYPE_CHECKING:
+    from pyglet.graphics.shader import AttributeView
+    from pyglet.customtypes import CType, DataTypes
+    from pyglet.graphics import GeometryMode
+    from pyglet.graphics.shader import Attribute
+    from pyglet.graphics.api.webgl.context import OpenGLSurfaceContext
+
+_c_types = {
+    GL_BYTE: ctypes.c_byte,
+    GL_UNSIGNED_BYTE: ctypes.c_ubyte,
+    GL_SHORT: ctypes.c_short,
+    GL_UNSIGNED_SHORT: ctypes.c_ushort,
+    GL_INT: ctypes.c_int,
+    GL_UNSIGNED_INT: ctypes.c_uint,
+    GL_FLOAT: ctypes.c_float,
+    GL_DOUBLE: ctypes.c_double,
+}
+
+_gl_types = {
+    'b': GL_BYTE,
+    'B': GL_UNSIGNED_BYTE,
+    'h': GL_SHORT,
+    'H': GL_UNSIGNED_SHORT,
+    'i': GL_INT,
+    'I': GL_UNSIGNED_INT,
+    'f': GL_FLOAT,
+    'd': GL_DOUBLE,
+}
+
+
+def _make_attribute_property(name: str) -> property:
+    def _attribute_getter(self: VertexList) -> ctypes.Array[float | int]:
+        buffer = self.domain.attrib_name_buffers[name]
+        region = buffer.get_region(self.start, self.count)
+        buffer.invalidate_region(self.start, self.count)
+        return region
+
+    def _attribute_setter(self: VertexList, data: Any) -> None:
+        buffer = self.domain.attrib_name_buffers[name]
+        buffer.set_region(self.start, self.count, data)
+
+    return property(_attribute_getter, _attribute_setter)
+
+
+class _GLVertexStreamMix(VertexStream):
+    _ctx: OpenGLSurfaceContext
+    attrib_name_buffers: dict[str, AttributeBufferObject]
+
+    def __init__(self, ctx: OpenGLSurfaceContext, initial_size: int, attrs: Sequence[Attribute], *, divisor: int = 0):
+        super().__init__(ctx, initial_size, attrs, divisor=divisor)
+
+    def get_graphics_attribute(self, attribute: Attribute, view: AttributeView) -> GLAttribute:
+        return GLAttribute(attribute, view)
+
+    def get_buffer(self, size: int, attribute) -> AttributeBufferObject:
+        return AttributeBufferObject(self._ctx, size, attribute)
+
+    def bind_into(self, vao) -> None:
+        for attribute, buffer in zip(self.attribute_names.values(), self.buffers):
+            buffer.bind()
+            attribute.enable()
+            attribute.set_pointer()
+            attribute.set_divisor()
+
+class GLVertexStream(_GLVertexStreamMix, VertexStream):  # noqa: D101
+    def __init__(self, ctx: OpenGLSurfaceContext, initial_size: int, attrs: Sequence[Attribute]) -> None:
+        """Contains data for vertex stream.
+
+        Args:
+            ctx:
+                The core context that owns this stream.
+            initial_size:
+                Initial buffer size.
+            attrs:
+                Attributes that will be used.
+        """
+        super().__init__(ctx, initial_size, attrs)
+
+class GLInstanceStream(_GLVertexStreamMix, InstanceStream):  # noqa: D101
+    _ctx: OpenGLSurfaceContext
+
+    def __init__(self, ctx: OpenGLSurfaceContext, initial_size: int, attrs: Sequence[Attribute],  # noqa: D107
+                 *, divisor: int = 0) -> None:
+        super().__init__(ctx, initial_size, attrs, divisor=divisor)
+
+class GLVertexArrayBinding(VertexArrayBinding):  # noqa: D101
+
+    def _create_vao(self) -> VertexArrayProtocol:
+        return vertexarray.VertexArray(self._ctx)
+
+    def _link(self) -> None:
+        self.vao.bind()
+        for stream in self.streams:
+            stream.bind_into(self.vao)
+        self.vao.unbind()
+
+    def bind(self) -> None:
+        self.vao.bind()
+
+    def unbind(self) -> None:
+        self.vao.unbind()
+
+
+class VertexList(VertexListBase):
+    ...
+
+class InstanceVertexList(InstanceVertexListBase):
+    ...
+
+class IndexedVertexList(IndexedVertexListBase):
+    ...
+
+class InstanceIndexedVertexList(InstanceIndexedVertexListBase):
+    ...
+
+class GLIndexStream(IndexStream):  # noqa: D101
+    index_element_size: int
+    index_c_type: CType
+    gl_type: int
+
+    def __init__(self, ctx: OpenGLSurfaceContext, data_type: DataTypes, initial_elems: int) -> None:  # noqa: D107
+        self.gl_type = _gl_types[data_type]
+        self.index_c_type = _c_types[self.gl_type]
+        self.index_element_size = ctypes.sizeof(self.index_c_type)
+        super().__init__(ctx, data_type, initial_elems)
+
+    def _create_buffer(self) -> IndexedBufferObject:
+        return IndexedBufferObject(self.ctx, self.allocator.capacity * self.index_element_size,
+                                                self.index_c_type,
+                                                self.index_element_size,
+                                                1)
+
+    def bind_into(self, vao: VertexArrayBinding) -> None:
+        self.buffer.bind_to_index_buffer()
+
+
+class VertexDomain(VertexDomainBase):
+    """Management of a set of vertex lists.
+
+    Construction of a vertex domain is usually done with the
+    :py:func:`create_domain` function.
+    """
+
+    def __init__(self, context: SurfaceContext, initial_count: int, attribute_meta: dict[str, Attribute]) -> None:
+        super().__init__(context, initial_count, attribute_meta)
+        self._gl = context.gl
+        if self._supports_multi_draw:
+            self._multi_draw_array = self._gl.getExtension("WEBGL_multi_draw").multiDrawArraysWEBGL
+        else:
+            self._multi_draw_array = None
+
+    def draw_bucket(self, mode: int, bucket) -> None:
+        bucket.draw(self, mode)
+
+    def draw_buckets(self, mode: int, buckets: list[VertexGroupBucket]) -> None:
+        regions = []
+        for bucket in buckets:
+            regions.extend(bucket.merged_ranges)
+
+        start_list = [region[0] for region in regions]
+        size_list = [region[1] for region in regions]
+        primcount = len(regions)
+        if self._supports_multi_draw:
+            starts = (GLint * primcount)(*start_list)
+            sizes = (GLsizei * primcount)(*size_list)
+            self._multi_draw_array(starts[:], 0, sizes[:], 0, primcount)
+        else:
+            for start, size in zip(start_list, size_list):
+                self._gl.drawArrays(mode, start, size)
+
+    def _create_vertex_class(self) -> type:
+        return type(self._vertex_class.__name__, (self._vertex_class,), self.vertex_buffers._property_dict)
+
+    def _has_multi_draw_extension(self, ctx: OpenGLSurfaceContext) -> bool:
+        return ctx.gl.getExtension("WEBGL_multi_draw")
+
+    def _create_vao(self) -> GLVertexArrayBinding:
+        return GLVertexArrayBinding(self._context, self._streams)
+
+    def _create_streams(self, size: int) -> list[VertexStream | IndexStream | InstanceStream]:
+        self.vertex_buffers = GLVertexStream(self._context, size, self.per_vertex)
+        return [self.vertex_buffers]
+
+    def draw(self, mode: int) -> None:
+        """Draw all vertices in the domain.
+
+        All vertices in the domain are drawn at once. This is the
+        most efficient way to render primitives.
+
+        Args:
+            mode:
+                OpenGL drawing mode, e.g. ``GL_POINTS``, ``GL_LINES``, etc.
+
+        """
+        self.vao.bind()
+        self.vertex_buffers.commit()
+
+        starts, sizes = self.vertex_buffers.allocator.get_allocated_regions()
+        primcount = len(starts)
+        if primcount == 0:
+            pass
+        elif primcount == 1:
+            # Common case
+            self._gl.drawArrays(mode, starts[0], sizes[0])
+        else:
+            if self._multi_draw_array:
+                starts = (GLint * primcount)(*starts)
+                sizes = (GLsizei * primcount)(*sizes)
+                self._multi_draw_array(starts[:], 0, sizes[:], 0, primcount)
+            else:
+                # If not available, draw separately.
+                for start, size in zip(starts, sizes):
+                    self._gl.drawArrays(mode, start, size)
+
+    def draw_subset(self, mode: GeometryMode, vertex_list: VertexList) -> None:
+        """Draw a specific VertexList in the domain.
+
+        The `vertex_list` parameter specifies a :py:class:`VertexList`
+        to draw. Only primitives in that list will be drawn.
+
+        Args:
+            mode:
+                OpenGL drawing mode, e.g. ``GL_POINTS``, ``GL_LINES``, etc.
+            vertex_list:
+                Vertex list to draw.
+
+        """
+        self.vao.bind()
+        self.vertex_buffers.commit()
+        self._gl.drawArrays(geometry_map[mode], vertex_list.start, vertex_list.count)
+
+    @property
+    def is_empty(self) -> bool:
+        return not self.vertex_buffers.allocator.starts
+
+    def __repr__(self) -> str:
+        return f'<{self.__class__.__name__}@{id(self):x} vertex_alloc={self.vertex_buffers.allocator}>'
+
+
+class GLInstanceDomainArrays(BaseInstanceDomain):  # noqa: D101
+    def __init__(self, domain: Any, initial_instances: int) -> None:
+        super().__init__(domain, initial_instances)
+        self._ctx = domain._context  # noqa: SLF001
+        self._gl = domain._context.gl  # noqa: SLF001
+
+    def _create_bucket_arrays(self) -> InstanceBucket:
+        istream = GLInstanceStream(self._ctx, self._initial, self._domain.per_instance, divisor=1)
+        vao = GLVertexArrayBinding(self._ctx, [self._domain.vertex_buffers, istream])
+        return InstanceBucket(istream, vao)
+
+    def _create_bucket_elements(self) -> InstanceBucket:
+        raise NotImplementedError("Use GLInstanceDomainElements for indexed draws")
+
+    def draw(self, mode: int) -> None:
+        for key, bucket in self._buckets.items():
+            if bucket.instance_count <= 0:
+                continue
+            first_vertex, vertex_count = self._geom[bucket]
+            bucket.vao.bind()
+            bucket.stream.commit()
+            self._gl.drawArraysInstanced(mode, first_vertex, vertex_count, bucket.instance_count)
+
+    def draw_subset(self, mode: int, vertex_list: InstanceVertexList):
+        """Draw a specific VertexList in the domain."""
+        bucket = vertex_list.bucket
+        bucket.vao.bind()
+        bucket.stream.commit()
+        self._gl.drawArraysInstanced(mode, vertex_list.start, vertex_list.count, bucket.instance_count)
+
+class GLInstanceDomainElements(BaseInstanceDomain):  # noqa: D101
+    _ctx: OpenGLSurfaceContext
+
+    def __init__(self, domain: Any, initial_instances: int, index_stream: GLIndexStream) -> None:
+        super().__init__(domain, initial_instances)
+        self._ctx = domain._context  # noqa: SLF001
+        self._gl = domain._context.gl  # noqa: SLF001
+        self._index_stream = index_stream
+        self._index_gl_type = self._index_stream.gl_type
+        self._elem_size = index_stream.index_element_size
+
+    def _create_bucket_elements(self) -> InstanceBucket:
+        istream = GLInstanceStream(self._ctx, self._initial, self._domain.per_instance, divisor=1)
+        vao = GLVertexArrayBinding(self._ctx, [self._domain.vertex_buffers, istream, self._index_stream])
+        return InstanceBucket(istream, vao)
+
+    def _create_bucket_arrays(self) -> InstanceBucket:
+        raise NotImplementedError("Use GLInstanceDomainArrays for non-indexed draws")
+
+    def draw_bucket(self, mode: int, bucket: InstanceBucket) -> None:
+        if bucket.instance_count <= 0:
+            return
+        first_index, index_count, _, _ = self._geom[bucket]
+        byte_offset = first_index * self._elem_size
+        bucket.vao.bind()
+        bucket.stream.commit()
+        self._gl.drawElementsInstanced(
+            mode, index_count, self._index_gl_type, byte_offset,
+            bucket.instance_count,
+        )
+
+    def draw_subset(self, mode: GeometryMode, vertex_list: InstanceIndexedVertexList) -> None:
+        """Draw a specific VertexList in the domain."""
+        byte_offset = vertex_list.index_start * self._elem_size
+        self._gl.drawElementsInstanced(
+            mode, vertex_list.index_count, self._index_gl_type, byte_offset,
+            vertex_list.bucket.instance_count,
+        )
+
+    def draw(self, mode: int) -> None:
+        for key, bucket in self._buckets.items():
+            if bucket.instance_count <= 0:
+                continue
+            first_index, index_count, _, _ = self._geom[bucket]
+            byte_offset = first_index * self._elem_size
+            bucket.vao.bind()
+            bucket.stream.commit()
+            self._gl.drawElementsInstanced(
+                mode, index_count, self._index_gl_type, byte_offset,
+                bucket.instance_count,
+            )
+
+
+class InstancedVertexDomain(InstancedVertexDomainBase):  # noqa: D101
+    _vertexinstance_class: type
+    _vertex_class = InstanceVertexList
+
+    def _create_vertex_class(self) -> type:
+        return type(self._vertex_class.__name__, (self._vertex_class,), self.vertex_buffers._property_dict)
+
+    def _has_multi_draw_extension(self, ctx):
+        return False
+
+    def _create_vao(self) -> GLVertexArrayBinding:
+        return GLVertexArrayBinding(self._context, self._streams)
+
+    def _create_streams(self, size: int) -> list[VertexStream | IndexStream | InstanceStream]:
+        self.vertex_buffers = GLVertexStream(self._context, size, self.per_vertex)
+        return [self.vertex_buffers]
+
+    def create_instance_domain(self, size: int) -> BaseInstanceDomain:
+        return GLInstanceDomainArrays(self, size)
+
+    def draw_buckets(self, mode: int, buckets: list[VertexGroupBucket]) -> None:
+        """Draw a specific VertexGroupBucket in the domain."""
+        self.instance_domain.draw(mode)
+
+    def _create_vao(self) -> None:
+        """Handled by buckets."""
+
+    def draw(self, mode: int) -> None:
+        """Draw all vertices in the domain.
+
+        All vertices in the domain are drawn at once. This is the
+        most efficient way to render primitives.
+
+        Args:
+            mode:
+                OpenGL drawing mode, e.g. ``GL_POINTS``, ``GL_LINES``, etc.
+
+        """
+        self.vertex_buffers.commit()
+        self.instance_buckets.draw(mode)
+
+    def draw_subset(self, mode: GeometryMode, vertex_list: InstanceVertexList) -> None:
+        """Draw a specific VertexList in the domain.
+
+        The `vertex_list` parameter specifies a :py:class:`VertexList`
+        to draw. Only primitives in that list will be drawn.
+
+        Args:
+            mode:
+                OpenGL drawing mode, e.g. ``GL_POINTS``, ``GL_LINES``, etc.
+            vertex_list:
+                Vertex list to draw.
+        """
+        self.vertex_buffers.commit()
+        self.instance_buckets.draw_subset(geometry_map[mode], vertex_list)
+
+
+
+class IndexedVertexDomain(IndexedVertexDomainBase):
+    """Management of a set of indexed vertex lists.
+
+    Construction of an indexed vertex domain is usually done with the
+    :py:func:`create_domain` function.
+    """
+
+    _vertex_class = IndexedVertexList
+    _supports_base_vertex: bool = False
+
+    def __init__(self, context: SurfaceContext, initial_count: int, attribute_meta: dict[str, Attribute],
+                 index_type: DataTypes = "I") -> None:
+        super().__init__(context, initial_count, attribute_meta, index_type)
+        self._gl = context.gl
+        if self._supports_multi_draw:
+            self._multi_draw_elements = self._gl.getExtension("WEBGL_multi_draw").multiDrawElementsWEBGL
+        else:
+            self._multi_draw_elements = None
+
+    def _create_vertex_class(self) -> type:
+        return type(self._vertex_class.__name__, (_RunningIndexSupport, self._vertex_class),
+                                      self.vertex_buffers._property_dict)  # noqa: SLF001
+
+    def _create_vao(self) -> GLVertexArrayBinding:
+        return GLVertexArrayBinding(self._context, self._streams)
+
+    def _create_streams(self, size: int) -> list[VertexStream | IndexStream | InstanceStream]:
+        self.vertex_buffers = GLVertexStream(self._context, size, self.per_vertex)
+        self.index_stream = GLIndexStream(self._context, self.index_type, size)
+        return [self.vertex_buffers, self.index_stream]
+
+    def draw_buckets(self, mode: int, buckets: list[VertexGroupBucket]) -> None:
+        regions = []
+        for bucket in buckets:
+            regions.extend(bucket.merged_ranges)
+
+        start_list = [region[0] for region in regions]
+        size_list = [region[1] for region in regions]
+        primcount = len(regions)
+        if self._supports_multi_draw:
+            starts = [s * self.index_stream.index_element_size for s in start_list]
+            starts = (ctypes.POINTER(GLvoid) * primcount)(*(GLintptr * primcount)(*starts))
+            sizes = (GLsizei * primcount)(*size_list)
+            self._multi_draw_elements(mode, sizes[:], 0, self.index_stream.gl_type, starts[:], 0, primcount)
+        else:
+            for start, size in zip(start_list, size_list):
+                self._gl.drawElements(mode, size, self.index_stream.gl_type,
+                                      start * self.index_stream.index_element_size)
+
+    def _has_multi_draw_extension(self, ctx: OpenGLSurfaceContext) -> bool:
+        return ctx.gl.getExtension("WEBGL_multi_draw")
+
+    def draw(self, mode: int) -> None:
+        """Draw all vertices in the domain.
+
+        All vertices in the domain are drawn at once. This is the
+        most efficient way to render primitives.
+
+        Args:
+            mode:
+                OpenGL drawing mode, e.g. ``GL_POINTS``, ``GL_LINES``, etc.
+
+        """
+        self.vao.bind()
+        self.vertex_buffers.commit()
+        self.index_stream.buffer.commit()
+
+        starts, sizes = self.index_stream.allocator.get_allocated_regions()
+        primcount = len(starts)
+        if primcount == 0:
+            pass
+        elif primcount == 1:
+            # Common case
+            self._gl.drawElements(mode, sizes[0], self.index_stream.gl_type, starts[0] * self.index_stream.index_element_size)
+        else:
+            if self._multi_draw_elements:
+                starts = [s * self.index_stream.index_element_size for s in starts]
+                starts = (ctypes.POINTER(GLvoid) * primcount)(*(GLintptr * primcount)(*starts))
+                sizes = (GLsizei * primcount)(*sizes)
+                self._multi_draw_elements(mode, sizes[:], 0, self.index_stream.gl_type, starts[:], 0, primcount)
+            else:
+                for start, size in zip(starts, sizes):
+                    self._gl.drawElements(mode, size, self.index_stream.gl_type,
+                                          start * self.index_stream.index_element_size)
+
+    def draw_subset(self, mode: GeometryMode, vertex_list: IndexedVertexList) -> None:
+        """Draw a specific IndexedVertexList in the domain.
+
+        The `vertex_list` parameter specifies a :py:class:`IndexedVertexList`
+        to draw. Only primitives in that list will be drawn.
+
+        Args:
+            mode:
+                OpenGL drawing mode, e.g. ``GL_POINTS``, ``GL_LINES``, etc.
+            vertex_list:
+                Vertex list to draw.
+        """
+        self.vao.bind()
+        self.vertex_buffers.commit()
+        self.index_stream.buffer.commit()
+
+        self._gl.drawElements(geometry_map[mode], vertex_list.index_count, self.index_stream.gl_type,
+                       vertex_list.index_start * self.index_stream.index_element_size)
+
+
+class InstancedIndexedVertexDomain(InstancedIndexedVertexDomainBase):
+    """Management of a set of indexed vertex lists.
+
+    Construction of an indexed vertex domain is usually done with the
+    :py:func:`create_domain` function.
+    """
+    _initial_index_count: int = 16
+    _vertex_class = InstanceIndexedVertexList
+
+    def _create_vertex_class(self) -> type:
+        return type(self._vertex_class.__name__, (_RunningIndexSupport, self._vertex_class),
+                                      self.vertex_buffers._property_dict)  # noqa: SLF001
+
+    def _create_vao(self) -> GLVertexArrayBinding:
+        return GLVertexArrayBinding(self._context, self._streams)
+
+    def _create_streams(self, size: int) -> list[VertexStream | IndexStream | InstanceStream]:
+        self.vertex_buffers = GLVertexStream(self._context, size, self.per_vertex)
+        self.index_stream = GLIndexStream(self._context, self.index_type, size)
+        return [self.vertex_buffers, self.index_stream]
+
+    def create_instance_domain(self, size: int) -> GLInstanceDomainElements:
+        return GLInstanceDomainElements(self, size, index_stream=self.index_stream)
+
+    def _has_multi_draw_extension(self, ctx):
+        return False
+
+    def _create_vao(self) -> None:
+        """Handled by buckets."""
+
+    def draw(self, mode: int) -> None:
+        """Draw all vertices in the domain.
+
+        All vertices in the domain are drawn at once. This is the
+        most efficient way to render primitives.
+
+        Args:
+            mode:
+                OpenGL drawing mode, e.g. ``GL_POINTS``, ``GL_LINES``, etc.
+
+        """
+        self.vertex_buffers.commit()
+        self.index_stream.commit()
+        self.instance_domain.draw(mode)
+    def draw_buckets(self, mode: int, buckets: list[VertexGroupBucket]) -> None:
+        """Draw a specific VertexGroupBucket in the domain."""
+        for bucket in buckets:
+            for vl_range in bucket.ranges:
+                self.instance_domain.draw_bucket(mode, self._instance_map[vl_range])
+
+    def draw_subset(self, mode: GeometryMode, vertex_list: InstanceIndexedVertexListBase) -> None:
+        """Draw a specific IndexedVertexList in the domain.
+
+        The ``vertex_list`` parameter specifies a :py:class:`IndexedVertexList`
+        to draw. Only primitives in that list will be drawn.
+
+        Args:
+            mode:
+                OpenGL drawing mode, e.g. ``GL_POINTS``, ``GL_LINES``, etc.
+            vertex_list:
+                Vertex list to draw.
+
+        """
+        self.vertex_buffers.commit()
+        self.index_stream.commit()
+        self.instance_domain.draw_subset(geometry_map[mode], vertex_list)