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도 참조하십시오 .