Custom3DItem QML Type

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

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

Custom3DLabel and Custom3DVolume

プロパティ

方法

詳細説明

カスタムアイテムは、カスタムメッシュ、位置、拡大縮小、回転、およびオプションのテクスチャを持ちます。

プロパティ ドキュメント

meshFile : string

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


position : vector3d

アイテムの位置をvector3d タイプで指定します。デフォルトはvector3d(0.0, 0.0, 0.0) です。

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

注: positionAbsolutefalse の場合、軸の範囲外に配置されたアイテムはレンダリングされません。ただし、アイテムが部分的に表示されるCustom3DVolume であり、scalingAbsolutefalse でもある場合を除きます。その場合、ボリュームの可視部分がレンダリングされる。

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 です。 絶対値スケー リ ン グの項目は、 軸の範囲にかかわ ら ず、 同 じ サ イ ズでレ ン ダ さ れます。デー タ ス ケー リ ン グ を持つ項目は、 軸の範囲に従っ て見かけ上のサ イ ズが変わ り ます。positionAbsolutetrue の場合、 こ のプ ロ パテ ィ は無視 さ れ、 ス ケー リ ングは絶対値 と し て解釈 さ れます。アイテムに回転がある場合、データ スケーリングは回転していないアイテムで計算されます。同様に、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)

axisangle から回転クォータニオンを構築する便利な関数です。

rotationも参照してください


© 2025 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.