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 。この場合、アトリビュートは頂点バッファのエントリを表すのではなく、インデックスバッファのインデックスデータを記述します。頂点ごとにインデックスは常に1つだけなので、offset はインデックスバッファとしては意味をなさないので、ゼロのままにしておくべきです。

コンポーネントタイプは以下のいずれかになります：

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)

morph ターゲットのアトリビュート記述を追加します。各アトリビュートは、そのアトリビュートが属するtargetId 、アトリビュートの用途とそのアトリビュートが持つコンポーネントの数を指定するsemantic 、頂点から頂点内のアトリビュート位置までのoffset 、要素間のバイトサイズであるstride を持ちます。

この関数は Qt 6.6 で導入されました。

addAttributeも参照してください 。

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

これはオーバーロードされた関数です。

morph ターゲット属性の説明を追加します。各属性は、属性が属する 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 に設定します。これは、バッファ内の連続する2つの頂点間の距離です。

たとえば、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

morph 対象の属性定義番号を返します。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()も参照して ください。