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 을참조하세요 .