QQuick3DGeometry Class

class CustomGeometry : public QQuick3DGeometry
{
public:
    CustomGeometry() { rebuildGeometry(); }

    void setSomething() {
       // Change relevant internal data.
       // ...

       // Then rebuild the vertex and index data and pass it to QQuick3DGeometry.
       rebuildGeometry();

       // Finally, trigger an update. This is relevant in case nothing else
       // is changing in the scene; this way we make sure a new frame will
       // be rendered.
       update();
    }

private:
    void rebuildGeometry()
    {
        QByteArray vertices;
        QByteArray indices;
        ...
        setPrimitiveType(Lines);
        setVertexBuffer(vertices);
        setIndexBuffer(indices);
        setStride(3 * sizeof(float)); // e.g. when having 3 components per vertex
        setBounds(...); // minimum and maximum extents, for picking
        addAttribute(PositionSemantic, 0, F32Type);
        ...
    }
};

qmlRegisterType<CustomGeometry>("Example", 1, 0, "CustomGeometry");

CONFIG += qmltypes
QML_IMPORT_NAME = Example
QML_IMPORT_MAJOR_VERSION = 1

qt_add_qml_module(application
    URI Example
    VERSION 1.0
)

class CustomGeometry : public QQuick3DGeometry
{
    Q_OBJECT
    QML_NAMED_ELEMENT(CustomGeometry)
    ...
};

import Example 1.0

Model {
    id: customModel
    geometry: CustomGeometry {
    }
}

class ExampleGeometry : public QQuick3DGeometry
{
    Q_OBJECT
    QML_NAMED_ELEMENT(ExampleGeometry)

public:
    ExampleGeometry();

private:
    void updateData();
};

ExampleGeometry::ExampleGeometry()
{
    updateData();
}

void ExampleGeometry::updateData()
{
    QByteArray v;
    v.resize(3 * 3 * sizeof(float));
    float *p = reinterpret_cast<float *>(v.data());

    // a triangle, front face = counter-clockwise
    *p++ = -1.0f; *p++ = -1.0f; *p++ = 0.0f;
    *p++ = 1.0f; *p++ = -1.0f; *p++ = 0.0f;
    *p++ = 0.0f; *p++ = 1.0f; *p++ = 0.0f;

    setVertexData(v);
    setStride(3 * sizeof(float));

    setPrimitiveType(QQuick3DGeometry::PrimitiveType::Triangles);

    addAttribute(QQuick3DGeometry::Attribute::PositionSemantic,
                 0,
                 QQuick3DGeometry::Attribute::F32Type);
}

멤버 함수 문서

void QQuick3DGeometry::addAttribute(QQuick3DGeometry::Attribute::Semantic semantic, int offset, QQuick3DGeometry::Attribute::ComponentType componentType)

정점 속성 설명을 추가합니다. 각 속성에는 속성의 용도와 구성 요소 수를 명시하는 속성 설명( semantic), 시작점에서 정점을 거쳐 정점 내 속성 위치까지 이어지는 경로( offset ), 그리고 속성의 데이터 유형과 크기를 명시하는 속성 데이터( componentType )가 있습니다.

의미(semantic)는 다음 중 하나일 수 있습니다:

또한, ` semantic `는 ` IndexSemantic`일 수 있습니다. 이 경우 해당 속성은 버텍스 버퍼의 항목을 나타내는 것이 아니라, 인덱스 버퍼의 인덱스 데이터를 기술합니다. 버텍스당 인덱스는 항상 하나뿐이므로, ` offset `는 인덱스 버퍼에서는 의미가 없으며 0으로 남겨두어야 합니다.

컴포넌트 유형은 다음 중 하나일 수 있습니다:

void QQuick3DGeometry::addAttribute(const QQuick3DGeometry::Attribute &attribute)

버텍스 속성 설명을 추가합니다. 각 속성에는 속성의 용도와 구성 요소 수를 지정하는 ‘semantic’, 버텍스 시작 지점부터 속성 위치까지의 오프셋, 그리고 속성의 데이터 유형과 크기를 지정하는 ‘componentType’이 있습니다.

void QQuick3DGeometry::addSubset(int offset, int count, const QVector3D &boundsMin, const QVector3D &boundsMax, const QString &name = {})

지오메트리에 새로운 하위 집합을 추가합니다. 하위 집합을 사용하면 지오메트리의 일부를 서로 다른 머티리얼로 렌더링할 수 있습니다. 머티리얼은 model 에서 지정됩니다.

지오메트리에 인덱스 버퍼가 있는 경우, ` offset `와 ` count `는 서브셋 내의 인덱스 오프셋과 개수를 나타냅니다. 지오메트리에 버텍스 버퍼만 있는 경우, 오프셋은 버텍스 오프셋이며 개수는 서브셋 내의 버텍스 수를 의미합니다.

경계 boundsMin 및 boundsMax 는 지오메트리 경계와 마찬가지로 부분 집합을 둘러싸야 합니다. 또한 부분 집합에는 name 가 있을 수 있습니다.

[since 6.6] void QQuick3DGeometry::addTargetAttribute(quint32 targetId, QQuick3DGeometry::Attribute::Semantic semantic, int offset, int stride = 0)

모프 타겟 속성 설명을 추가합니다. 각 속성에는 해당 속성이 속한 targetId, 속성의 용도와 구성 요소 수를 지정하는 semantic, 시작점부터 정점을 거쳐 정점 내 속성 위치까지의 경로인 offset, 그리고 요소들 사이의 바이트 크기를 나타내는 stride 가 있습니다.

이 함수는 Qt 6.6에서 도입되었습니다.

addAttribute도 참조하십시오 .

[since 6.6] void QQuick3DGeometry::addTargetAttribute(const QQuick3DGeometry::TargetAttribute &attribute)

모프 타깃 속성 설명을 추가합니다. 각 속성에는 해당 속성이 속한 targetId, 속성의 용도와 구성 요소 수를 지정하는 시맨틱, 정점 시작 부분부터 속성이 위치한 정점 내 위치까지의 오프셋, 그리고 요소들 사이의 바이트 단위 간격인 스트라이드가 포함됩니다.

이 함수는 Qt 6.6에서 도입되었습니다.

QQuick3DGeometry::Attribute QQuick3DGeometry::attribute(int index) const

속성 정의 번호를 반환합니다 index

속성 정의에는 0부터 attributeCount() - 1

int QQuick3DGeometry::attributeCount() const

이 지오메트리에 정의된 속성의 개수를 반환합니다.

attribute도 참조하십시오 .

QVector3D QQuick3DGeometry::boundsMax() const

바운딩 볼륨의 최대 좌표를 반환합니다.

setBounds도 참조하십시오 .

QVector3D QQuick3DGeometry::boundsMin() const

바운딩 볼륨의 최소 좌표를 반환합니다.

setBounds도 참조하십시오 .

void QQuick3DGeometry::clear()

지오메트리를 초기 상태로 재설정하며, 이전에 설정된 정점 및 인덱스 데이터와 속성을 모두 지웁니다.

QByteArray QQuick3DGeometry::indexData() const

인덱스 버퍼 데이터를 반환합니다.

setIndexData()도 참조하십시오 .

QQuick3DGeometry::PrimitiveType QQuick3DGeometry::primitiveType() const

렌더링 시 사용되는 기본 데이터형을 반환합니다. 기본값은 ` Triangles`입니다.

setPrimitiveType도 참조하십시오 .

void QQuick3DGeometry::setBounds(const QVector3D &min, const QVector3D &max)

지오메트리의 경계 볼륨을 점 min 및 max 로 정의된 큐브로 설정합니다. 이는 picking 에 사용됩니다.

void QQuick3DGeometry::setIndexData(const QByteArray &data)

인덱스 버퍼를 data 로 설정합니다. 인덱스 기반 그리기를 사용하려면 다음 속성을 추가하십시오. IndexSemantic

indexData() 및 addAttribute도 참조하십시오 .

void QQuick3DGeometry::setIndexData(int offset, const QByteArray &data)

인덱스 버퍼의 일부를 업데이트합니다. ` offset `는 바이트 단위의 오프셋을, ` data `는 크기와 데이터를 지정합니다.

이 함수는 버퍼의 크기를 조정하지 않습니다. offset + data.size() 가 버퍼의 현재 크기보다 큰 경우, 초과되는 데이터는 무시됩니다.

void QQuick3DGeometry::setPrimitiveType(QQuick3DGeometry::PrimitiveType type)

렌더링에 사용되는 기본 유형을 ` type`로 설정합니다.

초기 값은 Triangles 입니다.

primitiveType()도 참조하십시오 .

void QQuick3DGeometry::setStride(int stride)

버텍스 버퍼의 스트라이드를 stride(바이트 단위)로 설정합니다. 이는 버퍼 내 두 연속된 버텍스 사이의 거리입니다.

예를 들어, PositionSemantic, IndexSemantic, ColorSemantic 을 사용하는 지오메트리에 대한 밀집된 인터리브형 버텍스 버퍼의 스트라이드는 28 가 됩니다(총 7개의 부동소수점 수치: 위치에 3개, 색상에 4개, 인덱스는 버텍스 버퍼에 포함되지 않으므로 0개).

stride() 및 addAttribute도 참조하십시오 .

[since 6.6] void QQuick3DGeometry::setTargetData(const QByteArray &data)

모프 타겟 버퍼 data 를 설정합니다. 이 버퍼에는 모든 모프 타겟 데이터가 포함되어야 합니다.

이 함수는 Qt 6.6에서 도입되었습니다.

targetData() 및 addTargetAttribute도 참조하십시오 .

[since 6.6] void QQuick3DGeometry::setTargetData(int offset, const QByteArray &data)

모프 타깃 버퍼의 일부를 업데이트합니다. ` offset `는 바이트 단위의 오프셋을 지정하고, ` data `는 크기와 데이터를 지정합니다.

이 함수는 버퍼의 크기를 조정하지 않습니다. offset + data.size() 가 버퍼의 현재 크기보다 큰 경우, 초과되는 데이터는 무시됩니다.

이 함수는 Qt 6.6에서 도입되었습니다.

void QQuick3DGeometry::setVertexData(const QByteArray &data)

버텍스 버퍼 data 를 설정합니다. 이 버퍼에는 속성 정의에 명시된 대로 배열에 압축된 모든 버텍스 데이터가 포함되어야 합니다. 단, 인덱스 버퍼에 속하는 IndexSemantic 속성은 여기에 포함되지 않는다는 점에 유의하십시오.

vertexData(), addAttribute, setStride 및 setIndexData도 참조하십시오 .

void QQuick3DGeometry::setVertexData(int offset, const QByteArray &data)

버텍스 버퍼의 일부를 업데이트합니다. ` offset `는 바이트 단위의 오프셋을 지정하고, ` data `는 크기와 데이터를 지정합니다.

이 함수는 버퍼의 크기를 조정하지 않습니다. offset + data.size() 가 버퍼의 현재 크기보다 크면, 초과된 데이터는 무시됩니다.

int QQuick3DGeometry::stride() const

버텍스 버퍼의 바이트 스트라이드를 반환합니다.

setStride도 참조하십시오 .

QVector3D QQuick3DGeometry::subsetBoundsMax(int subset) const

subset 의 최대 경계 개수를 반환합니다.

subsetBoundsMin도 참조하십시오 .

QVector3D QQuick3DGeometry::subsetBoundsMin(int subset) const

subset 의 최소 경계 개수를 반환합니다.

subsetBoundsMax도 참조하십시오 .

int QQuick3DGeometry::subsetCount() const

부분 집합의 개수를 반환합니다.

int QQuick3DGeometry::subsetCount(int subset) const

부분 집합 프리미티브의 개수를 반환합니다.

subsetOffset도 참조하십시오 .

QString QQuick3DGeometry::subsetName(int subset) const

subset 의 이름을 반환합니다.

int QQuick3DGeometry::subsetOffset(int subset) const

subset 의 오프셋을 정점 버퍼 또는 인덱스 버퍼로 반환합니다.

subsetCount도 참조하십시오 .

[since 6.6] QQuick3DGeometry::TargetAttribute QQuick3DGeometry::targetAttribute(int index) const

모프 타깃 속성 정의 번호를 반환합니다 index

속성 정의에는 0부터 attributeCount() - 1

이 함수는 Qt 6.6에서 도입되었습니다.

[since 6.6] int QQuick3DGeometry::targetAttributeCount() const

이 지오메트리에 대해 정의된 모프 타깃 속성의 개수를 반환합니다.

이 함수는 Qt 6.6에서 도입되었습니다.

targetAttribute도 참조하십시오 .

[since 6.6] QByteArray QQuick3DGeometry::targetData() const

setTargetData 로 설정된 대상 버퍼 데이터를 반환합니다.

이 함수는 Qt 6.6에서 도입되었습니다.

setTargetData()도 참조하십시오 .

QByteArray QQuick3DGeometry::vertexData() const

setVertexData 로 설정된 버텍스 버퍼 데이터를 반환합니다.

setVertexData()도 참조하십시오 .