Custom3DItem QML Type

그래프에 사용자 지정 항목을 추가합니다. 더 보기...

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.1
In C++: QCustom3DItem
Inherited By:

Custom3DLabel and Custom3DVolume

속성

방법

상세 설명

커스텀 아이템에는 커스텀 메시, 위치, 스케일, 회전, 텍스처 옵션이 있습니다.

속성 문서

meshFile : string

아이템 메시 파일 이름입니다. 파일의 항목은 웨이브프론트 오브젝트 형식이어야 하며 버텍스, 노멀, UV를 포함해야 합니다. 또한 트라이앵글이어야 합니다. 파일에 노멀이나 UV가 누락되면 콘솔 출력에 오류 메시지와 함께 로딩에 실패하고 항목이 렌더링되지 않습니다.


position : vector3d

아이템 위치는 vector3d 유형입니다. 기본값은 vector3d(0.0, 0.0, 0.0) 입니다.

항목 위치는 positionAbsolute 속성 값에 따라 데이터 좌표 또는 절대 좌표로 지정됩니다. 절대 좌표를 사용하는 경우 -1.0...1.0 사이의 값은 축 범위 내에 있습니다.

참고: positionAbsolutefalse 인 경우 항목이 부분적으로 표시되는 Custom3DVolume 이고 scalingAbsolutefalse 인 경우를 제외하고 축 범위 밖에 위치한 항목은 렌더링되지 않습니다. 이 경우 볼륨의 보이는 부분이 렌더링됩니다.

positionAbsolutescalingAbsolute참조하세요 .


positionAbsolute : bool

항목 위치를 데이터 좌표로 처리할지 절대 좌표로 처리할지 정의합니다. 기본값은 false 입니다. 절대 좌표를 가진 항목은 항상 렌더링되지만 데이터 좌표를 가진 항목은 축 범위 내에 있는 경우에만 렌더링됩니다.

position참조하세요 .


rotation : quaternion

quaternion 로의 항목 회전 기본값은 quaternion(0.0, 0.0, 0.0, 0.0) 입니다.


scaling : vector3d

vector3d 유형으로 항목 크기 조정. 기본값은 vector3d(0.1, 0.1, 0.1) 입니다.

항목 배율은 scalingAbsolute 속성의 값에 따라 데이터 값 또는 절대값으로 지정됩니다. 절대값으로 해석되는 기본 벡터는 항목 메쉬가 정규화되어 있고 그래프 가로 세로 비율이 기본값에서 변경되지 않은 경우 항목을 그래프 높이의 10%로 설정합니다.

scalingAbsolute참조하세요 .


scalingAbsolute : bool [since QtDataVisualization 1.2]

항목 배율을 데이터 값으로 처리할지 절대 값으로 처리할지 정의합니다. 기본값은 true 입니다. 절대 배율을 사용하는 항목은 축 범위에 관계없이 동일한 크기로 렌더링됩니다. 데이터 스케일링이 있는 항목은 축 범위에 따라 겉보기 크기가 변경됩니다. positionAbsolutetrue 인 경우 이 속성은 무시되고 배율은 절대값으로 해석됩니다. 항목에 회전이 있는 경우 데이터 배율은 회전되지 않은 항목에 대해 계산됩니다. 마찬가지로 Custom3DVolume 항목의 경우 회전되지 않은 항목에 대해 범위 클리핑이 계산됩니다.

참고: Custom3DLabel 항목 또는 polar 그래프에 사용되는 사용자 지정 항목에는 절대 배율만 지원됩니다.

참고: 사용자 지정 항목의 메쉬는 [-1 ,1] 범위로 정규화해야 하며, 그렇지 않으면 데이터 배율이 정확하지 않습니다.

이 속성은 QtDataVisualization 1.2에 도입되었습니다.

scalingpositionAbsolute참조하십시오 .


shadowCasting : bool

항목의 그림자 드리우기 활성화 여부를 정의합니다. 기본값은 true 입니다. false 인 경우 ShadowQuality 에 관계없이 항목은 그림자를 드리우지 않습니다.


textureFile : string

항목의 텍스처 파일 이름입니다. 설정하지 않으면 단색 회색 텍스처가 사용됩니다.

참고: 메모리를 절약하기 위해 텍스처가 생성된 후 파일에서 로드된 QImage 은 지워집니다.


visible : bool

항목의 가시성입니다. 기본값은 true 입니다.


메서드 문서

void setRotationAxisAndAngle(vector3d axis, real angle)

axisangle 에서 회전 쿼터니언을 구성하는 편리한 함수입니다.

rotation도 참고하세요 .


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