QQuick3DInstancing类

成员函数文档

[静态受保护] QQuick3DInstancing::InstanceTableEntry QQuick3DInstancing::calculateTableEntry(const QVector3D &position, const QVector3D &scale, const QVector3D &eulerRotation, const QColor &color, const QVector4D &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.

[静态受保护] QQuick3DInstancing::InstanceTableEntry QQuick3DInstancing::calculateTableEntryFromQuaternion(const QVector3D &position, const QVector3D &scale, const QQuaternion &rotation, const QColor &color, const QVector4D &customData = {})

将位置 比例 旋转 颜色 和 自定义数据 转换为标准顶点着色器预期的实例表格式。

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

[纯虚保护] QByteArray QQuick3DInstancing::getInstanceBuffer(int *instanceCount)

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

[保护] void QQuick3DInstancing::markDirty()

标记实例数据已更改，必须重新上传。

另请参阅 getInstanceBuffer 和 instanceCountOverride.