En esta página

QOpenGLBuffer Class

La clase QOpenGLBuffer ofrece funciones para crear y gestionar objetos de búfer de OpenGL. Más información...

Encabezado: #include <QOpenGLBuffer>
CMake: find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake: QT += opengl

Tipos públicos

enum Access { ReadOnly, WriteOnly, ReadWrite }
enum RangeAccessFlag { RangeRead, RangeWrite, RangeInvalidate, RangeInvalidateBuffer, RangeFlushExplicit, RangeUnsynchronized }
flags RangeAccessFlags
enum Type { VertexBuffer, IndexBuffer, PixelPackBuffer, PixelUnpackBuffer }
enum UsagePattern { StreamDraw, StreamRead, StreamCopy, StaticDraw, StaticRead, …, DynamicCopy }

Funciones públicas

QOpenGLBuffer()
QOpenGLBuffer(QOpenGLBuffer::Type type)
QOpenGLBuffer(const QOpenGLBuffer &other)
(since 6.5) QOpenGLBuffer(QOpenGLBuffer &&other)
~QOpenGLBuffer()
void allocate(const void *data, int count)
void allocate(int count)
bool bind()
GLuint bufferId() const
bool create()
void destroy()
bool isCreated() const
void *map(QOpenGLBuffer::Access access)
void *mapRange(int offset, int count, QOpenGLBuffer::RangeAccessFlags access)
bool read(int offset, void *data, int count)
void release()
void setUsagePattern(QOpenGLBuffer::UsagePattern value)
int size() const
(since 6.5) void swap(QOpenGLBuffer &other)
QOpenGLBuffer::Type type() const
bool unmap()
QOpenGLBuffer::UsagePattern usagePattern() const
void write(int offset, const void *data, int count)
(since 6.5) QOpenGLBuffer &operator=(QOpenGLBuffer &&other)
QOpenGLBuffer &operator=(const QOpenGLBuffer &other)

Miembros públicos estáticos

void release(QOpenGLBuffer::Type type)

Descripción detallada

Los objetos de búfer se crean en el servidor OpenGL para que la aplicación cliente pueda evitar tener que cargar vértices, índices, datos de imágenes de textura, etc., cada vez que se necesiten.

Los objetos `QOpenGLBuffer` pueden copiarse como una referencia al objeto búfer de OpenGL subyacente:

QOpenGLBuffer buffer1(QOpenGLBuffer::IndexBuffer);
buffer1.create();

QOpenGLBuffer buffer2 = buffer1;

QOpenGLBuffer realiza una copia superficial cuando los objetos se copian de esta manera, pero no implementa la semántica «copia al escribir». El objeto original se verá afectado cada vez que se modifique la copia.

Advertencia: Se espera quetodos los datos utilizados por QOpenGLBuffer sean de confianza. Los datos del búfer se transmiten a la implementación subyacente de OpenGL. Se recomienda a los desarrolladores de aplicaciones que sopesen cuidadosamente las posibles implicaciones antes de pasar contenido proporcionado por el usuario a funciones como allocate() y write().

Documentación sobre los tipos de miembros

enum QOpenGLBuffer::Access

Esta enumeración define el modo de acceso para la función ` QOpenGLBuffer::map()`.

ConstanteValorDescripción
QOpenGLBuffer::ReadOnly0x88B8El búfer se asignará solo para lectura.
QOpenGLBuffer::WriteOnly0x88B9El búfer se asignará solo para escritura.
QOpenGLBuffer::ReadWrite0x88BAEl búfer se asignará para lectura y escritura.

enum QOpenGLBuffer::RangeAccessFlag
flags QOpenGLBuffer::RangeAccessFlags

Esta enumeración define los bits de modo de acceso para ` QOpenGLBuffer::mapRange()`.

ConstanteValorDescripción
QOpenGLBuffer::RangeRead0x0001El búfer se asignará para lectura.
QOpenGLBuffer::RangeWrite0x0002El búfer se asignará para escritura.
QOpenGLBuffer::RangeInvalidate0x0004Descartar el contenido anterior del rango especificado.
QOpenGLBuffer::RangeInvalidateBuffer0x0008Descarta el contenido anterior de todo el búfer.
QOpenGLBuffer::RangeFlushExplicit0x0010Indica que las modificaciones deben vaciarse explícitamente mediante ` glFlushMappedBufferRange`.
QOpenGLBuffer::RangeUnsynchronized0x0020Indica que las operaciones pendientes no deben sincronizarse antes de salir de ` mapRange()`.

El tipo `RangeAccessFlags` es una definición de tipo (`typedef`) para `QFlags<RangeAccessFlag>`. Almacena una combinación OR de valores de `RangeAccessFlag`.

enum QOpenGLBuffer::Type

Esta enumeración define el tipo de objeto de búfer de OpenGL que se va a crear con ` QOpenGLBuffer`.

ConstanteValorDescripción
QOpenGLBuffer::VertexBuffer0x8892Objeto de búfer de vértices que se utiliza al especificar matrices de vértices.
QOpenGLBuffer::IndexBuffer0x8893Objeto de búfer de índices para utilizarlo con ` glDrawElements()`.
QOpenGLBuffer::PixelPackBuffer0x88EBObjeto de búfer de empaquetado de píxeles para leer datos de píxeles del servidor OpenGL (por ejemplo, con ` glReadPixels()`). No es compatible con OpenGL/ES.
QOpenGLBuffer::PixelUnpackBuffer0x88ECObjeto de búfer de desempaquetado de píxeles para escribir datos de píxeles en el servidor de OpenGL (por ejemplo, con ` glTexImage2D()`). No es compatible con OpenGL/ES.

enum QOpenGLBuffer::UsagePattern

Esta enumeración define el patrón de uso de un objeto ` QOpenGLBuffer `.

ConstanteValorDescripción
QOpenGLBuffer::StreamDraw0x88E0Los datos se establecerán una vez y se utilizarán varias veces para operaciones de dibujo. En OpenGL/ES 1.1, esto es idéntico a StaticDraw.
QOpenGLBuffer::StreamRead0x88E1Los datos se establecerán una vez y se utilizarán varias veces para recuperar datos del servidor OpenGL. No es compatible con OpenGL/ES.
QOpenGLBuffer::StreamCopy0x88E2Los datos se establecerán una vez y se utilizarán varias veces para leer datos del servidor OpenGL con el fin de utilizarlos en operaciones de dibujo posteriores. No es compatible con OpenGL/ES.
QOpenGLBuffer::StaticDraw0x88E4Los datos se establecerán una vez y se utilizarán muchas veces para operaciones de dibujo.
QOpenGLBuffer::StaticRead0x88E5Los datos se configurarán una vez y se utilizarán muchas veces para recuperar datos del servidor OpenGL. No es compatible con OpenGL/ES.
QOpenGLBuffer::StaticCopy0x88E6Los datos se establecerán una vez y se utilizarán muchas veces para leer datos del servidor OpenGL con el fin de utilizarlos en operaciones de dibujo posteriores. No es compatible con OpenGL/ES.
QOpenGLBuffer::DynamicDraw0x88E8Los datos se modificarán repetidamente y se utilizarán muchas veces para operaciones de dibujo.
QOpenGLBuffer::DynamicRead0x88E9Los datos se modificarán repetidamente y se utilizarán muchas veces para recuperar datos del servidor OpenGL. No compatible con OpenGL/ES.
QOpenGLBuffer::DynamicCopy0x88EALos datos se modificarán repetidamente y se utilizarán muchas veces para leer datos del servidor OpenGL con el fin de utilizarlos en operaciones de dibujo posteriores. No es compatible con OpenGL/ES.

Documentación de las funciones de miembro

QOpenGLBuffer::QOpenGLBuffer()

Crea un nuevo objeto búfer de tipo ` QOpenGLBuffer::VertexBuffer`.

Nota: este constructor solo crea la instancia de QOpenGLBuffer. El objeto búfer real en el servidor OpenGL no se crea hasta que se llama a create().

Véase también ` create()`.

[explicit] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer::Type type)

Crea un nuevo objeto búfer de tipo ` type`.

Nota: este constructor solo crea la instancia de QOpenGLBuffer. El objeto búfer real en el servidor OpenGL no se crea hasta que se llama a create().

Véase también ` create()`.

QOpenGLBuffer::QOpenGLBuffer(const QOpenGLBuffer &other)

Crea una copia superficial de ` other`.

Nota: QOpenGLBuffer no implementa la semántica de «copia al escribir», por lo que other se verá afectado cada vez que se modifique la copia.

[noexcept, since 6.5] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer &&other)

Crea un nuevo objeto `QOpenGLBuffer` a partir de ` other`.

Nota: El objeto del que se ha realizado la movida, ` other `, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

Esta función se introdujo en Qt 6.5.

[noexcept] QOpenGLBuffer::~QOpenGLBuffer()

Destruye este objeto de búfer, incluido el espacio de almacenamiento que se está utilizando en el servidor de OpenGL.

void QOpenGLBuffer::allocate(const void *data, int count)

Asigna count bytes de espacio al búfer, inicializado con el contenido de data. Se eliminará cualquier contenido anterior.

Se da por supuesto que se ha llamado a create() en este búfer y que se ha vinculado al contexto actual.

Véanse también create(), read() y write().

void QOpenGLBuffer::allocate(int count)

Asigna count bytes de espacio al búfer. Se eliminará cualquier contenido anterior.

Se da por hecho que se ha llamado a ` create()` en este búfer y que se ha vinculado al contexto actual.

Esta es una función sobrecargada.

Véanse también ` create()` y ` write()`.

bool QOpenGLBuffer::bind()

Vincula el búfer asociado a este objeto al contexto OpenGL actual. Devuelve ` false ` si no ha sido posible realizar la vinculación, normalmente porque la función ` type()` no es compatible con esta implementación de OpenGL.

El búfer debe estar vinculado al mismo QOpenGLContext que estaba activo cuando se llamó a create(), o a otro QOpenGLContext que lo comparta con él. De lo contrario, esta función devolverá «false».

Véanse también release() y create().

GLuint QOpenGLBuffer::bufferId() const

Devuelve el identificador OpenGL asociado a este búfer; cero si el búfer no se ha creado.

Véase también ` isCreated()`.

bool QOpenGLBuffer::create()

Crea el objeto de búfer en el servidor de OpenGL. Devuelve « true » si se ha creado el objeto; en caso contrario, devuelve «false».

Esta función debe invocarse con un ` QOpenGLContext` activo. El búfer quedará vinculado a ese contexto y solo podrá utilizarse en él (o en cualquier otro contexto que lo comparta).

Esta función devolverá «false» si la implementación de OpenGL no admite búferes o si no hay ningún ` QOpenGLContext` activo.

Véase también isCreated(), allocate(), write() y destroy().

void QOpenGLBuffer::destroy()

Destruye este objeto de búfer, incluido el espacio de almacenamiento que se está utilizando en el servidor de OpenGL. Todas las referencias al búfer dejarán de ser válidas.

bool QOpenGLBuffer::isCreated() const

Devuelve ` true ` si se ha creado este búfer; en caso contrario, devuelve `false`.

Véase también create() y destroy().

void *QOpenGLBuffer::map(QOpenGLBuffer::Access access)

Asigna el contenido de este búfer al espacio de memoria de la aplicación y devuelve un puntero al mismo. Devuelve «null» si no es posible realizar la asignación de memoria. El parámetro « access » indica el tipo de acceso que se va a realizar.

Se da por supuesto que se ha llamado a create() en este búfer y que se ha vinculado al contexto actual.

Nota: Esta función solo es compatible con OpenGL ES 2.0 o versiones anteriores si está presente la extensión GL_OES_mapbuffer.

Nota: En OpenGL ES 3.0 y versiones posteriores, o en el caso de OpenGL de escritorio, si se admite la extensión « GL_ARB_map_buffer_range », esta función utiliza ` glMapBufferRange ` en lugar de ` glMapBuffer`.

Véase también unmap(), create(), bind() y mapRange().

void *QOpenGLBuffer::mapRange(int offset, int count, QOpenGLBuffer::RangeAccessFlags access)

Asigna el rango especificado por ` offset ` y ` count ` del contenido de este búfer al espacio de memoria de la aplicación y devuelve un puntero al mismo. Devuelve `null` si no es posible realizar la asignación de memoria. El parámetro ` access ` especifica una combinación de indicadores de acceso.

Se da por supuesto que se ha llamado a create() en este búfer y que se ha vinculado al contexto actual.

Nota: Esta función no está disponible en OpenGL ES 2.0 y versiones anteriores.

Véase también ` unmap()`, ` create()` y ` bind()`.

bool QOpenGLBuffer::read(int offset, void *data, int count)

Lee los bytes count de este búfer, empezando por offset, y los almacena en data. Devuelve true si la operación se realiza correctamente; false si no se admite la lectura del búfer. La lectura del búfer no está admitida en OpenGL/ES.

Se da por supuesto que este búfer se ha vinculado al contexto actual.

Véase también write() y bind().

void QOpenGLBuffer::release()

Libera el búfer asociado a este objeto del contexto actual de OpenGL.

Esta función debe invocarse con el mismo ` QOpenGLContext ` vigente que cuando se invocó ` bind()` sobre el búfer.

Véase también bind().

[static] void QOpenGLBuffer::release(QOpenGLBuffer::Type type)

Libera el búfer asociado a type en el QOpenGLContext actual.

Esta función es una llamada directa a glBindBuffer(type, 0) y se utiliza cuando el autor de la llamada desconoce qué QOpenGLBuffer se ha vinculado al contexto, pero quiere asegurarse de que se libera.

QOpenGLBuffer::release(QOpenGLBuffer::VertexBuffer);

void QOpenGLBuffer::setUsagePattern(QOpenGLBuffer::UsagePattern value)

Establece el patrón de uso de este objeto de búfer en « value ». Esta función debe llamarse antes de « allocate()» o « write()».

Véanse también usagePattern(), allocate() y write().

int QOpenGLBuffer::size() const

Devuelve el tamaño de los datos contenidos en este búfer, para operaciones de lectura. Devuelve -1 si no se admite la obtención del tamaño del búfer o si el búfer no se ha creado.

Se da por hecho que este búfer se ha vinculado al contexto actual.

Véase también isCreated() y bind().

[noexcept, since 6.5] void QOpenGLBuffer::swap(QOpenGLBuffer &other)

Intercambia este búfer con other. Esta operación es muy rápida y nunca falla.

Esta función se introdujo en Qt 6.5.

QOpenGLBuffer::Type QOpenGLBuffer::type() const

Devuelve el tipo de búfer que representa este objeto.

bool QOpenGLBuffer::unmap()

Desasigna el búfer después de haberlo asignado al espacio de memoria de la aplicación mediante una llamada previa a ` map()`. Devuelve ` true ` si la desasignación se ha realizado correctamente; en caso contrario, devuelve `false`.

Se da por supuesto que este búfer se ha vinculado al contexto actual y que se ha asignado previamente mediante map().

Nota: Esta función solo es compatible con OpenGL ES 2.0 y versiones anteriores si está presente la extensión « GL_OES_mapbuffer ».

Véase también map().

QOpenGLBuffer::UsagePattern QOpenGLBuffer::usagePattern() const

Devuelve el patrón de uso de este objeto de búfer. El valor por defecto es StaticDraw.

Véase también setUsagePattern().

void QOpenGLBuffer::write(int offset, const void *data, int count)

Sustituye los bytes count de este búfer, a partir de la dirección offset, por el contenido de data. El resto de bytes del búfer no se modificarán.

Se da por supuesto que se ha llamado a create() en este búfer y que se ha vinculado al contexto actual.

Véase también create(), read() y allocate().

[noexcept, since 6.5] QOpenGLBuffer &QOpenGLBuffer::operator=(QOpenGLBuffer &&other)

La operación «move-assigns» asigna other a esta instancia de QOpenGLBuffer.

Nota: El objeto del que se realiza el traslado, other, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

Esta función se introdujo en Qt 6.5.

QOpenGLBuffer &QOpenGLBuffer::operator=(const QOpenGLBuffer &other)

Asigna una copia superficial de other a este objeto.

Nota: ` QOpenGLBuffer ` no implementa la semántica de «copia al escribir», por lo que ` other ` se verá afectado cada vez que se modifique la copia.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.