XrItem QML Type
Eine virtuelle Oberfläche im 3D-Raum, die Inhalte der 2D-Benutzeroberfläche enthalten kann. Mehr...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: |
Eigenschaften
- automaticHeight : bool
- automaticWidth : bool
- color : color
- contentItem : Item
- height : real
- manualPixelsPerUnit : bool
- pixelsPerUnit : real
- width : real
Detaillierte Beschreibung
Der XrItem-Typ ist ein Qt Quick 3D Node, der ein Rechteck mit width und height darstellt. Er enthält ein Qt Quick Item , das durch contentItem spezifiziert wird, und skaliert es, damit es passt. Auf diese Weise lassen sich herkömmliche 2D-Benutzeroberflächen bequem auf einer virtuellen Oberfläche darstellen, die eine reale Größe hat.
Alle anderen Kinder des XrItem werden wie normale Kinder eines Knotens behandelt und nicht skaliert.
Der folgende Code erzeugt zum Beispiel eine virtuelle Oberfläche mit den Maßen 1 Meter mal 1 Meter und einem Inhaltselement mit den Maßen 600 Pixel mal 600 Pixel. Beachten Sie, dass der Effekt hier durch die Skalierung des Inhaltselements erreicht wird und nicht durch das Rendern des Inhaltselements mit einer höheren Auflösung.
Dokumentation der Eigenschaft
automaticHeight : bool [default: "false"]
Wenn diese Option auf true gesetzt ist, ignoriert XrItem die über die Eigenschaft height eingestellte Höhe und verwendet die aus contentItem height berechnete Höhe.
Siehe auch automaticWidth.
automaticWidth : bool [default: "false"]
Wenn diese Option auf true gesetzt ist, ignoriert XrItem die über die Eigenschaft width eingestellte Breite und verwendet die aus contentItem width berechnete Breite.
Siehe auch automaticHeight.
color : color [default: "white"]
Diese Eigenschaft definiert die Hintergrundfarbe des XrItem.
contentItem : Item
Diese Eigenschaft enthält das Inhaltselement, das auf der virtuellen Oberfläche angezeigt werden soll. Die Größe des Inhaltselements wird verwendet, um den Wert für die Pixel pro Einheit und die Skalierung auf der Grundlage der Größe dieses Elements zu berechnen.
Siehe auch pixelsPerUnit.
height : real
Diese Eigenschaft definiert die Höhe des XrItem im 3D-Koordinatensystem.
Siehe auch width.
manualPixelsPerUnit : bool [default: false]
Wenn diese Eigenschaft true ist, wird das Verhältnis zwischen dem 2D-Koordinatensystem des contentItems und dem 3D-Koordinatensystem dieses XrItem durch den Wert von pixelsPerUnit definiert. Wenn diese Eigenschaft false ist, wird das Verhältnis auf der Grundlage der Größe des contentItems und der Größe von XrItem berechnet.
Siehe auch pixelsPerUnit.
pixelsPerUnit : real
Diese Eigenschaft bestimmt, wie viele Pixel im 2D-Koordinatensystem des contentItems in eine Einheit des 3D-Koordinatensystems von XrItem passen. Standardmäßig wird dies auf der Grundlage der Größe des Inhaltselements und der Größe von XrItem berechnet.
Setzen Sie manualPixelsPerUnit, um das Standardverhalten zu deaktivieren und den Wert für Pixel pro Einheit manuell festzulegen.
Siehe auch manualPixelsPerUnit.
width : real
Diese Eigenschaft definiert die Breite des XrItem im 3D-Koordinatensystem.
Siehe auch 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.