QSGGeometry Class

struct MyPoint2D {
    float x;
    float y;
    float r;
    float g;
    float b;
    float a;

    void set(float x_, float y_, float r_, float g_, float b_, float a_) {
        x = x_;
        y = y_;
        r = r_;
        g = g_;
        b = b_;
        a = a_;
    }
};

QSGGeometry::Attribute MyPoint2D_Attributes[] = {
    QSGGeometry::Attribute::create(0, 2, FloatType, true),
    QSGGeometry::Attribute::create(1, 4, FloatType, false)
};

QSGGeometry::AttributeSet MyPoint2D_AttributeSet = {
    2,
    sizeof(MyPoint2D),
    MyPoint2D_Attributes
};

...

geometry = new QSGGeometry(MyPoint2D_AttributeSet, 2);
geometry->setDrawingMode(DrawLines);

MyPoint2D *vertices = static_cast<MyPoint2D *>(geometry->vertexData());
vertices[0].set(0, 0, 1, 0, 0, 1);
vertices[1].set(width(), height(), 0, 0, 1, 1);

Documentación de la Función Miembro

QSGGeometry::QSGGeometry(const QSGGeometry::AttributeSet &attributes, int vertexCount, int indexCount = 0, int indexType = UnsignedShortType)

Construye un objeto geométrico basado en attributes.

El objeto asigna espacio para vertexCount vértices basado en el tamaño acumulado en attributes y para indexCount.

El indexType puede ser UnsignedShortType o UnsignedIntType. El soporte para este último depende de la implementación de la API gráfica utilizada en tiempo de ejecución, y puede no estar siempre disponible.

Los objetos geométricos se construyen por defecto con DrawTriangleStrip como modo de dibujo.

[virtual noexcept] QSGGeometry::~QSGGeometry()

Destruye el objeto geométrico y los datos de vértices e índices que tiene asignados.

void QSGGeometry::allocate(int vertexCount, int indexCount = 0)

Redimensiona los datos de vértices e índices de este objeto geométrico para que quepan vertexCount vértices y indexCount índices y establece el número de vértices e índices en consecuencia.

Utilice setVertexCount() o setIndexCount() para cambiar el número de vértices o índices sin volver a llamar a allocate().

Los datos de vértices e índices serán invalidados después de esta llamada y el invocador debe marcar el nodo geométrico asociado como sucio, llamando a node->markDirty(QSGNode::DirtyGeometry), para asegurar que el renderizador tiene la oportunidad de actualizar los buffers internos.

Véase también setVertexCount() y setIndexCount().

int QSGGeometry::attributeCount() const

Devuelve el número de atributos del conjunto de atributos utilizado por esta geometría.

const QSGGeometry::Attribute *QSGGeometry::attributes() const

Devuelve una matriz con los atributos de esta geometría. El tamaño de la matriz se indica con attributeCount().

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_ColoredPoint2D()

Función de conveniencia que devuelve atributos que se utilizarán para el dibujo 2D coloreado por vértice.

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_Point2D()

Función de conveniencia que devuelve atributos que se utilizarán para dibujar colores sólidos en 2D.

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_TexturedPoint2D()

Función de conveniencia que devuelve atributos que se utilizarán para el dibujo 2D texturizado.

unsigned int QSGGeometry::drawingMode() const

Devuelve el modo de dibujo de esta geometría.

El valor por defecto es DrawTriangleStrip.

Véase también setDrawingMode().

int QSGGeometry::indexCount() const

Devuelve el número de índices que se procesan cuando se renderiza el objeto geométrico.

Véase también setIndexCount().

void *QSGGeometry::indexData()

Devuelve un puntero a los datos de índice sin procesar de este objeto geométrico.

Véase también indexDataAsUShort() y indexDataAsUInt().

const void *QSGGeometry::indexData() const

Devuelve un puntero a los datos de índice sin procesar de este objeto geométrico.

Véase también indexDataAsUShort() y indexDataAsUInt().

uint *QSGGeometry::indexDataAsUInt()

Función de conveniencia para acceder a los datos de índice como una matriz mutable de enteros de 32 bits sin signo.

const uint *QSGGeometry::indexDataAsUInt() const

Función de conveniencia para acceder a los datos de índice como una matriz inmutable de enteros de 32 bits sin signo.

quint16 *QSGGeometry::indexDataAsUShort()

Función de conveniencia para acceder a los datos de índice como una matriz mutable de enteros de 16 bits sin signo.

const quint16 *QSGGeometry::indexDataAsUShort() const

Función de conveniencia para acceder a los datos de índice como una matriz inmutable de enteros de 16 bits sin signo.

QSGGeometry::DataPattern QSGGeometry::indexDataPattern() const

Devuelve el patrón de uso de los índices en esta geometría. El patrón por defecto es AlwaysUploadPattern.

Véase también setIndexDataPattern().

int QSGGeometry::indexType() const

Devuelve el tipo primitivo utilizado para los índices en este objeto geométrico.

float QSGGeometry::lineWidth() const

Obtiene el ancho de línea o de punto actual o que se utilizará para esta geometría. Esta propiedad sólo se aplica a la anchura de línea cuando drawingMode es DrawLines o DrawLineStrip. Cuando se admite, también se aplica al tamaño de punto cuando drawingMode es DrawPoints.

El valor por defecto es 1.0

Véase también setLineWidth() y drawingMode().

void QSGGeometry::markIndexDataDirty()

Marca que los vértices de esta geometría han cambiado y deben cargarse de nuevo.

Esta función sólo tiene efecto cuando el patrón de uso de los vértices es StaticData y el renderizador que renderiza esta geometría carga la geometría en Vertex Buffer Objects (VBOs).

void QSGGeometry::markVertexDataDirty()

Marca que los vértices de esta geometría han cambiado y deben cargarse de nuevo.

Esta función sólo tiene efecto cuando el patrón de uso de los vértices es StaticData y el renderizador que renderiza esta geometría carga la geometría en Vertex Buffer Objects (VBOs).

void QSGGeometry::setDrawingMode(unsigned int mode)

Establece la dirección mode que se utilizará para dibujar esta geometría.

El valor por defecto es QSGGeometry::DrawTriangleStrip.

Véase también drawingMode() y DrawingMode.

[since 6.10] void QSGGeometry::setIndexCount(int count)

Establece el número de índices que se procesarán cada vez que se renderice el objeto geométrico.

La dirección count no se valida y es responsabilidad del usuario asegurarse de que sólo se especifican valores comprendidos entre cero y el número de índices asignados.

Los datos de vértices e índices no se invalidan después de esta llamada, pero el que llama debe marcar el nodo de geometría como sucio, llamando a node->markDirty(QSGNode::DirtyGeometry), para asegurarse de que el renderizador tiene la oportunidad de actualizar los buffers internos.

Esta función se introdujo en Qt 6.10.

Véase también indexCount().

void QSGGeometry::setIndexDataPattern(QSGGeometry::DataPattern p)

Establece el patrón de uso de los índices en p.

El valor por defecto es AlwaysUploadPattern. Cuando se establece a cualquier otro valor que no sea el predeterminado, el usuario debe llamar a markIndexDataDirty() después de cambiar los datos del índice, además de llamar a QSGNode::markDirty() con QSGNode::DirtyGeometry.

Véase también indexDataPattern().

void QSGGeometry::setLineWidth(float width)

Establece la anchura de línea o de punto que se utilizará para esta geometría en width. Esta propiedad sólo se aplica a la anchura de línea cuando drawingMode es DrawLines o DrawLineStrip. Cuando se admite, también se aplica al tamaño de punto cuando drawingMode es DrawPoints.

Véase también lineWidth() y drawingMode().

[since 6.10] void QSGGeometry::setVertexCount(int count)

Establece el número de vértices a renderizar.

count no se valida y es responsabilidad del usuario asegurarse de que sólo se especifican valores entre cero y el número de vértices asignados.

Los datos de vértices no se invalidan después de esta llamada, pero el llamador debe marcar el nodo de geometría como sucio, llamando a node->markDirty(QSGNode::DirtyGeometry), para asegurarse de que el renderizador tiene la oportunidad de actualizar los buffers internos.

Esta función se introdujo en Qt 6.10.

Véase también vertexCount().

void QSGGeometry::setVertexDataPattern(QSGGeometry::DataPattern p)

Establece el patrón de uso de los vértices en p.

El valor por defecto es AlwaysUploadPattern. Cuando se establece a cualquier otro valor que no sea el predeterminado, el usuario debe llamar a markVertexDataDirty() después de cambiar los datos de vértice, además de llamar a QSGNode::markDirty() con QSGNode::DirtyGeometry.

Véase también vertexDataPattern().

int QSGGeometry::sizeOfIndex() const

Devuelve el tamaño en bytes del tipo de índice.

Este valor es 2 cuando el tipo de índice es UnsignedShortType, o 4 cuando el tipo de índice es UnsignedIntType.

int QSGGeometry::sizeOfVertex() const

Devuelve el tamaño en bytes de un vértice.

Este valor procede de los atributos.

[static] void QSGGeometry::updateColoredRectGeometry(QSGGeometry *g, const QRectF &rect)

Actualiza la geometría g con las coordenadas en rect.

La función asume que el objeto de geometría contiene una única tira triangular de vértices QSGGeometry::ColoredPoint2D

[static] void QSGGeometry::updateRectGeometry(QSGGeometry *g, const QRectF &rect)

Actualiza la geometría g con las coordenadas en rect.

La función asume que el objeto de geometría contiene una única tira triangular de vértices QSGGeometry::Point2D

[static] void QSGGeometry::updateTexturedRectGeometry(QSGGeometry *g, const QRectF &rect, const QRectF &textureRect)

Actualiza la geometría g con las coordenadas en rect y las coordenadas de textura de textureRect.

textureRect debe estar en coordenadas normalizadas.

g se supone que es una tira triangular de cuatro vértices de tipo QSGGeometry::TexturedPoint2D.

int QSGGeometry::vertexCount() const

Devuelve el número de vértices que se pueden renderizar, o si se utilizan índices, devuelve el número de vértices a los que se puede acceder a través de índices.

Véase también setVertexCount().

void *QSGGeometry::vertexData()

Devuelve un puntero a los datos de vértice sin procesar de este objeto geométrico.

Véase también vertexDataAsPoint2D() y vertexDataAsTexturedPoint2D().

const void *QSGGeometry::vertexData() const

Devuelve un puntero a los datos de vértice sin procesar de este objeto geométrico.

Véase también vertexDataAsPoint2D() y vertexDataAsTexturedPoint2D().

QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D()

Función de conveniencia para acceder a los datos de vértice como una matriz mutable de QSGGeometry::ColoredPoint2D.

const QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D() const

Función de conveniencia para acceder a los datos de vértice como una matriz inmutable de QSGGeometry::ColoredPoint2D.

QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D()

Función de conveniencia para acceder a los datos de vértice como una matriz mutable de QSGGeometry::Point2D.

const QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D() const

Función de conveniencia para acceder a los datos de vértice como una matriz inmutable de QSGGeometry::Point2D.

QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D()

Función de conveniencia para acceder a los datos de vértice como una matriz mutable de QSGGeometry::TexturedPoint2D.

const QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D() const

Función de conveniencia para acceder a los datos de vértice como una matriz inmutable de QSGGeometry::TexturedPoint2D.

QSGGeometry::DataPattern QSGGeometry::vertexDataPattern() const

Devuelve el patrón de uso de los vértices de esta geometría. El patrón por defecto es AlwaysUploadPattern.

Véase también setVertexDataPattern().