QQuick3DInstancing Class

成员函数文档

[static protected] QQuick3DInstancing::InstanceTableEntry QQuick3DInstancing::calculateTableEntry(const QVector3D &position, const QVector3D &scale, const QVector3D &eulerRotation, const QColor &color, const QVector4D &customData = {})

将position 、scale 、eulerRotation 、color 和customData 转换为标准顶点着色器所期望的实例表格式。典型示例：

QByteArray MyInstanceTable::getInstanceBuffer(int *instanceCount)
{
    QByteArray instanceData;

    ...

    auto entry = calculateTableEntry({xPos, yPos, zPos}, {xScale, yScale, zScale}, {xRot, yRot, zRot}, color, {});
    instanceData.append(reinterpret_cast<const char *>(&entry), sizeof(entry));

另请参阅 calculateTableEntryFromQuaternion 。

[static protected] QQuick3DInstancing::InstanceTableEntry QQuick3DInstancing::calculateTableEntryFromQuaternion(const QVector3D &position, const QVector3D &scale, const QQuaternion &rotation, const QColor &color, const QVector4D &customData = {})

将position 、scale 、rotation 、color 和customData 转换为标准顶点着色器所期望的实例表格式。

这与calculateTableEntry() 相同，只是使用四元数来指定旋转。

[pure virtual protected] QByteArray QQuick3DInstancing::getInstanceBuffer(int *instanceCount)

实现此函数以返回实例表的内容。实例的数量应通过instanceCount 返回。子类负责在必要时缓存结果。如果实例表发生变化，子类应调用markDirty()。

[protected] void QQuick3DInstancing::markDirty()

请注意，实例数据已发生变化，必须重新上传。

另请参阅 getInstanceBuffer 和instanceCountOverride 。