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 는 IndexSemantic 일 수 있습니다. 이 경우 어트리뷰트는 버텍스 버퍼의 항목을 나타내는 것이 아니라 인덱스 버퍼의 인덱스 데이터를 설명합니다. 버텍스당 항상 하나의 인덱스만 존재하므로 offset 은 인덱스 버퍼에 의미가 없으므로 0으로 남겨 두어야 합니다.

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

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

오버로드된 함수입니다.

버텍스 어트리뷰트 설명을 추가합니다. 각 어트리뷰트에는 어트리뷰트의 사용법과 어트리뷰트가 가진 컴포넌트의 수를 지정하는 시맨틱, 버텍스의 시작에서 버텍스 내부의 어트리뷰트 위치까지의 오프셋, 어트리뷰트의 데이터 유형과 크기를 지정하는 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, 어트리뷰트의 사용법과 어트리뷰트가 가진 컴포넌트의 수를 지정하는 semantic, 버텍스의 시작부터 버텍스 내부의 어트리뷰트 위치까지의 오프셋, 요소 사이의 바이트 크기인 stride가 있습니다.

이 함수는 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개, 버텍스 버퍼에 들어가지 않는 인덱스용은 없음)가 될 것입니다.

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()도 참조하세요 .