このページでは

Custom3DItem QML Type

グラフにカスタム項目を追加します。詳細...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.1
In C++: QCustom3DItem
Inherited By:

Custom3DLabel and Custom3DVolume

Status: Deprecated

この型は非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

方法

詳細な説明

カスタムアイテムには、カスタムメッシュ、位置、スケール、回転、およびオプションのテクスチャが設定されています。

プロパティのドキュメント

meshFile : string

アイテムのメッシュファイル名。ファイル内のアイテムはWavefront OBJ形式である必要があり、頂点、法線、UV座標が含まれている必要があります。また、三角形構成である必要があります。ファイルに法線またはUV座標のいずれかが欠けている場合、読み込みは失敗し、コンソール出力にエラーメッセージが表示され、そのアイテムはレンダリングされません。

position : vector3d

vector3d 型のアイテム位置。デフォルトはvector3d(0.0, 0.0, 0.0) です。

項目の位置は、positionAbsolute プロパティの値に応じて、データ座標または絶対座標のいずれかで指定されます。絶対座標を使用する場合、-1.0...1.0 の範囲内の値が軸の範囲内となります。

注: positionAbsolute がfalse に設定されている場合、軸の範囲外に配置されたアイテムは レンダリングされません。ただし、そのアイテムが部分的に表示されるCustom3DVolumeであり、かつscalingAbsolute もfalse に設定されている場合は例外です。その場合、ボリュームの可視部分がレンダリングされます。

「 positionAbsolute 」および「scalingAbsolute 」も参照してください 。

positionAbsolute : bool

アイテムの位置をデータ座標で扱うか、絶対座標で扱うかを指定します。デフォルトはfalse です。絶対座標を持つアイテムは常に描画されますが、データ座標を持つアイテムは、軸の範囲内にある場合にのみ描画されます。

「position」も参照してください 。

rotation : quaternion

quaternion としてのアイテムのローテーション。デフォルトはquaternion(0.0, 0.0, 0.0, 0.0) です。

scaling : vector3d

vector3d 型としての項目のスケーリング。デフォルトはvector3d(0.1, 0.1, 0.1) です。

項目のスケーリングは、scalingAbsolute プロパティの値に応じて、データ値または絶対値のいずれかで指定されます。絶対値として解釈されるデフォルトのベクトルは、項目のメッシュが正規化されており、グラフのアスペクト比がデフォルトから変更されていない場合、その項目をグラフの高さの10%に設定します。

「scalingAbsolute」も参照してください 。

scalingAbsolute : bool [since QtDataVisualization 1.2]

項目のスケーリングをデータ値で扱うか、絶対値で扱うかを指定します。デフォルトは「true 」です。絶対スケーリングが適用された項目は、軸の範囲に関係なく、常に同じサイズで表示されます。 データスケーリングが適用されたアイテムは、軸の範囲に応じて表示サイズが変化します。positionAbsolute がtrue に設定されている場合、このプロパティは無視され、スケーリングは絶対値として解釈されます。アイテムに回転が適用されている場合、データスケーリングは回転前のアイテムに基づいて計算されます。同様に、Custom3DVolumeアイテムの場合も、範囲のクリッピングは回転前のアイテムに基づいて計算されます。

注: Custom3DLabel アイテム、またはpolar グラフで使用されるカスタムアイテムでは、絶対スケーリングのみが サポートされています。

注:カスタム項目のメッシュは 、[-1 ,1] の範囲に正規化されている必要があります。そうしないと、データのスケーリングが正確に行われません。

このプロパティは、QtDataVisualization 1.2 で導入されました。

「 scaling 」および「positionAbsolute 」も参照してください 。

shadowCasting : bool

そのアイテムの影の投影を有効にするかどうかを指定します。デフォルトはtrue です。false の場合、ShadowQuality の設定にかかわらず、そのアイテムは影を投影しません。

textureFile : string

アイテムのテクスチャファイル名。設定しない場合は、一色のグレーのテクスチャが使用されます。

注: メモリを節約するため 、ファイルから読み込まれたQImage は、テクスチャの作成後にクリアされます。

visible : bool

項目の表示設定。デフォルトはtrue です。

メソッドのドキュメント

void setRotationAxisAndAngle(vector3d axis, real angle)

axis およびangle から回転クォータニオンを生成するための便利な関数です。

rotationも参照してください 。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.