Custom3DItem QML Type

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

Import Statement: import QtGraphs
In C++: QCustom3DItem
Inherited By:

Custom3DLabel and Custom3DVolume

プロパティ

信号

方法

詳細説明

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

プロパティ ドキュメント

meshFile : string

アイテムのメッシュファイル名。ファイル内のアイテムはメッシュ形式でなければなりません。メッシュ ファイルには、頂点、法線、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

アイテムのスケーリングをデータ値で処理するか、絶対値で処理するかを定義します。デ フ ォ ル ト はtrue です。 絶対値スケー リ ン グの項目は、 軸の範囲にかかわ ら ず、 同 じ サ イ ズでレ ン ダ さ れます。デー タ ス ケー リ ン グ を持つ項目は、 軸の範囲に従っ て見かけ上のサ イ ズが変わ り ます。positionAbsolutetrue の場合、 こ のプ ロ パテ ィ は無視 さ れ、 拡縮は絶対値 と し て解釈 さ れます。アイテムに回転がある場合、データ スケーリングは回転していないアイテムで計算されます。同様に、Custom3DVolume 項目の場合、範囲のクリッピングは回転していない項目で計算されます。

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

: カスタム アイテムのメッシュは、[-1 ,1] の範囲に正規化する必要があります。

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


shadowCasting : bool

シャドーキャスティング アイテムのシャドーキャスティングを有効にするかどうかを定義します。デフォルトはtrue です。false の場合、アイテムはShadowQuality に関係なく影を落としません。


textureFile : string

アイテムのテクスチャファイル名。未設定の場合、グレーのソリッドテクスチャが使用されます。

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


visible : bool

アイテムの可視性。デフォルトはtrue です。


シグナル ドキュメント

meshFileChanged(string meshFile)

このシグナルは、meshFilemeshFile に変更されたときに発行されます。

注: 対応するハンドラはonMeshFileChanged です。


positionAbsoluteChanged(bool positionAbsolute)

このシグナルはpositionAbsolutepositionAbsolute に変更されたときに発行されます。

: 対応するハンドラはonPositionAbsoluteChanged です。


positionChanged(vector3d position)

このシグナルは、アイテムpositionposition に変更されたときに発行されます。

: 対応するハンドラはonPositionChanged です。


rotationChanged(quaternion rotation)

このシグナルはrotationrotation に変更されたときに発せられます。

: 対応するハンドラはonRotationChanged です。


scalingAbsoluteChanged(bool scalingAbsolute)

このシグナルはscalingAbsolutescalingAbsolute に変更されたときに発せられます。

注: 対応するハンドラはonScalingAbsoluteChanged です。


scalingChanged(vector3d scaling)

このシグナルはscalingscaling に変更されたときに発せられる。

注: 対応するハンドラはonScalingChanged です。


shadowCastingChanged(bool shadowCasting)

このシグナルはshadowCastingshadowCasting に変更されたときに発せられる。

注: 対応するハンドラはonShadowCastingChanged です。


textureFileChanged(string textureFile)

このシグナルはtextureFiletextureFile に変更されたときに発せられる。

注: 対応するハンドラはonTextureFileChanged です。


visibleChanged(bool visible)

このシグナルはvisiblevisible に変更されたときに発せられる。

注意 : 対応するハンドラはonVisibleChanged です。


メソッドの説明

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.