Custom3DItem QML Type

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

• 継承されたメンバーを含む、すべてのメンバーの一覧
• Custom3DItemは、Qt Graphs の3D用QMLタイプの一部です。

プロパティ

• meshFile : string
• position : vector3d
• positionAbsolute : bool
• rotation : quaternion
• rotationAbsolute : bool (since 6.11)
• scaling : vector3d
• scalingAbsolute : bool
• shadowCasting : bool
• textureFile : string
• visible : bool

信号

• meshFileChanged(string meshFile)
• positionAbsoluteChanged(bool positionAbsolute)
• positionChanged(vector3d position)
• rotationChanged(quaternion rotation)
• scalingAbsoluteChanged(bool scalingAbsolute)
• scalingChanged(vector3d scaling)
• shadowCastingChanged(bool shadowCasting)
• textureFileChanged(string textureFile)
• visibleChanged(bool visible)

方法

• void setRotationAxisAndAngle(vector3d axis, real angle)

詳細な説明

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

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

meshFile : string

アイテムのメッシュファイル名。ファイル内のアイテムはメッシュ形式である必要があります。メッシュファイルには、頂点、法線、およびUV座標を含めることを推奨します。

position : vector3d

アイテムの位置は、vector3d として指定されます。デフォルトはvector3d(0.0, 0.0, 0.0) です。

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

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

positionAbsolute : bool

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

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

rotation : quaternion

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

rotationAbsolute : bool [since 6.11]

アイテムの回転をデータ値で扱うか、絶対値で扱うかを指定します。デフォルトはtrue です。絶対回転が設定されたアイテムは、軸に関係なくデフォルトの座標に基づいて回転します。データ回転が設定されたアイテムは、軸の座標に基づいて回転します。

このプロパティは Qt 6.11 で導入されました。

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

scaling : vector3d

vector3d 型のアイテムスケーリング。デフォルトはvector3d(0.1, 0.1, 0.1) です。

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

scalingAbsoluteも参照してください 。

scalingAbsolute : bool

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

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

shadowCasting : bool

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

textureFile : string

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

visible : bool

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

Signal ドキュメント

meshFileChanged(string meshFile)

このシグナルは、meshFile がmeshFile に変更されたときに発生します。

positionAbsoluteChanged(bool positionAbsolute)

このシグナルは、positionAbsolute がpositionAbsolute に変更されたときに発生します。

positionChanged(vector3d position)

このシグナルは、アイテム「position 」が「position 」に変更されたときに発火します。

rotationChanged(quaternion rotation)

このシグナルは、rotation がrotation に変更されたときに発生します。

scalingAbsoluteChanged(bool scalingAbsolute)

このシグナルは、scalingAbsolute がscalingAbsolute に変更されたときに発生します。

scalingChanged(vector3d scaling)

このシグナルは、scaling がscaling に変更されたときに発生します。

shadowCastingChanged(bool shadowCasting)

このシグナルは、shadowCasting がshadowCasting に変更されたときに発生します。

textureFileChanged(string textureFile)

このシグナルは、textureFile がtextureFile に変更されたときに発生します。

visibleChanged(bool visible)

このシグナルは、visible がvisible に変更されたときに発生します。

メソッドのドキュメント

void setRotationAxisAndAngle(vector3d axis, real angle)

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

rotationも参照してください 。