QQuick3DGeometry Class

class CustomGeometry : public QQuick3DGeometry
{
public:
    CustomGeometry() { rebuildGeometry(); }

    void setSomething() {
       // Change relevant internal data.
       // ...

       // Then rebuild the vertex and index data and pass it to QQuick3DGeometry.
       rebuildGeometry();

       // Finally, trigger an update. This is relevant in case nothing else
       // is changing in the scene; this way we make sure a new frame will
       // be rendered.
       update();
    }

private:
    void rebuildGeometry()
    {
        QByteArray vertices;
        QByteArray indices;
        ...
        setPrimitiveType(Lines);
        setVertexBuffer(vertices);
        setIndexBuffer(indices);
        setStride(3 * sizeof(float)); // e.g. when having 3 components per vertex
        setBounds(...); // minimum and maximum extents, for picking
        addAttribute(PositionSemantic, 0, F32Type);
        ...
    }
};

qmlRegisterType<CustomGeometry>("Example", 1, 0, "CustomGeometry");

CONFIG += qmltypes
QML_IMPORT_NAME = Example
QML_IMPORT_MAJOR_VERSION = 1

qt_add_qml_module(application
    URI Example
    VERSION 1.0
)

class CustomGeometry : public QQuick3DGeometry
{
    Q_OBJECT
    QML_NAMED_ELEMENT(CustomGeometry)
    ...
};

import Example 1.0

Model {
    id: customModel
    geometry: CustomGeometry {
    }
}

class ExampleGeometry : public QQuick3DGeometry
{
    Q_OBJECT
    QML_NAMED_ELEMENT(ExampleGeometry)

public:
    ExampleGeometry();

private:
    void updateData();
};

ExampleGeometry::ExampleGeometry()
{
    updateData();
}

void ExampleGeometry::updateData()
{
    QByteArray v;
    v.resize(3 * 3 * sizeof(float));
    float *p = reinterpret_cast<float *>(v.data());

    // a triangle, front face = counter-clockwise
    *p++ = -1.0f; *p++ = -1.0f; *p++ = 0.0f;
    *p++ = 1.0f; *p++ = -1.0f; *p++ = 0.0f;
    *p++ = 0.0f; *p++ = 1.0f; *p++ = 0.0f;

    setVertexData(v);
    setStride(3 * sizeof(float));

    setPrimitiveType(QQuick3DGeometry::PrimitiveType::Triangles);

    addAttribute(QQuick3DGeometry::Attribute::PositionSemantic,
                 0,
                 QQuick3DGeometry::Attribute::F32Type);
}

Documentación de las funciones miembro

void QQuick3DGeometry::addAttribute(QQuick3DGeometry::Attribute::Semantic semantic, int offset, QQuick3DGeometry::Attribute::ComponentType componentType)

Añade la descripción de los atributos de los vértices. Cada atributo tiene un semantic, que especifica el uso del atributo y el número de componentes que tiene, un offset desde el inicio hasta el vértice hasta la ubicación del atributo dentro de un vértice y un componentType que especifica el tipo de dato y el tamaño del atributo.

La semántica puede ser una de las siguientes

Además, semantic puede ser IndexSemantic. En este caso, el atributo no representa una entrada en la memoria intermedia de vértices, sino que describe los datos del índice en la memoria intermedia de índices. Dado que siempre hay un único índice por vértice, offset no tiene sentido para la memoria intermedia de índices y debe dejarse a cero.

El tipo de componente puede ser uno de los siguientes:

void QQuick3DGeometry::addAttribute(const QQuick3DGeometry::Attribute &attribute)

Añade la descripción de atributos de vértice. Cada atributo tiene una semántica, que especifica el uso del atributo y el número de componentes que tiene, un desplazamiento desde el inicio hasta el vértice hasta la ubicación del atributo dentro de un vértice y un componentType que especifica el tipo de datos y el tamaño del atributo.

void QQuick3DGeometry::addSubset(int offset, int count, const QVector3D &boundsMin, const QVector3D &boundsMax, const QString &name = {})

Añade un nuevo subconjunto a la geometría. Los subconjuntos permiten renderizar partes de la geometría con diferentes materiales. Los materiales se especifican en model.

Si la geometría tiene un búfer de índices, entonces offset y count son el desplazamiento primitivo y el recuento de índices en el subconjunto. Si la geometría sólo tiene búfer de vértices, el desplazamiento es el desplazamiento de vértices y el recuento es el número de vértices del subconjunto.

Los límites boundsMin y boundsMax deben encerrar el subconjunto igual que los límites de la geometría. Además, el subconjunto puede tener un name.

[since 6.6] void QQuick3DGeometry::addTargetAttribute(quint32 targetId, QQuick3DGeometry::Attribute::Semantic semantic, int offset, int stride = 0)

Añade la descripción del atributo morph target. Cada atributo tiene un targetId al que pertenece el atributo, un semantic, que especifica el uso del atributo y el número de componentes que tiene, un offset desde el inicio hasta el vértice hasta la ubicación del atributo dentro de un vértice, y un stride que es un tamaño de byte entre los elementos.

Esta función se introdujo en Qt 6.6.

Véase también addAttribute.

[since 6.6] void QQuick3DGeometry::addTargetAttribute(const QQuick3DGeometry::TargetAttribute &attribute)

Añade la descripción del atributo target morph. Cada atributo tiene un targetId al que pertenece el atributo, una semántica, que especifica el uso del atributo y el número de componentes que tiene, un offset desde el inicio al vértice a la localización del atributo dentro de un vértice, y un stride que es un tamaño de byte entre los elementos.

Esta función se introdujo en Qt 6.6.

QQuick3DGeometry::Attribute QQuick3DGeometry::attribute(int index) const

Devuelve el número de definición del atributo index

Las definiciones de atributos se numeran de 0 a attributeCount() - 1

int QQuick3DGeometry::attributeCount() const

Devuelve el número de atributos definidos para esta geometría.

Véase también attribute.

QVector3D QQuick3DGeometry::boundsMax() const

Devuelve la coordenada máxima del volumen delimitador.

Véase también setBounds.

QVector3D QQuick3DGeometry::boundsMin() const

Devuelve la coordenada mínima del volumen delimitador.

Véase también setBounds.

void QQuick3DGeometry::clear()

Restablece la geometría a su estado inicial, borrando los datos de vértices e índices previamente configurados, así como los atributos.

QByteArray QQuick3DGeometry::indexData() const

Devuelve los datos del búfer de índice.

Véase también setIndexData().

QQuick3DGeometry::PrimitiveType QQuick3DGeometry::primitiveType() const

Devuelve el tipo primitivo utilizado al renderizar. Por defecto es Triangles.

Véase también setPrimitiveType.

void QQuick3DGeometry::setBounds(const QVector3D &min, const QVector3D &max)

Establece el volumen límite de la geometría en el cubo definido por los puntos min y max. Se utiliza para picking.

void QQuick3DGeometry::setIndexData(const QByteArray &data)

Establece el búfer de índice en data. Para utilizar el dibujo indexado, añada un atributo con IndexSemantic

Véase también indexData() y addAttribute.

void QQuick3DGeometry::setIndexData(int offset, const QByteArray &data)

Actualiza un subconjunto del búfer de índice. offset especifica el desplazamiento en bytes, data especifica el tamaño y los datos.

Esta función no redimensionará el búfer. Si offset + data.size() es mayor que el tamaño actual del buffer, los datos sobrepasados serán ignorados.

void QQuick3DGeometry::setPrimitiveType(QQuick3DGeometry::PrimitiveType type)

Establece el tipo primitivo utilizado para el renderizado en type.

El valor inicial es Triangles.

Véase también primitiveType().

void QQuick3DGeometry::setStride(int stride)

Establece el stride del búfer de vértices en stride, medido en bytes. Esta es la distancia entre dos vértices consecutivos en el búfer.

Por ejemplo, un búfer de vértices intercalado y apretado para una geometría que utilice PositionSemantic, IndexSemantic, y ColorSemantic tendrá un stride de 28 (Siete flotantes en total: tres para la posición, cuatro para el color y ninguno para los índices, que no van en el búfer de vértices).

Véase también stride() y addAttribute.

[since 6.6] void QQuick3DGeometry::setTargetData(const QByteArray &data)

Establece el búfer del objetivo morph data. El buffer debe contener todos los datos del objetivo morph.

Esta función fue introducida en Qt 6.6.

Ver también targetData() y addTargetAttribute.

[since 6.6] void QQuick3DGeometry::setTargetData(int offset, const QByteArray &data)

Actualiza un subconjunto del búfer de destino de morph. offset especifica el desplazamiento en bytes, data especifica el tamaño y los datos.

Esta función no redimensionará el buffer. Si offset + data.size() es mayor que el tamaño actual del buffer, los datos sobrepasados serán ignorados.

Esta función se introdujo en Qt 6.6.

void QQuick3DGeometry::setVertexData(const QByteArray &data)

Establece el búfer de vértices data. El búfer debe contener todos los datos de vértice empaquetados en la matriz, como se describe en las definiciones de atributos. Ten en cuenta que esto no incluye los atributos con IndexSemantic, que pertenecen al búfer de índice.

Véase también vertexData(), addAttribute, setStride, y setIndexData.

void QQuick3DGeometry::setVertexData(int offset, const QByteArray &data)

Actualiza un subconjunto del búfer de vértices. offset especifica el desplazamiento en bytes, data especifica el tamaño y los datos.

Esta función no redimensionará el buffer. Si offset + data.size() es mayor que el tamaño actual del buffer, los datos sobrepasados serán ignorados.

int QQuick3DGeometry::stride() const

Devuelve la longitud en bytes del búfer de vértices.

Véase también setStride.

QVector3D QQuick3DGeometry::subsetBoundsMax(int subset) const

Devuelve el número de límites máximos de un subset.

Véase también subsetBoundsMin.

QVector3D QQuick3DGeometry::subsetBoundsMin(int subset) const

Devuelve el número de límites mínimos de un subset.

Véase también subsetBoundsMax.

int QQuick3DGeometry::subsetCount() const

Devuelve el número de subconjuntos.

int QQuick3DGeometry::subsetCount(int subset) const

Devuelve el recuento de primitivas de subconjunto.

Véase también subsetOffset.

QString QQuick3DGeometry::subsetName(int subset) const

Devuelve el nombre de subset.

int QQuick3DGeometry::subsetOffset(int subset) const

Devuelve el desplazamiento subset a la memoria intermedia de vértices o índices.

Véase también subsetCount.

[since 6.6] QQuick3DGeometry::TargetAttribute QQuick3DGeometry::targetAttribute(int index) const

Devuelve el número de definición del atributo de destino morph index

Las definiciones de atributos se numeran de 0 a attributeCount() - 1

Esta función se introdujo en Qt 6.6.

[since 6.6] int QQuick3DGeometry::targetAttributeCount() const

Devuelve el número de atributos de objetivo morph definidos para esta geometría.

Esta función se introdujo en Qt 6.6.

Véase también targetAttribute.

[since 6.6] QByteArray QQuick3DGeometry::targetData() const

Devuelve los datos del búfer de destino establecidos por setTargetData.

Esta función se introdujo en Qt 6.6.

Véase también setTargetData().

QByteArray QQuick3DGeometry::vertexData() const

Devuelve los datos del búfer de vértices establecidos por setVertexData.

Véase también setVertexData().