XrItem QML Type
Une surface virtuelle dans l'espace 3D qui peut contenir le contenu de l'interface utilisateur 2D. Plus d'informations...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technical Preview |
Propriétés
- automaticHeight : bool
- automaticWidth : bool
- color : color
- contentItem : Item
- height : real
- manualPixelsPerUnit : bool
- pixelsPerUnit : real
- width : real
Description détaillée
Le type XrItem est un Qt Quick 3D Node qui représente un rectangle avec width et height. Il contient un Qt Quick Item , spécifié par contentItem, et le met à l'échelle. Il s'agit d'un moyen pratique de prendre des interfaces utilisateur traditionnelles en 2D et de les afficher sur une surface virtuelle ayant une taille réelle.
Tous les autres enfants du XrItem seront traités comme des enfants normaux d'un nœud et ne seront pas mis à l'échelle.
Par exemple, le code suivant créera une surface virtuelle de 1 mètre sur 1 mètre avec un élément de contenu de 600 pixels sur 600 pixels. Notez que l'effet ici est obtenu par la mise à l'échelle de l'élément de contenu et non par le rendu de l'élément de contenu à une résolution plus élevée.
XrItem { width: 100 height: 100 contentItem: Rectangle { width: 600 height: 600 color: "red" } }
Documentation des propriétés
automaticHeight : bool |
Lorsque cette propriété vaut true (vrai), XrItem ignore la hauteur définie dans la propriété height et utilise la hauteur calculée à partir de la hauteur de contentItem.
Voir également automaticWidth.
automaticWidth : bool |
Lorsque la propriété est définie sur true (vrai), XrItem ignore la largeur définie dans la propriété width (largeur) et utilise la largeur calculée à partir de contentItem width (largeur).
Voir aussi automaticHeight.
color : color |
Cette propriété définit la couleur d'arrière-plan de la page XrItem.
contentItem : Item |
Cette propriété contient l'élément de contenu qui sera affiché sur la surface virtuelle. La taille de l'élément de contenu sera utilisée pour calculer la valeur en pixels par unité et l'échelle sera basée sur la taille de cet élément.
Voir aussi pixelsPerUnit.
height : real |
manualPixelsPerUnit : bool |
Si cette propriété est true, le rapport entre le système de coordonnées 2D des contentItems et le système de coordonnées 3D de ce XrItem est défini par la valeur de pixelsPerUnit. Si cette propriété est false, le rapport est calculé en fonction de la taille de l'élément de contenu et de la taille du XrItem.
Voir également pixelsPerUnit.
pixelsPerUnit : real |
Cette propriété détermine le nombre de pixels du système de coordonnées 2D de l'élément de contenu qui s'adapteront à une unité du système de coordonnées 3D de XrItem. Par défaut, ce nombre est calculé en fonction de la taille de l'élément de contenu et de la taille du site XrItem.
Définissez manualPixelsPerUnit pour désactiver le comportement par défaut et définir manuellement la valeur des pixels par unité.
Voir également manualPixelsPerUnit.
width : real |
© 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.