XrItem QML Type

3D 공간 내에 위치하며 2D 사용자 인터페이스 콘텐츠를 표시할 수 있는 가상 표면입니다. 더 보기...

이 유형은 기술 미리보기 단계에 있으며 변경될 수 있습니다.

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

속성

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

상세 설명

XrItem 유형은 Qt Quick 3D Node 의 객체로, width 및 height 를 가진 사각형을 나타냅니다. 이 객체는 contentItem 로 지정된 하나의 Qt Quick Item 를 포함하며, 이를 화면 크기에 맞게 조정합니다. 이를 통해 기존의 2D 사용자 인터페이스를 실제 크기를 가진 가상 표면에 편리하게 표시할 수 있습니다.

XrItem의 다른 자식 요소들은 Node의 일반 자식 요소로 처리되며, 크기가 조정되지 않습니다.

예를 들어, 다음 코드는 1미터 × 1미터 크기의 가상 표면을 생성하고, 600픽셀 × 600픽셀 크기의 콘텐츠 항목을 배치합니다. 여기서 효과는 콘텐츠 항목을 더 높은 해상도로 렌더링하는 것이 아니라, 콘텐츠 항목의 크기를 조정함으로써 달성된다는 점에 유의하십시오.

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

속성 설명서

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`인 경우, 비율은 `content item`의 크기와 ` XrItem`의 크기를 기준으로 계산됩니다.

pixelsPerUnit도 참조하십시오 .

pixelsPerUnit : real

이 속성은 contentItems의 2D 좌표계에서 몇 픽셀이 XrItem 의 3D 좌표계에서 1단위에 해당하는지를 결정합니다. 기본적으로 이 값은 콘텐츠 항목의 크기와 XrItem 의 크기를 기준으로 계산됩니다.

manualPixelsPerUnit 을 설정하여 기본 동작을 비활성화하고 단위당 픽셀 수를 수동으로 설정할 수 있습니다.

manualPixelsPerUnit항목도 참조하십시오 .

width : real

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

height도 참조하십시오 .