XrItem QML Type

2D 사용자 인터페이스 콘텐츠를 담을 수 있는 3D 공간의 가상 표면입니다. 더 보기...

Import Statement:	`import QtQuick3D.Xr`
Since:	Qt 6.8
Inherits:	Node
Status:	Technical Preview

상속된 멤버를 포함한 모든 멤버 목록

속성

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 을 하나 담고 그에 맞게 크기를 조정합니다. 이를 통해 기존의 2D 사용자 인터페이스를 실제 크기의 가상 표면에 표시할 수 있는 편리한 방법을 제공합니다.

XrItem의 다른 모든 자식은 노드의 일반 자식으로 취급되며 크기가 조정되지 않습니다.

예를 들어 다음 코드는 1미터×1미터의 가상 표면과 600픽셀×600픽셀의 콘텐츠 항목을 생성합니다. 여기서 효과는 콘텐츠 항목을 더 높은 해상도로 렌더링하는 것이 아니라 콘텐츠 항목의 스케일을 조정하여 얻을 수 있다는 점에 유의하세요.

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

속성 문서

automaticHeight : bool [default: "false"]

true로 설정하면 XrItem 높이 속성을 통해 설정된 높이를 무시하고 contentItem 높이에서 계산된 높이를 사용합니다.

automaticWidth 를참조하세요 .

automaticWidth : bool [default: "false"]

true로 설정하면 XrItem 너비 속성을 통해 설정된 너비를 무시하고 contentItem 너비에서 계산된 너비를 사용합니다.

automaticHeight 를참조하세요 .

color : color [default: "white"]

이 속성은 XrItem 의 배경색을 정의합니다.

contentItem : Item

이 속성은 가상 표면에 표시될 콘텐츠 항목을 보유합니다. 콘텐츠 항목의 크기는 단위당 픽셀 값을 계산하는 데 사용되며 이 항목의 크기에 따라 배율이 조정됩니다.

pixelsPerUnit 를참조하십시오 .

height : real

이 속성은 3D 좌표계에서 XrItem 의 높이를 정의합니다.

width도 참조하십시오 .

manualPixelsPerUnit : bool [default: false]

이 속성이 true 인 경우 콘텐츠 항목의 2D 좌표계와 이 XrItem 의 3D 좌표계 사이의 비율은 pixelsPerUnit 값으로 정의됩니다. 이 속성이 false 인 경우 콘텐츠 항목의 크기와 XrItem 의 크기를 기준으로 비율을 계산합니다.

pixelsPerUnit도 참조하십시오 .

pixelsPerUnit : real

이 속성은 콘텐츠 항목의 2D 좌표계에서 XrItem 의 3D 좌표계 단위 하나에 들어갈 픽셀 수를 결정합니다. 기본적으로 이 값은 콘텐츠 항목의 크기와 XrItem 의 크기에 따라 계산됩니다.

기본 동작을 비활성화하려면 manualPixelsPerUnit 을 설정하고 단위당 픽셀 값을 수동으로 설정합니다.

manualPixelsPerUnit 를참조하세요 .

width : real

이 속성은 3D 좌표계에서 XrItem 의 너비를 정의합니다.

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.