Custom3DItem QML Type

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

• 継承されたメンバを含む、全メンバ一覧
• Custom3DItem はQt Graphs QML Types for 3D に含まれます。

プロパティ

• 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 。

シグナルのドキュメント

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も参照してください 。