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 。