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:	Node
Status:	Technical Preview

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

automaticHeight : bool
automaticWidth : bool
color : color
contentItem : Item
height : real
manualPixelsPerUnit : bool
pixelsPerUnit : real
width : real

Detaillierte Beschreibung

Der Typ XrItem 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.

XrItem {
    width: 100
    height: 100
    contentItem: Rectangle {
        width: 600
        height: 600
        color: "red"
    }
}

Eigenschaft Dokumentation

automaticHeight : bool [default: "false"]

Wenn diese Eigenschaft 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 Eigenschaft 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 von 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 die Pixel pro Einheitswert und die Skalierung basierend auf der Größe dieses Elements zu berechnen.

Siehe auch pixelsPerUnit.

height : real

Diese Eigenschaft definiert die Höhe von XrItem im 3D-Koordinatensystem.

Siehe auch width.

manualPixelsPerUnit : bool [default: false]

Wenn diese Eigenschaft true lautet, wird das Verhältnis zwischen dem 2D-Koordinatensystem des contentItems und dem 3D-Koordinatensystem von XrItem durch den Wert von pixelsPerUnit definiert. Wenn diese Eigenschaft false lautet, 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.

© 2025 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.