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も参照してください 。