XrItem QML Type
2Dユーザーインターフェースのコンテンツを保持できる3D空間の仮想サーフェス。詳細...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: |
プロパティ
- automaticHeight : bool
- automaticWidth : bool
- color : color
- contentItem : Item
- height : real
- manualPixelsPerUnit : bool
- pixelsPerUnit : real
- width : real
詳細説明
XrItemタイプは、width とheight で長方形を表すQt Quick 3D Node です。contentItem で指定されたQt Quick Item を1つ保持し、それに合うように拡大縮小します。これにより、従来の2Dユーザー・インタフェースを、実世界の大きさを持つ仮想サーフェス上に表示する便利な方法が提供されます。
XrItemの他の子はNodeの子として扱われ、スケーリングされません。
例えば、次のコードは1メートル×1メートルの仮想サーフェスを作成し、600ピクセル×600ピクセルのコンテンツ・アイテムを表示します。ここでの効果は、コンテンツ アイテムを拡大縮小することによって達成されるものであり、コンテンツ アイテムをより高い解像度でレンダリングするものではないことに注意してください。
プロパティのドキュメント
automaticHeight : bool [default: "false"]
true に設定すると、XrItem は height プロパティで設定された高さを無視し、contentItem の高さから計算された高さを使用します。
automaticWidthも参照してください 。
automaticWidth : bool [default: "false"]
true に設定すると、XrItem は width プロパティで設定された幅を無視し、contentItem の幅から計算された幅を使用します。
automaticHeightも参照してください 。
color : color [default: "white"]
このプロパティは、XrItem の背景色を定義します。
contentItem : Item
このプロパティは、仮想サーフェス上に表示されるコンテンツ項目を保持する。コンテンツアイテムのサイズは、このアイテムのサイズに基づいて単位あたりのピクセル値とスケールを計算するために使用されます。
pixelsPerUnitも参照してください 。
height : real
このプロパティは、3D座標系におけるXrItem の高さを定義する。
widthも参照 。
manualPixelsPerUnit : bool [default: false]
このプロパティがtrue の場合、contentItems の 2D 座標系とこのXrItem の 3D 座標系との比率は、pixelsPerUnit の値で定義される。このプロパティがfalse の場合、比率は、contentItems のサイズとXrItem のサイズに基づいて計算される。
pixelsPerUnitも参照のこと 。
pixelsPerUnit : real
このプロパティは、contentItems の 2D 座標系のピクセル数が、XrItem の 3D 座標系の 1 単位に収まるかを決定する。デフォルトでは、これはコンテンツアイテムのサイズとXrItem のサイズに基づいて計算されます。
デフ ォル ト の動作を無効にして、 単位あ た り ピ ク セル数を手動で設定す る には、manualPixelsPerUnit を設定 し ます。
manualPixelsPerUnitも参照してください 。
width : real
このプロパティは、3D座標系におけるXrItem の幅を定義する。
heightも参照 。
© 2026 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.