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);
}

成员函数文档

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

添加顶点属性描述。每个属性都有一个semantic ，用于指定该属性的用途及其组件数量；一个offset ，用于描述从起点经顶点到顶点内部属性位置的路径；以及一个componentType ，用于指定属性的数据类型和大小。

语义可以是以下之一：

此外，semantic 可以是IndexSemantic 。在这种情况下，该属性并不代表顶点缓冲区中的条目，而是描述索引缓冲区中的索引数据。由于每个顶点始终只有一个索引，因此offset 对于索引缓冲区而言没有意义，应保留为零。

分量类型可以是以下之一：

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

添加顶点属性描述。每个属性都有一个语义，用于指定该属性的用途及其包含的组件数量；一个从顶点起始位置到该属性在顶点内位置的偏移量；以及一个 componentType，用于指定该属性的数据类型和大小。

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

向几何体添加新的子集。子集允许使用不同的材质渲染几何体的部分区域。材质在model 中指定。

如果几何体具有索引缓冲区，则 `offset ` 和 `count ` 分别表示子集中的原始偏移量和索引数量。如果几何体仅具有顶点缓冲区，则偏移量即为顶点偏移量，计数即为子集中的顶点数量。

边界boundsMin 和boundsMax 应像几何体边界一样包围该子集。此外，子集还可以具有name 。

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

添加了变形目标属性描述。每个属性都有一个所属的targetId （目标ID），一个semantic （属性ID），用于指定该属性的用途及其包含的组件数量；一个offset （从起始点到顶点，再到顶点内属性位置的路径），以及一个stride （元素之间的字节间距）。

该函数在 Qt 6.6 中引入。

另请参阅 addAttribute 。

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

添加了变形目标属性的描述。每个属性都有一个 targetId（该属性所属的目标标识符）、一个语义（指定属性的用途及其包含的组件数量）、一个偏移量（从顶点起始位置到该属性在顶点内位置的距离），以及一个步长（元素之间的字节间隔）。

该函数在 Qt 6.6 中引入。

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

返回属性定义编号index

属性定义的编号范围为 0 到attributeCount() - 1

int QQuick3DGeometry::attributeCount() const

返回为此几何体定义的属性数量。

另请参阅 attribute 。

QVector3D QQuick3DGeometry::boundsMax() const

返回边界体积的最大坐标。

另请参阅 setBounds 。

QVector3D QQuick3DGeometry::boundsMin() const

返回包围体的最小坐标。

另请参阅 setBounds 。

void QQuick3DGeometry::clear()

将几何体重置为初始状态，清除先前设置的顶点和索引数据以及属性。

QByteArray QQuick3DGeometry::indexData() const

返回索引缓冲区数据。

另请参阅 setIndexData()。

QQuick3DGeometry::PrimitiveType QQuick3DGeometry::primitiveType() const

返回渲染时使用的基本类型。默认值为Triangles 。

另请参阅 setPrimitiveType 。

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

将几何体的包围体积设置为由点min 和max 定义的立方体。此设置用于picking 。

void QQuick3DGeometry::setIndexData(const QByteArray &data)

将索引缓冲区设置为data 。要使用索引绘制，请添加一个属性，其中包含IndexSemantic

另请参阅 indexData() 和addAttribute 。

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

更新索引缓冲区的子集。offset 指定以字节为单位的偏移量，data 指定大小和数据。

此函数不会调整缓冲区的大小。如果offset + data.size() 大于缓冲区的当前大小，超出部分的数据将被忽略。

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

将渲染所用的基本类型设置为type 。

初始值为Triangles 。

另请参阅 primitiveType()。

void QQuick3DGeometry::setStride(int stride)

将顶点缓冲区的步长设置为stride （单位为字节）。这是缓冲区中两个相邻顶点之间的距离。

例如，对于使用PositionSemantic 、IndexSemantic 和ColorSemantic 的几何体，其紧凑交错的顶点缓冲区的步长为28 （总共七个浮点数：三个用于位置，四个用于颜色，没有用于索引，因为索引不包含在顶点缓冲区中。）

另请参阅 stride() 和addAttribute 。

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

设置变形目标缓冲区data 。该缓冲区应包含所有变形目标数据。

该函数于 Qt 6.6 中引入。

另请参阅 targetData() 和addTargetAttribute 。

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

更新形态目标缓冲区的一部分。offset 指定以字节为单位的偏移量，data 指定数据的大小和数据内容。

此函数不会调整缓冲区的大小。如果offset + data.size() 大于缓冲区的当前大小，则超出部分的数据将被忽略。

该函数在 Qt 6.6 中引入。

void QQuick3DGeometry::setVertexData(const QByteArray &data)

设置顶点缓冲区data 。该缓冲区应包含数组中打包的所有顶点数据，具体格式由属性定义规定。请注意，这不包括IndexSemantic 属性的数据，这些数据应存放在索引缓冲区中。

另请参阅 vertexData()、addAttribute 、setStride 以及setIndexData 。

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

更新顶点缓冲区的子集。offset 指定以字节为单位的偏移量，data 指定大小和数据。

此函数不会调整缓冲区的大小。如果 `offset + data.size() ` 大于缓冲区的当前大小，超出部分的数据将被忽略。

int QQuick3DGeometry::stride() const

返回顶点缓冲区的字节步长。

另请参阅 setStride 。

QVector3D QQuick3DGeometry::subsetBoundsMax(int subset) const

返回subset 的最大边界数。

另请参阅 subsetBoundsMin 。

QVector3D QQuick3DGeometry::subsetBoundsMin(int subset) const

返回subset 的最小边界个数。

另请参阅 subsetBoundsMax 。

int QQuick3DGeometry::subsetCount() const

返回子集的个数。

int QQuick3DGeometry::subsetCount(int subset) const

返回子集的基元个数。

另请参阅 subsetOffset 。

QString QQuick3DGeometry::subsetName(int subset) const

返回subset 的名称。

int QQuick3DGeometry::subsetOffset(int subset) const

返回顶点或索引缓冲区中subset 的偏移量。

另请参阅 subsetCount 。

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

返回形态目标属性定义编号index

属性定义的编号范围为 0 到attributeCount() - 1

该函数于 Qt 6.6 中引入。

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

返回为此几何体定义的变形目标属性的数量。

该函数于 Qt 6.6 中引入。

另请参阅 targetAttribute 。

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

返回由setTargetData 设置的目标缓冲区数据。

该函数自 Qt 6.6 起引入。

另请参阅 setTargetData()。

QByteArray QQuick3DGeometry::vertexData() const

返回由setVertexData 设置的顶点缓冲区数据。

另请参阅 setVertexData()。