View3D QML Type

このプロパティは、シーンのレンダリングに使用するCamera を指定します。このプロパティが設定されていない場合、シーン内で最初に有効化されたカメラが使用されます。

PerspectiveCamera 、OrthographicCamera 、FrustumCamera 、およびCustomCameraも参照してください 。

このプロパティは、基礎となるカラー（および深度/ステンシル）バッファのサイズをピクセル単位で公開します。このプロパティは、GUI（メイン）スレッド、QMLバインディング、またはJavaScriptで使用するために用意されています。

これは読み取り専用のプロパティです。

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

explicitTextureWidth 、explicitTextureHeight 、DebugViewも参照してください 。

このプロパティは、シーンのレンダリングに使用されるSceneEnvironment を指定します。

SceneEnvironmentも参照してください 。

アイテムの関連テクスチャの高さをピクセル単位で指定します。アイテムのサイズに依存しない固定テクスチャ サイズが必要な場合に関連します。このサイズはアイテムのジオメトリ（シーン内のサイズと配置）には影響しないので、テクスチャの内容はアイテムの領域に拡大または縮小されて（場合によっては引き伸ばされて）表示されます。

デフォルトの値は0 です。値が 0 の場合、テクスチャのサイズはアイテムのサイズに従います。(texture size in pixels =item's logical size *device pixel ratio) です。

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

explicitTextureWidth,effectiveTextureSize,DebugViewも参照してください 。

アイテムの関連テクスチャの幅（ピクセル単位）。アイテムのサイズに依存しない固定テクスチャサイズが必要な場合に関連します。このサイズはアイテムのジオメトリ（シーン内のサイズと配置）には影響しないので、テクスチャの内容はアイテムの領域に拡大または縮小されて（場合によっては引き伸ばされて）表示されます。

デフォルトの値は0 です。値が 0 の場合、テクスチャのサイズはアイテムのサイズに従います。(texture size in pixels =item's logical size *device pixel ratio) です。

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

explicitTextureHeight,effectiveTextureSize,DebugViewも参照してください 。

このプロパティには、このView3D で使用するユーザー拡張機能のリストが含まれます。

RenderExtensionも参照して ください。

このプロパティは、ビューポートにレンダリングするシーンの参照ノードを定義します。この参照ノードは、View3D の子ノードである必要はありません。この参照ノードは、View3D の子ノードがある場合は、その子ノードと兄弟になります。

また、View3D の子としてNode-based アイテムの階層を直接定義することもでき、その場合、これはView3D の暗黙のシーンになります。

View3D の現在のシーンを返すには、scene プロパティを使用してください。

Nodeも参照してください 。

このプロパティは、バッキング・テクスチャのフォーマットを決定します。renderMode がView3D.Offscreen であるなど、View3D がテクスチャにレンダリングされる場合にのみ適用されます。

デフォルトはShaderEffectSource.RGBA8 です。

このフォーマットが実行時に基礎となるグラフィックドライバによってサポートされていない場合、RGBA8が使用されます。

• ShaderEffectSource.RGBA8
• ShaderEffectSource.RGBA16F
• ShaderEffectSource.RGBA32F

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

QtQuick::ShaderEffectSource::format とQtQuick::Item::layer.formatも参照してください 。

このプロパティは、View3D が、Qt Quick シーンの他の部分とどのように結合されるかを決定します。

デフォルトでは、シーンは中間ステップとしてオフスクリーンバッファにレンダリングされます。このオフスクリーンバッファは、他のQt Quick Item のようにウィンドウ（またはレンダーターゲット）にレンダリングされます。

ほとんどのユーザーにとって、レンダリングモードを変更する必要はなく、このプロパティは無視しても問題ありません。しかし、一部のグラフィックハードウェアでは、オフスクリーンバッファの使用がパフォーマンスのボトルネックになることがあります。そのような場合は、他のモードを試す価値があるかもしれません。

デフォルトはView3D.Offscreen です。

このプロパティは、fps 、frameTime 、renderTime 、syncTime 、maxFrameTime など、フレームのレンダリングに関する統計情報を提供します。

View3D のシーンのルートNode を返します。

View3D で視覚化される 3D シーンを定義する：

• View3D の子としてNode-based アイテムの階層を直接定義し、これがView3D の暗黙のシーンになります。
• importScene プロパティを使用して既存のシーンを参照し、ビジュアライズしたいシーンのルートNode に設定します。このNode は、View3D の祖先である必要はなく、同じシーンをインポートする複数の View3D を持つことができます。

importSceneも参照してください 。

scenePos をシーン空間（3D）からビュー空間（2D）に変換します。

返される x- 値と y- 値はビュー座標で、左上隅は [0, 0] で、右下隅は [width, height] です。返される z 値には、シーン座標における、フラストラムのクリップ近傍平面（clipNear）からscenePos までの距離が含まれます。距離が負の場合は、scenePos がアクティブカメラの後ろにあることを意味します。scenePos がシーン内の位置にマッピングできない場合は、[0, 0, 0] の位置が返されます。

この関数は、camera がビューに割り当てられていることを必要とします。

mapTo3DScene() およびCamera.mapToViewport()も参照してください 。

viewPos をビュー空間（2D）からシーン空間（3D）に変換します。

viewPos の x 値と y 値はビュー座標で、左上隅を [0, 0]、右下隅を [width, height] とします。z値は、シーン座標におけるフラストラムのクリップ近傍平面（clipNear）からの距離として解釈されます。

viewPos がシーン内の位置にうまくマッピングできない場合は、[0, 0, 0] の位置が返されます。

この関数は、camera がビューに割り当てられていることを必要とします。

mapFrom3DScene() およびCamera.mapFromViewport()も参照してください 。

このメソッドは、ビュー座標x とy からシーン内にレイを「射出」し、シーン内のオブジェクトとの最も近い交点に関する情報を返します。

これは例えば、マウスカーソルの下にあるオブジェクトを見つけるために、マウス座標で呼び出すことができます。

このメソッドは、ビュー座標x とy からシーンにレイを "放ち"、レイと指定されたmodel との交点に関する情報を返します。

これは例えば、マウスカーソルの下にあるオブジェクトを見つけるために、マウス座標で呼び出すことができます。

このメソッドは Qt 6.8 で導入されました。

このメソッドは、ビュー座標x とy からシーンにレイを "射出 "し、シーン内のオブジェクトとの交差に関する情報のリストを返します。返されるリストはカメラからの距離でソートされ、最も近い交差点が最初に、最も遠い交差点が最後に表示されます。

これは例えば、マウスカーソルの下にあるオブジェクトを見つけるために、マウス座標で呼び出すことができます。

このメソッドは Qt 6.2 で導入されました。

このメソッドは、ビュー座標x とy からシーンにレイを「射出」し、渡されたリストmodels との交点に関する情報を返します。 これは渡されたモデルのリストに対してのみチェックされます。返されるリストはカメラからの距離でソートされ、最も近い交差点が最初に、最も遠い交差点が最後に表示されます。

これは例えば、マウスカーソルの下にあるオブジェクトを見つけるために、マウス座標で呼び出すことができます。

property list<Model> と JavaScript の動的なモデル配列の両方で動作します。

このメソッドは Qt 6.8 で導入されました。

このメソッドは、origin 、direction からシーンにレイを "射出 "し、シーン内のオブジェクトとの最も近い交点に関する情報を返す。

これは例えば、シーン内の任意のオブジェクトの位置と前方ベクトルで呼び出すことができ、アイテムの前にあるオブジェクトを確認することができます。これにより、シーン内のどのポイントからでもピッキングが可能になります。

このメソッドはQt 6.2で導入されました。

このメソッドは、origin 、direction を始点としてシーンにレイを "射出 "し、シーン内のオブジェクトとの最も近い交点に関する情報のリストを返す。リストは方向ベクトルに沿って原点からの距離でソートされ、最も近い交差点が最初に、最も遠い交差点が最後に表示されます。

これは、例えば、シーン内の任意のオブジェクトの位置と前方ベクトルで呼び出すことができ、アイテムの前にあるオブジェクトを確認することができます。これにより、シーン内のどのポイントからでもピッキングが可能になります。

このメソッドはQt 6.2で導入されました。

合成タッチイベントをtarget に送信し、IDpointId のタッチポイントをposition に移動させ、pressed が押されたかどうかを判断する。また、pointId が以前に別のアイテムでアクティブになっていた場合は、適切なタッチ リリース イベントも送信します。

このメソッドは Qt 6.8 で導入されました。