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