ObjectPicker QML Type

ObjectPicker クラスは、「ピッキング」と呼ばれる処理を通じてエンティティとやり取りを行うために使用できるコンポーネントをインスタンス化します。詳細...

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

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• containsMouse : bool
• dragEnabled : bool
• hoverEnabled : bool
• pressed : bool
• priority : int

信号

• clicked(PickEvent pick)
• entered()
• exited()
• moved(PickEvent pick)
• pressed(PickEvent pick)
• released(PickEvent pick)

詳細な説明

ビューポートとカメラのすべての組み合わせについて、ピッキング処理ではシーン内を貫通する光線を投射し、その光線とバウンディングボリュームが交差するエンティティを検索します。バウンディングボリュームは、ジオメトリの `boundingVolumePositionAttribute` で指定された属性バッファ内の値を用いて計算されます。

pickAttributeプロパティで定義されたバウンディングボリュームがレイと交差した際、pressed()、released()、clicked()、moved()、entered()、およびexited()の各シグナルがエミットされます。

ほとんどのシグナルは、PickEvent インスタンスを伝達します。PickingSettings の.pickModeがPickingSettings の.TrianglePickingに設定されている場合、pickパラメータの実際の型はPickTriangleEvent となります。

ピッククエリは、マウスのクリック時およびクリック解除時に実行されます。ドラッグが有効になっている場合、いずれかのボタンが押されている間は、マウスの移動ごとにクエリも行われます。ホバーが有効になっている場合、ボタンが押されていなくても、マウスの移動ごとにクエリが行われます。

関連項目： PickingSettings 、Geometry 、Attribute 、PickEvent 、PickTriangleEvent 、およびNoPicking 。

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

containsMouse : bool [read-only]

オブジェクトピッカーに現在マウスが含まれているかどうかを指定します

dragEnabled : bool

hoverEnabled : bool

ホバー機能が有効かどうかを指定します

pressed : bool [read-only]

オブジェクトピッカーが現在押されているかどうかを指定します

priority : int

PickingSettings.pickResultMode が PickingSettings.PriorityPick に設定されている場合、ピッキング結果を優先順位でフィルタリングする際に使用する優先順位。

Signal ドキュメント

clicked(PickEvent pick)

このシグナルは、pickAttribute プロパティで定義されたバウンディングボリュームが、マウスクリック時にレイと交差した際に発火します。交差情報は、pick パラメータを通じて取得できます。

entered()

このシグナルは、pickAttribute プロパティで定義されたバウンディングボリュームが、そのボリューム内に入ってくるマウスのレイと交差した際に発せられます。

exited()

このシグナルは、pickAttribute プロパティで定義されたバウンディングボリュームが、そのボリュームから出るレイと交差したときに発せられます。

moved(PickEvent pick)

このシグナルは、ボタンが押された状態でマウスが移動した際、pickAttribute プロパティで定義されたバウンディングボリュームがレイと交差したときに発火します。交差情報は、pick パラメータを通じて取得できます。

pressed(PickEvent pick)

このシグナルは、pickAttribute プロパティで定義されたバウンディングボリュームが、マウスクリック時にレイと交差した際に発火します。交差情報は、pick パラメータを通じて取得できます。

released(PickEvent pick)

このシグナルは、pickAttribute プロパティで定義されたバウンディングボリュームが、マウスボタンが離された際にレイと交差したときに発せられます。交差情報は、pick パラメータを通じて取得できます。