Custom3DItem QML Type
그래프에 사용자 정의 항목을 추가합니다. 더 보기...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.1 |
| In C++: | QCustom3DItem |
| Inherited By: | |
| Status: | Deprecated |
이 유형은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.
속성
- meshFile : string
- position : vector3d
- positionAbsolute : bool
- rotation : quaternion
- scaling : vector3d
- scalingAbsolute : bool
(since QtDataVisualization 1.2) - shadowCasting : bool
- textureFile : string
- visible : bool
방법
- void setRotationAxisAndAngle(vector3d axis, real angle)
상세 설명
커스텀 아이템에는 커스텀 메시, 위치, 크기, 회전 및 선택적 텍스처가 포함됩니다.
속성 설명서
meshFile : string
아이템 메쉬 파일 이름입니다. 파일 내의 아이템은 Wavefront OBJ 형식이어야 하며, 정점, 법선, UV 정보를 포함해야 합니다. 또한 삼각형으로 구성되어야 합니다. 파일에 법선이나 UV 정보가 누락된 경우, 콘솔 출력에 오류 메시지가 표시되며 로딩에 실패하고 해당 아이템은 렌더링되지 않습니다.
position : vector3d
vector3d 유형의 항목 위치입니다. 기본값은 vector3d(0.0, 0.0, 0.0) 입니다.
항목 위치는 positionAbsolute 속성의 값에 따라 데이터 좌표 또는 절대 좌표로 지정됩니다. 절대 좌표를 사용할 경우, -1.0...1.0 사이의 값은 축 범위 내에 포함됩니다.
참고: positionAbsolute 가 false 인 경우, 축 범위 밖에 배치된항목은 렌더링되지 않습니다. 단, 해당 항목이 부분적으로 표시될 수 있는 Custom3DVolume이고 scalingAbsolute 도 false 인 경우는 예외입니다. 이 경우, 볼륨의 표시 가능한 부분이 렌더링됩니다.
positionAbsolute 및 scalingAbsolute항목도 참조하십시오 .
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 ’입니다. 절대 크기 조정이 적용된 항목은 축의 범위에 관계없이 동일한 크기로 표시됩니다. 데이터 스케일링이 적용된 항목은 축 범위에 따라 표시 크기가 변경됩니다. positionAbsolute 가 true 인 경우, 이 속성은 무시되고 스케일링은 절대값으로 해석됩니다. 항목에 회전(rotation)이 적용된 경우, 데이터 스케일링은 회전되지 않은 항목을 기준으로 계산됩니다. 마찬가지로, Custom3DVolume 항목의 경우 범위 클리핑도 회전되지 않은 항목을 기준으로 계산됩니다.
참고: Custom3DLabel 항목이나 polar 그래프에서 사용되는 사용자 정의 항목의 경우 절대 스케일링만 지원됩니다.
참고: 사용자 정의 항목의메시는 [-1 ,1] 범위로 정규화되어야 하며, 그렇지 않으면 데이터 스케일링이 정확하지 않습니다.
이 속성은 QtDataVisualization 1.2에서 도입되었습니다.
scaling 및 positionAbsolute도 참조하십시오 .
shadowCasting : bool
해당 항목에 대한 그림자 투영이 활성화되어 있는지 여부를 지정합니다. 기본값은 ` true`입니다. ` false`인 경우, ` ShadowQuality` 설정과 관계없이 해당 항목은 그림자를 드리우지 않습니다.
textureFile : string
아이템의 텍스처 파일 이름입니다. 설정하지 않으면 단색 회색 텍스처가 사용됩니다.
참고: 메모리를 절약하기위해 , 파일에서 불러온 ` QImage `는 텍스처가 생성된 후 지워집니다.
visible : bool
항목의 표시 여부입니다. 기본값은 ‘ true ’입니다.
메서드 문서
void setRotationAxisAndAngle(vector3d axis, real angle)
axis 와 angle 를 사용하여 회전 쿼터니언을 생성하는 편리한 함수입니다.
rotation도 참조하십시오 .
© 2026 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.